observability-and-instrumentation

Instruments production code with structured logs, metrics, traces, and symptom-based alerts.

Updated Jul 1, 2026
One-click install
npx skills add https://github.com/raishoemi/traffic-sim-v2 --skill observability-and-instrumentation-raishoemi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability-and-instrumentation
Source: https://github.com/raishoemi/traffic-sim-v2/tree/main/.github/skills/observability-and-instrumentation
Command: npx skills add https://github.com/raishoemi/traffic-sim-v2 --skill observability-and-instrumentation-raishoemi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Production features often ship without telemetry, so when something breaks, engineers cannot tell what happened from the available data. This Skill guides you to instrument code alongside the feature so incidents become queries instead of archaeology. ## Core Features & Use Cases - Question-Driven Instrumentation: Define the on-call questions first, then map structured logs, RED/USE metrics, and OpenTelemetry traces to answer them. - Production-Grade Patterns: Enforces correlation IDs, bounded metric label cardinality, histogram-based latency percentiles, and secret/PII redaction in logs. - Symptom-Based Alerting: Creates actionable alerts tied to user-facing symptoms with runbook links, plus a verification pass that test-fires alerts and traces requests end-to-end. - Use Case: When adding a payment retry flow with an external provider, use this Skill to emit structured payment_failed events, RED metrics on the provider call, and a trace that follows one checkout across services. ## Quick Start Instrument my new checkout endpoint with structured logging, RED metrics, and OpenTelemetry tracing following the observability skill.

Frequently Asked Questions about observability-and-instrumentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
When should I not use this observability skill?

Do not use it to diagnose an active incident; that belongs to a debugging skill, and observability is what makes future debugging fast. It also does not cover performance profiling of measured slowness or launch-day rollback checklists.