Un sistema che non vedi è un sistema che non gestisci — senza negoziare.
OpenTelemetry con Collector, trace, metriche e log correlati, SLO con burn-rate e alert che puntano a un runbook. L’osservabilità nasce con il servizio, non dopo.
$ schematize install observabilityBasi non negoziabili
Non si spengono "per andare più veloce". Elenco completo nella skill.
OpenTelemetry e Collector
L’SDK parla OTLP con un Collector, mai con il backend; un SDK di vendor nel codice del servizio è vietato.
Nasce con il servizio
Un servizio è pronto solo se emette log strutturati, metriche e trace, espone probe e parte con dashboard, alert e SLO versionati.
Correlazione in ogni log
trace_id e span_id in ogni log JSON, messaggio statico con il dato negli attributi e deployment.environment.name nel Resource.
Niente PII né segreti nella telemetria
Mascherare all’origine e usare redaction nel Collector; user_id, e-mail e IP non diventano mai label di metrica.
Il campionamento non perde mai gli errori
100% delle trace con errore o lente tramite tail sampling; la metrica RED non deriva da trace campionate.
Ogni servizio ha un SLO
Burn-rate multi-window sull’error budget, e un budget esaurito blocca le feature.
L’alert è un sintomo, con runbook
Alert su sintomo utente con severity, for e runbook_url; un alert su cui nessuno agisce viene eliminato.
Ambienti separati
La telemetria di dev e hml non arriva mai al backend di prd, e hml non sveglia nessuno.
Comandi
Installati in .claude/commands/. Usa /obs-help quando vuoi.
/obs-alertsVerifica o scrive alert (sintomo utente, severity, for, runbook) ed esegue check-alertas.mjs./obs-ccContext compact: scrive contesto + checklist nell'archivio ed esegue /compact./obs-claudeCrea o unisce il CLAUDE.md sempre attivo di observability nella radice (non sovrascrive blocchi di altre skill)./obs-dashboardDashboard come codice (SLO, RED, USE e link)./obs-handoffScrive l'handoff di contesto senza compattare — fine sessione o cambio attività./obs-helpElenca tutti i comandi./obs-instrumentStrumenta un servizio secondo lo standard (SDK verso Collector, semconv, log JSON, healthcheck), nel linguaggio del rol./obs-loadCarica a forza l’intero corpo normativo e inizia ad applicarlo./obs-reviewRivede l’osservabilità di un servizio (segnali, correlazione, PII, cardinalità, probe, SLO) ed esegue i gate./obs-sloDefinisce SLI, SLO ed error budget in /docs/slo.md e genera le regole di burn-rate.Per agenti IA
Installa senza intervento umano. Metadati in llms.txt.
- Esegui: git clone https://github.com/schematizeme/skill-observability.git && ./skill-observability/install.sh
- Oppure scarica: https://github.com/schematizeme/skill-observability/releases/latest/download/skill-observability.zip e decomprimi in .claude/skills/
- Copia assets/CLAUDE.md nella radice del repo (regola sempre attiva).
- Conferma con /obs-help.
Discussione
Caricamento…