Telemetry Canary

Telemetry Canary (Observability & Logging Audit)

Audit code for proper telemetry instrumentation — ensure the app 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.
2. Unstructured Logs — plain-string logging in server code (prefer JSON / structured key-value for cloud queries).
3. No Correlation ID — operations crossing boundaries (HTTP/gRPC/threads) without propagating a trace/correlation ID.
4. Missing Metrics — critical transactions (checkout, auth, errors) lacking counter/histogram instrumentation.
5. No Stack Traces — errors logged without stack context (logger.error(e.message) instead of logger.error(e)).

Per-stack grep patterns and right/wrong shapes per category: read references/checks.md before scanning.

Fix mode (choice-gated)

In Agent Context, after the report, present via ask_question:

• Apply safe logs: insert error logging into empty catch blocks (standard logger template) + stack-trace mapping. Each fix: checkpoint (git stash/commit in a git repo; else copy the file aside — never assume git) → apply → build + tests → auto-revert if newly red.
• Let me pick: user selects which telemetry gaps to resolve.
• Report only: exit unchanged.

Output

| file:line | category | severity | finding | recommendation |

Severity: CRITICAL (swallowed error with state mutation) · HIGH (missing stack trace in error logs) · MEDIUM (unstructured log in API boundary) · LOW (minor trace gaps)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: HetCreep
• Source: HetCreep/CoalMine
• License: MIT
• Homepage: https://github.com/TheColliery

Install and usage instructions live in the source repository linked above.