observability-telemetry

Design OpenTelemetry instrumentation, structured logging, distributed tracing, and SLO alert rules.

1|Updated Jun 29, 2026
One-click install
npx skills add https://github.com/coreyone/software-maestro --skill observability-telemetry-coreyone
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: observability-telemetry
Source: https://github.com/coreyone/software-maestro/tree/main/quality/observability-telemetry
Command: npx skills add https://github.com/coreyone/software-maestro --skill observability-telemetry-coreyone

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Systems without proper telemetry are impossible to debug or optimize, leaving teams blind to latency issues, errors, and reliability degradation until users complain. ## Core Features & Use Cases - Structured Logging Design: Replaces unstructured string logs with high-cardinality JSON events containing trace_id, span_id, and contextual fields. - Distributed Tracing: Implements OpenTelemetry with W3C traceparent header propagation across HTTP and gRPC boundaries. - SLO & Burn-Rate Alerting: Defines user-centric SLIs, SLO targets, and multi-window error budget burn rate alerts to reduce pager fatigue. - Use Case: Instrument a microservices payment API so every request emits structured JSON logs linked by trace context, with alerts firing only when the 99.9% availability error budget burns too fast. ## Quick Start Ask the agent to design an OpenTelemetry tracing and structured JSON logging architecture with SLO burn-rate alerts for your service.

Frequently Asked Questions about observability-telemetry

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

FAQPage Schema
How do I set up OpenTelemetry distributed tracing across microservices?▼

OpenTelemetry tracing propagates the W3C traceparent header (version-trace_id-parent_id-trace_flags) across all HTTP and gRPC boundaries. Each service parses incoming headers, starts child spans, and injects the context into outbound requests so the full request lifecycle appears as one trace.

What is the difference between structured logging and plain text logs?▼

Structured logging emits JSON events with high-cardinality fields like user_id, order_id, and trace_id instead of concatenated strings. This enables ad-hoc querying across arbitrary tags in backends like Honeycomb or Datadog, unlike flat text logs that require manual parsing.

How do SLO burn rate alerts reduce pager fatigue?▼

Burn rate alerts fire only when the error budget consumption speed indicates imminent SLO violation, such as a 14.4x burn over 1 hour. This avoids alerting on transient spikes or symptom thresholds like CPU usage that do not affect users.

Does this work with my existing Datadog or Sentry setup?▼

Yes, the skill detects the project's existing telemetry stack such as Datadog, Sentry, Winston, or Bunyan and applies observability principles to those tools. It explicitly never forces migration to a different platform.

When should I not use observability instrumentation?▼

This skill is not suited for database index tuning, auth configuration, or layout adjustments. Core web performance optimization tasks are routed to a dedicated performance skill instead.