History

jester a146979dad Trim monitoring open items after launch-ready validation		2026-05-01 20:57:03 +00:00
..
CONTRACT.md	Clarify centralized Loki log model	2026-05-01 20:23:23 +00:00
CURRENT_STATE.md	Update monitoring current state after launch-ready smoke tests	2026-05-01 20:55:42 +00:00
DECISIONS.md	Add monitoring decisions	2026-05-01 20:54:27 +00:00
OPEN_ITEMS.md	Trim monitoring open items after launch-ready validation	2026-05-01 20:57:03 +00:00
README.md	Add monitoring Codex README	2026-05-01 18:25:22 +00:00
VALIDATION.md	Add monitoring validation checklist	2026-05-01 18:27:50 +00:00

README.md

Monitoring Codex

This folder tracks the ZeroLagHub monitoring and observability workstream.

Monitoring implementation lives across infrastructure, API, Agent, Prometheus, Grafana, Alloy, and future log collection. This folder is the coordination layer for the monitoring contract, launch-readiness status, and validation plan.

Files

CURRENT_STATE.md — observed monitoring state and launch-readiness posture
CONTRACT.md — intended monitoring/discovery/label contract
OPEN_ITEMS.md — active monitoring blockers and follow-up work
VALIDATION.md — smoke-test and acceptance checklist

Ownership boundary

zlh-grind tracks coordination and decisions only. Implementation belongs in the relevant source/config locations:

zpack-api for monitoring discovery endpoints, health endpoints, app metrics, and auth boundaries
zlh-agent for Alloy config/labels, structured logs, and container-local telemetry behavior
monitoring host configuration for Prometheus, Grafana, Alloy, dashboards, firewall/bind policy, and file_sd sync
infrastructure layer for OPNsense/PBS monitoring exceptions

Current launch posture

As of the latest monitoring audit, monitoring is not launch-ready. Core services are running, but public exposure, stale/failing discovery, missing dashboards, and missing centralized logs block launch-debug readiness.