How to audit devices
This guide shows you how to trigger an ad-hoc audit on selected devices so that AlloyScan collects a fresh hardware, software, and configuration snapshot.
Prerequisites
- Administrator role, or User role with permission to start audits.
- The target devices already exist in Inventory, or appear as Ready for audit in a segment's Scan Results.
- Available headroom in the site's Audits per month quota — each audit consumes one count.
The audit method has additional prerequisites:
- Agentless audit: The segment must have an active Audit Service with valid compatible credentials for the target type.
- Agent-based audit: The device must have a correctly associated working Audit Agent. Audit Service credentials are not required.
If a discovered device is not ready, see How to prepare discovered devices for audit.
Steps
- Choose your starting point:
- For devices already in Inventory, navigate to Inventory > (device type) and tick the checkboxes next to the rows you want to audit.
- For devices fresh from a scan, navigate to Network > Segments > (segment) and tick rows in Scan Results that show the Ready for audit check.
- Click Audit in the toolbar.
- AlloyScan enqueues an audit task. You can monitor it in Admin Center > Tasks and services > Active tasks.
If the Audit button is disabled, no rows are selected. If audits keep failing with authentication errors, the credentials may be stale — see How to manage credentials.
Verify
After the audit completes, open the Audit tab on each device's form. You should see:
- A new Audit ID (UUID) and an updated Audit date.
- An Audit source value identifying the origin (Service or Agent).
Also, a new row in Admin Center > Logs > Audit log records Start date, Scope, Initiator, Status, and Errors count. If a per-device audit fails, AlloyScan retains that device's previous snapshot rather than blanking it.