configure-instrumentation

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