# monitoring

> **Docs live on Discourse — this repo is the executable source of truth.**
> **Topic:** https://community.turnsys.com/t/323
> **Redmine:** https://projects.knownelement.com/issues/343 · **Split from** KNEL/PFVCluster@041d311 per [#769](https://projects.knownelement.com/issues/769)

OAM monitoring stack: LibreNMS, oxidized, smokeping, netdisco, unpoller, weathermap; librenms-agent (check_mk + snmp-extend). Prometheus/Alertmanager/Grafana/Kuma buildout per [\#773]. Coverage matrix governs boundaries [\#343].

## Layout
- `scripts/` — rule engine + hooks (see `bash scripts/check-rules.sh --fast`)
- (imported content at repo root, mirroring its PFVCluster path layout)

## Provenance
Code imported from KNEL/PFVCluster (041d311); full git history retained in PFVCluster. Enforcement layer copied per ADOPTING.md. IaC consumers: KNEL/KNELIAC references this repo.