Skip to content

Output files

Per-run summary — SUMMARY/YYYY-MM/SUMMARY_timestamp.csv

Section titled “Per-run summary — SUMMARY/YYYY-MM/SUMMARY_timestamp.csv”

One row per device per run:

host,vendor,site,hostname,serial,model,status,error,post_check
10.0.0.1,cisco,Site-A,CORE-SW-01,FCW1234A01B,C9300-48P,success,,show snmp user output...
10.0.0.2,alcatel,Site-B,N1744PS1R1ESW01,,OS6860-P48,error,Auth failed,
ColumnDescription
hostIP address
hostnameDiscovered live from device
serialDiscovered from device
modelDiscovered from device
statussuccess, PARTIAL (device rejected one or more config commands), or error
errorFailure reason (empty on success)
post_checkOutput of the post-check command

Health report — SUMMARY/YYYY-MM/HEALTH_timestamp.csv / .html

Section titled “Health report — SUMMARY/YYYY-MM/HEALTH_timestamp.csv / .html”

Generated by --healthcheck. One row per device: CPU %, memory %, virtual-chassis state (Catalyst StackWise/VSS, Nexus vPC, Alcatel VC), and a threshold-evaluated status OK / WARN / CRIT / ERROR. The HTML version is the same table with color-coded status cells, sorted worst-first — suitable as an email body via --notify.

Persistent. Updated on every run. One row per device. Per-task columns added automatically.

host,hostname,vendor,site,model,serial,ios_version,last_seen,SNMPV3_status,SNMPV3_date
10.0.0.1,CORE-SW-01,cisco,Site-A,C9300-48P,FCW1234A01B,17.3.5,2026-05-02 15:00,CONFIGURED,2026-05-02 15:00
FolderContents
PRE_CHECK/{hostname}.cfgRunning-config or show output captured before changes
POST_CHECK/{hostname}.cfgVerification output captured after changes

Backup files — BACKUP/YYYY-MM/{hostname}_{timestamp}.cfg

Section titled “Backup files — BACKUP/YYYY-MM/{hostname}_{timestamp}.cfg”

Full running-configs saved when --backup flag is used. See Backup task.

Failed devices — config/failed_devices.csv

Section titled “Failed devices — config/failed_devices.csv”

Auto-created after any run that has failures. Use with --retry to retry only failed devices.

Merge all per-run SUMMARY CSVs into one file (one row per device, latest run wins):

Terminal window
python -m src --consolidate
# Output: SUMMARY/CONSOLIDATED_SUMMARY.csv