--- title: "Verify the connection and run a historical search" slug: "verify-the-connection-and-run-a-historical-search" tags: ["EDR with Forensics (EDRF)", "Endpoint Security"] updated: 2026-08-26T19:31:16Z published: 2026-08-26T19:31:16Z canonical: "docs.trellix.com/verify-the-connection-and-run-a-historical-search" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # Verify the connection and run a historical search To automate the historical search, verify the server connection and then run your historical search queries. ### Test the connection Use `connection_test.py` to verify the link between the Endpoint Security (HX) and the EDR Telemetry Store server. This section describes the command-line arguments for the `scripts/connection_test.py` script. | Argument | Description | | --- | --- | | `--hxUrl` | The URL of the Endpoint Security (HX) server instance. | | `--apiToken` | A valid user API token. This method takes precedence over the username and password. | | `--username` | The Endpoint Security (HX) username. This is not required if an API token is provided. | | `--password` | The Endpoint Security (HX) password. This is not required if an API token is provided. | | `--logLevel` | The logging level for the script. Valid values are `DEBUG, INFO, WARN`. Default value: `INFO`. | **Examples**: 1. **Run the script using an API token**: This command verifies the connection using a valid API token. ``` python scripts/connection_test.py --hxUrl=https://0.0.0.0:3000 --apiToken=IGis7dAPmwNV/U9WAh3qZ5V+lZjZ4T+ROVTCVhp710rTACs= ``` 2. **Run the script using a username and password with debug logging enabled**: This command verifies the connection using credentials and enables debug logs. ``` python scripts/connection_test.py --hxUrl=https://0.0.0.0:3000 --username=user --password=pass123 --logLevel=DEBUG ``` ### Run a historical search Use `historical_search.py` to run TQL queries. This section describes the command-line arguments for the `scripts/historical_search.py` script. | Argument | Description | | --- | --- | | `--hxUrl` | The URL of the Endpoint Security (HX) server instance. | | `--apiToken` | A valid user API token. This method takes precedence over the username and password. | | `--username` | The Endpoint Security (HX) username. This is not required if an API token is provided. | | `--password` | The Endpoint Security (HX) password. This is not required if an API token is provided. | | `--searchTql` | The TQL statement for the search query. You must enclose the query string in double quotes ("). | | `--relativeTime` | The search timeframe in minutes. | | `--startTime` | The exact search start date and time in UTC format: `YYYY-MM-DDThh:mm:ssZ` | | `--endTime` | The exact search end date and time in UTC format: `YYYY-MM-DDThh:mm:ssZ` | | `--logLevel` | The logging level for the script. Valid values are `DEBUG, INFO, WARN`. Set this to `WARN` if you require only the JSON search results in the output. Default value: `INFO`. | **Examples**: 1. **Search using API token and relative time**: This command runs a search using an API token for specific file hashes within the last 150 minutes. ``` python scripts/historical_search.py --hxUrl=https://0.0.0.0:3000 --apiToken=IGis7dAPmwNV/U9WAh3qZ5V+lZjZ4T+ROVTCVhp710rTACs= --searchTql="procFileAttrs.md5='8146139c2ad7e550b1d1f49480997446' or procFileAttrs.sha256='207df9d438f75185ab3af2ab1173d104831a6631c28ef40d38b2ab43de27b40f'" --relativeTime=150 ``` 2. **Search using credentials with relative time**: This command runs the same search using a username and password instead of an API token. ``` python scripts/historical_search.py --hxUrl=https://0.0.0.0:3000 --username=user --password=pass123 --searchTql="procFileAttrs.md5='8146139c2ad7e550b1d1f49480997446' or procFileAttrs.sha256='207df9d438f75185ab3af2ab1173d104831a6631c28ef40d38b2ab43de27b40f'" --relativeTime=150 ``` 3. **Search using credentials, absolute time, and specific log level**: This command runs a search for indicators within a specific UTC date range using basic authentication and limits the output to JSON results. ``` python scripts/historical_search.py --hxUrl=https://0.0.0.0:3000 --username=user --password=pass123 --searchTql="fileAttributes.md5='8146139c2ad7e550b1d1f49480997446'" --startTime=2025-12-10T10:30:43Z --endTime=2025-12-11T10:30:43Z --logLevel=WARN ```