| created | "2026-07-05T00:00:00.000Z" |
| modified | "2026-07-05T00:00:00.000Z" |
| reviewed | "2026-07-05T00:00:00.000Z" |
| description | Observability instrumentation: OpenTelemetry traces/metrics, structured logging, Sentry. Use when wiring telemetry, tracing, or logging into a repo. |
| allowed-tools | Glob, Grep, Read, Write, Edit, Bash(bash *), Bash(npm *), Bash(bun *), Bash(uv *), AskUserQuestion, TodoWrite, SlashCommand, WebSearch, WebFetch |
| args | [--check-only] [--fix] [--type <otel|logging|metrics|sentry>] |
| argument-hint | [--check-only] [--fix] [--type <otel|logging|metrics|sentry>] |
| name | configure-instrumentation |
/configure:instrumentation
Check and upsert observability instrumentation — OpenTelemetry traces and
metrics, structured logging, and error tracking — against project standards.
When to Use This Skill
| Use this skill when... | Use another approach when... |
|---|
| Wiring up observability for a repo (traces, metrics, logs) in one pass | Only Sentry error tracking is needed (use /configure:sentry) |
| Checking what instrumentation a project already has | Debugging a live tracing/metrics pipeline (use the vendor's tools) |
| Adding vendor-neutral OpenTelemetry instead of a vendor-locked SDK | Load-testing performance (use /configure:load-tests) |
| Adding structured logging (pino/winston, structlog/loguru) | Profiling memory (use /configure:memory-profiling) |
Standardizing OTEL_* env-var configuration and OTLP export | Managing dashboards/alerts in Grafana or the vendor UI |
Context
- Package.json: !
find . -maxdepth 1 -name 'package.json'
- Pyproject.toml: !
find . -maxdepth 1 -name 'pyproject.toml'
- Project standards: !
find . -maxdepth 1 -name '.project-standards.yaml' -type f
- OTel in package.json: !
find . -maxdepth 1 -name 'package.json' -exec grep -o '"@opentelemetry/[^"]*"' {} +
- OTel in pyproject.toml: !
find . -maxdepth 1 -name 'pyproject.toml' -exec grep -o 'opentelemetry-[a-z-]*' {} +
- Init candidates: !
find . -maxdepth 2 -type f \( -name 'otel*' -o -name '*telemetry*' -o -name 'tracing*' -o -name 'instrumentation*' \) -not -path '*/node_modules/*'
- Structured loggers: !
find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' \) -exec grep -oE '"(pino|winston)"|structlog|loguru' {} +
- Sentry SDK: !
find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' \) -exec grep -oE '@sentry/[a-z-]*|sentry-sdk' {} +
Parameters
Parse these from $ARGUMENTS:
| Flag | Description |
|---|
--check-only | Report status without offering fixes |
