# Resources — Observability & Monitoring

High-trust sources only. Every non-trivial claim in a lesson links to one of these. Prometheus,
OpenTelemetry, Grafana, and Thanos official docs are the spine.

## Primary — official docs

### Concepts
- **Prometheus — Metric types** — https://prometheus.io/docs/concepts/metric_types/
  — counter / gauge / histogram / summary. *(Lesson 2)*
- **Prometheus — Overview / data model** — https://prometheus.io/docs/introduction/overview/ ·
  https://prometheus.io/docs/concepts/data_model/ *(Lessons 1–2)*
- **Prometheus — Querying (PromQL)** — https://prometheus.io/docs/prometheus/latest/querying/basics/
  — and functions https://prometheus.io/docs/prometheus/latest/querying/functions/ *(Lesson 4)*
- **Prometheus — Recording rules** — https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/ *(Lesson 4)*
- **Prometheus — Alerting rules** — https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/ *(Lessons 4, 7)*
- **Prometheus — Configuration / scrape** — https://prometheus.io/docs/prometheus/latest/configuration/configuration/ *(Lesson 3)*

### Scaling & alerting
- **Thanos — components** — https://thanos.io/tip/thanos/quick-tutorial.md/ (sidecar/store/query/compact/rule) *(Lesson 5)*
- **Thanos — design** — https://thanos.io/tip/thanos/design.md/ *(Lesson 5)*
- **Alertmanager** — https://prometheus.io/docs/alerting/latest/alertmanager/ *(Lesson 7)*
- **Grafana — dashboards** — https://grafana.com/docs/grafana/latest/dashboards/ *(Lesson 6)*
- **Grafana — data sources** — https://grafana.com/docs/grafana/latest/datasources/ *(Lesson 6)*
- **Grafana OnCall** — https://grafana.com/docs/oncall/latest/ *(Lesson 7)*

### SRE / SLOs
- **Google SRE — SLIs, SLOs, error budgets** — https://sre.google/sre-book/service-level-objectives/ *(Lesson 8)*
- **Google SRE — Monitoring (golden signals)** — https://sre.google/sre-book/monitoring-distributed-systems/ *(Lessons 1, 8)*
- **RED method (Weave Works)** — https://www.weave.works/blog/the-red-method-key-metrics-for-microservices-architecture/ *(Lesson 1)*

### Tracing & logs
- **OpenTelemetry — Traces (concept)** — https://opentelemetry.io/docs/concepts/signals/traces/ *(Lesson 9)*
- **OpenTelemetry — Collector** — https://opentelemetry.io/docs/collector/ (receivers/processors/exporters) *(Lesson 10)*
- **Jaeger** — https://www.jaegertracing.io/docs/latest/ *(Lesson 10)*
- **GCP Cloud Logging** — https://cloud.google.com/logging/docs/overview *(Lesson 11)*
- **OpenTelemetry — Logs** — https://opentelemetry.io/docs/concepts/signals/logs/ *(Lesson 11)*

### The mesh view
- **Kiali** — https://kiali.io/docs/ *(Lesson 12)*
- **Istio — Observability** — https://istio.io/latest/docs/concepts/observability/ *(Lessons 3, 12)*

## Books / structured learning
- **Google SRE Book** (free) — https://sre.google/books/
- **Prometheus: Up & Running** (Brazil) — the standard reference.
- **PCA — Prometheus Certified Associate** — https://training.linuxfoundation.org/certification/prometheus-certified-associate/

## In-repo ground truth
- [reference/repo-observability-map.md](./reference/repo-observability-map.md) — the Prometheus/
  Thanos/Grafana/OTel/Jaeger/Kiali/OnCall config + the `golibs/{metrics,tracer,logger}` packages,
  with paths and line anchors.

## Communities (for wisdom)
- **CNCF Slack** — `#prometheus`, `#opentelemetry`, `#thanos` near the maintainers.
- **r/sre** / **r/devops** — practical monitoring Q&A.
- Internally: the platform team owning `deployments/helm/platforms/monitoring/` — *what the
  actual SLOs and on-call rotations are*.