Modulo 13 — Osservabilità ed esercizio
Blocco C · Il modello per l'Ente · 4 ore
Obiettivi
Rendere il servizio osservabile (metriche Prometheus, dashboard Grafana, log con
rotazione) e operabile (runbook). L'esemplare Pratiche è ora completo di tutto
ciò che il blueprint richiederà.
Agenda
| Ora | Attività |
|---|---|
| 0:00–0:45 | I tre pilastri: log (cosa è successo), metriche (come sta andando), health (è vivo?); a che domanda risponde ciascuno |
| 0:45–1:30 | Prometheus e Grafana in pratica: scrape, query di base (rate), pannelli; il runbook: cosa contiene e perché vive nel repo |
| 1:30–3:30 | Lab 13: /metrics nell'API, stack di monitoraggio, due pannelli, runbook compilato |
| 3:30–4:00 | Debrief: simulazione "il servizio non risponde" seguendo il runbook, cronometro alla mano |
Concetti chiave
- Senza metriche il primo alert è la telefonata dell'utente.
- La dashboard serve a vedere il TREND; l'healthcheck il PRESENTE; il log il PASSATO.
- Runbook nel repo: si aggiorna nello stesso merge request che cambia il servizio.
Materiali
- Lab:
lab/start/CONSEGNA.md→lab/final/(monitoring/ + runbook + app con /metrics)