OBSERVABILITY_SPEC
Category: 10. Cloud / DevOps / Platform
Section: Phase 2: Technical Blueprint
9. OBSERVABILITY_SPEC.md
Purpose: To define logging, metrics, tracing, and alerting.
Act as a senior SRE/observability engineer.
Using the PRD and System Architecture below, create an Observability Specification document for this DevOps hackathon project.
PRD: [PASTE PRD]
ARCHITECTURE: [PASTE SYSTEM_ARCHITECTURE]
Provide:
1. Observability pillars (Logs, Metrics, Traces)
2. Logging strategy (What to log, Format, Retention)
3. Metrics strategy (What to measure, Dashboards)
4. Tracing strategy (Distributed tracing, Correlation IDs)
5. Tools (Prometheus, Grafana, Loki, Jaeger, Datadog, CloudWatch)
6. Alerting rules (What triggers an alert?)
7. Notification channels (Slack, Email, PagerDuty)
8. Dashboards (Golden signals: Latency, Traffic, Errors, Saturation)
9. SLOs and SLIs (If applicable)
10. Incident response integration
11. Example dashboard layout
12. A checklist for verifying observability before the demo
Explain each concept in beginner-friendly language.
Keep the observability setup simple and realistic for a hackathon.
Prefer free-tier tools.