← ClaudeAtlas

telemetry-canarylisted

Observability and structured logging canary — checks for structured logs (JSON), OpenTelemetry metrics/traces, proper error stack traces, and flags empty catches or silent log swallowing. Triggers on keywords: "/telemetry-canary", "telemetry-canary", "observability audit", "structured logging". Use when adding or changing logging, metrics, tracing, or error-handling code.
HetCreep/CoalMine · ★ 1 · Code & Development · score 72
Install: claude install-skill HetCreep/CoalMine
# Telemetry Canary (Observability & Logging Audit) <!-- SHARED:LANGUAGE_HEADER --> Audit code for proper telemetry instrumentation. Ensure the application is not a black box in production. ## Auditing Categories 1. **Empty / Silent Catch** — Catch blocks that swallow exceptions without logging a stack trace or forwarding the error (violates visibility). 2. **Unstructured Logs** — Plain-string logging in server code (recommend JSON or structured key-value formats for cloud queries). 3. **No Correlation ID** — Operations traversing boundaries (HTTP/gRPC/threads) without propagating a trace/correlation ID. 4. **Missing Metrics** — Critical business transactions (e.g., checkouts, auth, errors) that lack counter/histogram instrumentation. 5. **No Stack Traces** — Errors logged without stack context (e.g., `logger.error(e.message)` instead of passing the entire error object `logger.error(e)`). Per-stack grep patterns and right/wrong shapes for every category: read `references/checks.md` before scanning. ## Fix mode (choice-gated) In Agent Context, after the audit report, present via `ask_question`: - **Apply safe logs:** Insert missing error logging into empty catch blocks (using a standard logger template) and add stack trace mapping. - **Let me pick:** Allow the user to select which telemetry gaps to resolve. - **Report only:** Exit without making changes. ## Output Format `| file:line | category | severity | finding | recommendation |` Severity: CRITICAL (swallowed erro