d42c653eea
- engineering-docs → archive/2026-03-29-engineering-docs (63/63 tasks complete) - phase-2-production-ready → archive/2026-03-29-phase-2-production-ready (89/89 tasks complete) - openspec/specs/ synced with all Phase 1 + Phase 2 + engineering-docs capabilities (22 specs total) Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1.5 KiB
1.5 KiB
Spec: Prometheus + Grafana Monitoring
Status: Pending CEO approval Workstream: 7 of 8
Scope
prom-clientintegration — exposeGET /metrics- 7 metrics (counters + histograms) across all services
monitoring/directory: Prometheus config + Grafana provisioningdocker-compose.monitoring.ymloverlay (adds prometheus + grafana services)- Pre-built Grafana dashboard JSON (
monitoring/grafana/dashboards/agentidp.json)
Metrics
| Metric | Type | Labels |
|---|---|---|
agentidp_tokens_issued_total |
Counter | outcome (success/failure) |
agentidp_agents_registered_total |
Counter | outcome |
agentidp_http_requests_total |
Counter | method, path, status_code |
agentidp_http_request_duration_seconds |
Histogram | method, path |
agentidp_rate_limit_rejections_total |
Counter | — |
agentidp_db_query_duration_seconds |
Histogram | operation |
agentidp_redis_command_duration_seconds |
Histogram | command |
Acceptance Criteria
GET /metricsreturns Prometheus text format/metricsendpoint does NOT require Bearer auth (Prometheus scrapes it)- All 7 metrics present and updating under load
- Grafana dashboard auto-provisions on
docker compose -f docker-compose.monitoring.yml up - Grafana runs on port 3001 (no conflict with AgentIdP on 3000)
docs/devops/operations.mdupdated with monitoring sectionprom-clientadded as new dependency — CEO approval gate