Un sistema que no ves es un sistema que no operas — sin negociación.
OpenTelemetry con Collector, trazas, métricas y logs correlacionados, SLO con burn-rate y alertas que apuntan a un runbook. La observabilidad nace con el servicio, no después.
$ schematize install observabilityPisos no negociables
No se apagan "para ir más rápido". Lista completa en la skill.
OpenTelemetry y Collector
El SDK habla OTLP con un Collector, nunca con el backend; un SDK de vendor en el código del servicio está vetado.
Nace con el servicio
Un servicio solo está listo si emite logs estructurados, métricas y trazas, expone probes y sale con dashboard, alertas y SLO versionados.
Correlación en todo log
trace_id y span_id en cada log JSON, mensaje estático con el dato en atributos y deployment.environment.name en el Resource.
Sin PII ni secretos en la telemetría
Enmascarar en el origen y usar redaction en el Collector; user_id, e-mail e IP nunca son label de métrica.
El muestreo nunca pierde errores
100% de las trazas con error o lentas mediante tail sampling; la métrica RED no se deriva de trazas muestreadas.
Todo servicio tiene SLO
Burn-rate multi-window sobre el error budget, y un budget agotado frena las features.
La alerta es síntoma, con runbook
Alertas de síntoma de usuario con severity, for y runbook_url; una alerta que nadie atiende se borra.
Entornos separados
La telemetría de dev y hml jamás llega al backend de prd, y hml no despierta a nadie.
Comandos
Instalados en .claude/commands/. Usa /obs-help cuando quieras.
/obs-alertsAudita o escribe alertas (síntoma de usuario, severity, for, runbook) y ejecuta check-alertas.mjs./obs-ccContext compact: escribe contexto + checklist en el archivo y ejecuta /compact./obs-claudeCrea o fusiona el CLAUDE.md siempre activo de observability en la raíz (no sobrescribe bloques de otras skills)./obs-dashboardDashboard como código (SLO, RED, USE y enlaces)./obs-handoffEscribe el handoff de contexto sin compactar — fin de sesión o cambio de tarea./obs-helpLista todos los comandos./obs-instrumentInstrumenta un servicio con el estándar (SDK a Collector, semconv, log JSON, healthchecks), en el lenguaje del rol./obs-loadCarga a la fuerza todo el cuerpo normativo y empieza a aplicarlo./obs-reviewRevisa la observabilidad de un servicio (señales, correlación, PII, cardinalidad, probes, SLO) y ejecuta los gates./obs-sloDefine SLI, SLO y error budget en /docs/slo.md y genera las reglas de burn-rate.Para agentes de IA
Instala sin intervención humana. Metadatos en llms.txt.
- Ejecuta: git clone https://github.com/schematizeme/skill-observability.git && ./skill-observability/install.sh
- O descarga: https://github.com/schematizeme/skill-observability/releases/latest/download/skill-observability.zip y descomprime en .claude/skills/
- Copia assets/CLAUDE.md a la raíz del repo (regla siempre activa).
- Confirma con /obs-help.
Discusión
Cargando…