PortivoDocs · v2.0.0Complete handbookportivo.orgGitHub
Operations

Fleet Audits

Evidence-based fleet assessments and PDF reporting.

v2.0.0Source-backed

How an audit runs

An operator explicitly selects audit type and target switches. The engine uses bounded cross-device concurrency while all commands for one audit/device share one serialized SSH session.

Stored evidence

The audit engine stores normalized findings, evidence summaries, severity, coverage and command-level compatibility errors. It does not persist raw SSH credentials, and raw command output is not retained as the audit-history model.

Coverage semantics

Unsupported or unavailable commands reduce evidence coverage rather than becoming false device faults. Full Switch Health combines only reported evidence; unavailable metrics do not reduce the health score.

Active audit catalog

AuditCategoryCommandsDescription
Thermal Health AuditHardware health1Evaluate reported temperatures and device-reported thermal thresholds/status.
Fan & Cooling AuditHardware health2Check fans and correlate cooling faults with thermal state.
Power Supply Health AuditHardware health1Check PSU state and identify failed or degraded power redundancy.
PoE Capacity AuditPower over Ethernet4Review PoE delivery, per-port fault state, PSU context, Ethernet link state and available power budget.
Interface Error AuditInterfaces3Find CRC/FCS, interface errors, drops, discards and collisions and correlate them with live port state and alias.
Port Stability AuditInterfaces3Detect repeated link-state transitions and correlate unstable ports with their current state and alias.
Uplink Health AuditConnectivity4Check managed-switch LLDP uplinks for state, media degradation and error evidence.
Configuration Save AuditConfiguration safety4Identify working/certified or running/persistent configuration that is not synchronized.
Full Switch Health AuditExecutive health11Correlate hardware, environment, power, interfaces, PoE, configuration and control-plane health into one score.

PDF reports

Reports are generated on demand from normalized audit records and can include severity distribution, plain-language interpretation, exact read-only collection commands, audit-specific evidence tables and recommended verification steps.