Skip to main content

Device Management Commands

Commands for discovering hardware, generating device profiles, and monitoring fleet health.

Hardware Audit

CommandDescription
device audit collectCollect hardware/software specs (local or remote via SSH)
device audit profileGenerate profile.yaml and device-profile.md from specs

Fleet Health Monitoring

CommandDescription
device fleet checkQuick SSH health check across fleet devices
device fleet reportGenerate HTML fleet health report

Linux Remote Collection

CommandDescription
device linux collectCollect specs from Linux machine via SSH

Infrastructure Inventory (ra-infrastructure)

CommandDescription
inv device listList inventory devices with filtering
inv db healthCheck inventory database health
inv device countCount devices by category, type, zone, status
inv device show SLUGShow device details
inv device create NAMEAdd a new device to inventory

Typical Workflow

Onboarding a New Device

  1. Run device audit profile to auto-collect specs and generate profile files
  2. Review the generated profile.yaml for WMI inaccuracies (Windows) or missing details
  3. Add snipeit: block if the device is tracked in Snipe-IT
  4. Commit the profile to the profiles/ directory

Ongoing Fleet Monitoring

  1. Run device fleet check for a quick terminal view of all device health
  2. Run device fleet report to generate a shareable HTML report
  3. Address any version staleness or connectivity issues flagged in the report