jester/zlh-grind
1
0
Fork 0
Code Issues 14 Pull Requests Actions Packages Projects Releases Wiki Activity
b0773cb97f
zlh-grind/Codex/Monitoring
History
jester b0773cb97f Add monitoring open items
2026-05-01 18:27:24 +00:00
..
CONTRACT.md Add monitoring contract 2026-05-01 18:27:04 +00:00
CURRENT_STATE.md Add monitoring current-state audit baseline 2026-05-01 18:26:39 +00:00
OPEN_ITEMS.md Add monitoring open items 2026-05-01 18:27:24 +00:00
README.md Add monitoring Codex README 2026-05-01 18:25:22 +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.