Un système qu’on ne voit pas est un système qu’on n’exploite pas — sans négociation.
OpenTelemetry avec Collector, traces, métriques et logs corrélés, SLO avec burn-rate et alertes qui pointent vers un runbook. L’observabilité naît avec le service, pas après.
$ schematize install observabilitySocles non négociables
Jamais désactivés "pour aller plus vite". Liste complète dans la skill.
OpenTelemetry et Collector
Le SDK parle OTLP à un Collector, jamais au backend ; un SDK de vendor dans le code du service est interdit.
Naît avec le service
Un service n’est prêt que s’il émet des logs structurés, des métriques et des traces, expose des probes et part avec dashboard, alertes et SLO versionnés.
Corrélation dans chaque log
trace_id et span_id dans chaque log JSON, message statique avec la donnée en attribut et deployment.environment.name dans le Resource.
Ni PII ni secret dans la télémétrie
Masquer à la source et utiliser redaction dans le Collector ; user_id, e-mail et IP ne deviennent jamais un label de métrique.
L’échantillonnage ne perd jamais les erreurs
100 % des traces en erreur ou lentes via tail sampling ; la métrique RED ne dérive pas de traces échantillonnées.
Chaque service a un SLO
Burn-rate multi-fenêtre sur l’error budget, et un budget épuisé gèle les fonctionnalités.
L’alerte est un symptôme, avec runbook
Alertes sur symptôme utilisateur avec severity, for et runbook_url ; une alerte que personne n’exploite est supprimée.
Environnements séparés
La télémétrie de dev et hml n’atteint jamais le backend de prd, et hml ne réveille personne.
Commandes
Installées dans .claude/commands/. Lancez /obs-help à tout moment.
/obs-alertsAudite ou écrit des alertes (symptôme utilisateur, severity, for, runbook) et lance check-alertas.mjs./obs-ccContext compact : écrit contexte + checklist dans l'archive et lance /compact./obs-claudeCrée ou fusionne le CLAUDE.md toujours actif de observability à la racine (n'écrase pas les blocs d'autres skills)./obs-dashboardDashboard as code (SLO, RED, USE et liens)./obs-handoffÉcrit le handoff de contexte sans compacter — fin de session ou changement de tâche./obs-helpListe toutes les commandes./obs-instrumentInstrumente un service selon le standard (SDK vers Collector, semconv, log JSON, healthchecks), dans le langage du rôle./obs-loadCharge de force tout le corpus normatif et commence à l’appliquer./obs-reviewRévise l’observabilité d’un service (signaux, corrélation, PII, cardinalité, probes, SLO) et lance les gates./obs-sloDéfinit SLI, SLO et error budget dans /docs/slo.md et génère les règles de burn-rate.Pour les agents IA
Installez sans intervention humaine. Métadonnées dans llms.txt.
- Lancez : git clone https://github.com/schematizeme/skill-observability.git && ./skill-observability/install.sh
- Ou téléchargez : https://github.com/schematizeme/skill-observability/releases/latest/download/skill-observability.zip et décompressez dans .claude/skills/
- Copiez assets/CLAUDE.md à la racine du repo (règle toujours active).
- Confirmez avec /obs-help.
Discussion
Chargement…