Audit Agents Reference
Reference for the per-Site Audit Agents catalog: list purpose, observed columns, lifecycle states, and operational signals.
Menu path
Admin Center > Site Settings > Tasks and services > Audit agents.
Purpose
This list shows every Audit Agent currently registered for the Site. It is the admin-side confirmation point after agent deployment and the first place to check when a remote endpoint stops reporting.
The top section exposes the same platform download actions as the deployment page:
- Windows
- macOS
- Linux
List view
The current observed grid is a Site-scoped list of registered agents.
| Column | Type | Description |
|---|---|---|
| Name | String | Endpoint or host name of the registered Audit Agent. Sorted ascending by default. |
| Status | Enum / icon | Current health state. Inactive agents show a status marker. |
| Audit ID | UUID | Stable identifier of the agent registration. |
| IP address | String | Last known address reported by the agent. |
| Device | Link / String | Related device record in Inventory when one is already linked. The exact presentation may vary by deployment. |
Note: The tested environment exposed the main columns above. Some deployments may show additional metadata in the row or detail view.
Lifecycle states
| State | Meaning |
|---|---|
| Active | Agent is installed and sending heartbeats. |
| Inactive | Agent has not checked in within the configured inactivity period. |
| ScheduledForDeletion | Agent is marked for deletion after inactivity or an administrative cleanup action. |
If an agent comes back online while scheduled for deletion, it self-uninstalls. If it remains offline until expiry, AlloyScan removes the registration record from the server side.
Operational signals
| Signal | What to check |
|---|---|
| Newly deployed endpoint does not appear | Confirm outbound HTTPS/443 reachability from the endpoint and wait for first registration and audit. |
| Agent listed as inactive | Check endpoint availability and confirm the service is still installed and running locally. |
| Endpoint present in Inventory but stale | Compare the agent's last observed activity with device audit history. |
Relationship to Audit Agent settings
The inactivity window and related retention behavior are controlled from Admin Center > Site Settings > Settings > Audit agent settings. The agents list is the observable result surface; the settings page controls the policy.