observability-engineeringlisted
Install: claude install-skill rogue-dev-studio/ai-agents-rogue
# Observability Engineering (Canonical)
**Expertise: expert.** Aliases: `observability`, `logging`, `metrics`, `tracing`, `healthchecks`.
This skill covers **application observability**. It does not replace `monitoring` (assistant/CLI usage metering).
## When to use
- Structured log, request id, audit trail teknis
- Health/readiness/liveness endpoints
- Metrics dasar (latency, error rate) atau integrasi error tracker
- Diagnosis kegagalan lokal/compose mendekati Phase 2
## When not to use
- Tracking usage Claude/CLI → `monitoring`
- Hanya UI empty-state → `frontend-engineering`
- Infra cluster penuh → `infra-tools` / `cloud-tools`
## Procedure
1. **Signals** — Tentukan log/metric/trace yang menjawab “apa rusak?”.
2. **Structure** — Log JSON/key-value konsisten; level benar (info/warn/error).
3. **Correlation** — Request/correlation id across API → job bila ada.
4. **Safety** — Redact token, password, PII berlebih (selaras `security`).
5. **Health** — Dependensi kritis (DB) dicek; bedakan liveness vs readiness bila ada.
6. **Noise** — Hindari log per-row di hot path; sample atau aggregate.
7. **Verify** — Reproduksi error terlihat di log dengan id; runbook singkat di docs bila E2E.
Detail: `reference.md`.
## DoD
- [ ] Log terstruktur pada path error utama
- [ ] Tidak ada secret/PII berlebih di log
- [ ] Healthcheck bermakna untuk dependensi P0
- [ ] Cara membaca sinyal tertulis singkat (docs/handoff)
## Attribution
<!-- ATTRIBUTION: Rogue Development | https://git