Scan Tasks
A Scan Task is a configuration that defines which IP ranges the agent will check for device discovery and how to authenticate with found miners. Each agent can have multiple scan tasks for different subnets.
How Scanning Works
The agent periodically iterates through all IP addresses within the specified ranges and attempts to establish a connection with each address. If a supported ASIC miner is detected at an address, it is added to the site's Workers list and begins transmitting metrics.
Scanning occurs on a schedule in the background. The scan frequency can be configured in the task parameters.
Scan Intervals v0.6.0
| Interval | Description |
|---|---|
| 3 min | Maximum frequency. For small networks (up to several hundred addresses) |
| 15 min | Standard mode. A balance between discovery speed and load |
| 30 min | For large ranges (thousands of addresses) |
| 1 hour | Minimum load. For stable networks without frequent changes |
Parallel Scan Threads v0.6.0
The number of parallel threads determines the scan speed — how many IP addresses are checked simultaneously. More threads mean faster scanning, but also higher load on the network and the agent's server.
The number of threads can be changed in the agent settings without restarting it — the change is applied immediately.
Task Status v0.3.0
Each scan task can be:
- Enabled — active, the agent scans the specified ranges
- Disabled — inactive, ranges are not scanned. IP ranges are preserved
Individual IP ranges within a task can also be enabled and disabled independently without deletion.
Renaming Ranges v0.7.0
Each IP range can be given a descriptive name — for example, "Rack A", "Subnet 10.0.1.x", or "Building 2". This simplifies navigation when there are many ranges in a single task.
More details on creating and managing tasks can be found in the following sections.