ModulesPreflight
Preflight
Runs HW/SW/SVC/NW/ST/SEC health checks at boot and runtime, gates the agent on critical failures, and reports results via the event bus.
The Preflight module runs hardware, software, network, storage and security health checks at boot time (as a blocking systemd gate) and periodically at runtime. Results are persisted per run, published on the event bus to the device status channel, and — when a critical check fails — escalated via the alertmanagement and notifier modules.
Features
- Boot Gate: Blocks the agent start when a critical check fails, surfacing the reason to systemd and journald.
- Runtime Polling: Re-runs all enabled checks periodically and publishes reports on the event bus.
- Ranges Config: Thresholds and enabled checks are configured per deployment in an editable YAML file.
- Critical Escalation: Emits alertmanagement events and push notifications on ok→crit transitions.
Use cases
- Block agent startup automatically when disk space or a required hardware handshake fails a critical check
- Run all health checks on demand from the UI to validate a device before deploying a new workflow
- Receive a push notification the moment a sensor hardware check transitions from ok to critical
- Review the history of per-check results to identify recurring failures across runtime polling cycles
- Configure per-deployment thresholds in a ranges YAML to tighten battery or storage warn levels without redeploying
Pages
| Page | Purpose | Required role |
|---|---|---|
| Preflight | Monitor the most recent preflight run and historical check results. |