Online Help
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.
- Valid credentials of the right type are present in the assigned Audit Service's credentials pool.
- Available headroom in the site's Audits per month quota — each audit consumes one count.
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 > Site Settings > 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 > Site Settings > 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.
Related
- How to manage credentials
- How to audit schedules — automate per-device audits
- Audit Service Reference
- About Discovery and Audit