observability-engineering

Instrument distributed systems with OpenTelemetry and correlate logs, metrics, and traces.

4|Updated Nov 1, 2025
One-click install
npx skills add https://github.com/weirdgme/claude-code-infrastructure-showcase --skill observability-engineering-weirdgme
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability-engineering
Source: https://github.com/weirdgme/claude-code-infrastructure-showcase/tree/main/.claude/skills/observability-engineering
Command: npx skills add https://github.com/weirdgme/claude-code-infrastructure-showcase --skill observability-engineering-weirdgme

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams achieve deep visibility into distributed systems beyond basic monitoring by integrating traces, logs, and metrics and enabling unified observability.

Core Features & Use Cases

  • OpenTelemetry instrumentation for comprehensive tracing
  • Distributed tracing backends (Jaeger, Tempo)
  • Logs aggregation (ELK, Loki) with structured logging
  • Correlation across logs, metrics, and traces using trace IDs
  • Service mesh observability and dashboards

Quick Start

  1. Instrument your application with OpenTelemetry
  2. Set up a tracing backend (Jaeger or Tempo)
  3. Configure logs and dashboards and verify trace correlation

Frequently Asked Questions about observability-engineering

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

FAQPage Schema
How do I correlate logs, metrics, and traces across microservices?

Correlate logs, metrics, and traces by using trace IDs as a common identifier across all three data types. Instrument your applications with OpenTelemetry to generate trace IDs, then propagate those IDs through your logging and metrics pipeline so you can query related events together in dashboards and backends like Jaeger, Tempo, or ELK.

What's the best way to set up distributed tracing for cloud-native systems?

Set up distributed tracing by instrumenting your services with OpenTelemetry, deploying a tracing backend like Jaeger or Tempo to collect spans, and configuring trace sampling to control costs. This approach works across microservices and containerized environments to show request flows and latency bottlenecks.

How do I implement structured logging and aggregation in a distributed system?

Implement structured logging by emitting logs as JSON with consistent fields, then aggregate them using tools like ELK or Loki. Include trace IDs in log entries to link logs to traces, and configure your aggregation backend to parse and index structured fields for searchable, correlated visibility.

Can I use OpenTelemetry with any tracing or logging backend?

Yes, OpenTelemetry is vendor-neutral and supports any compatible tracing backend (Jaeger, Tempo, others) and logging system. This flexibility lets you avoid vendor lock-in and switch tools without re-instrumenting your code.

How do I reduce observability costs while maintaining visibility?

Reduce costs by configuring sampling to collect a representative subset of traces rather than all traces, using cost-optimized storage for logs and metrics, and setting SLO-based alerts to focus on meaningful events. This balances deep visibility with budget constraints across cloud-native deployments.

What observability practices work best for service mesh environments?

In service mesh environments, leverage built-in observability features to collect metrics and traces automatically, use dashboards to visualize service dependencies and latencies, and correlate mesh telemetry with application-level traces to diagnose issues at both network and application layers.