observability

Diagnose distributed system issues using PromQL, LogQL, and TraceQL queries.

Updated Nov 19, 2025
One-click install
npx skills add https://github.com/blueswen/observability-with-llm --skill observability-blueswen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability
Source: https://github.com/blueswen/observability-with-llm/tree/main/opentelemetry-demo-app-with-llm/workspace/.claude/skills/observability
Command: npx skills add https://github.com/blueswen/observability-with-llm --skill observability-blueswen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Debugging complex distributed systems is time-consuming and requires expertise in multiple query languages (PromQL, LogQL, TraceQL). This Skill automates the generation and interpretation of these queries, drastically reducing the time and complexity involved in identifying root causes for performance issues, errors, and latency.

Core Features & Use Cases

  • Intelligent Query Construction: Automatically build efficient PromQL, LogQL, and TraceQL queries for metrics, logs, and traces.
  • Multi-Signal Correlation: Correlate data across different observability signals (metrics, logs, traces) to pinpoint issues.
  • Token-Efficient Analysis: Interprets results and provides concise, structured output focused on impact and actionable next steps.
  • Use Case: When a user reports a sudden spike in application errors, use this Skill to automatically query Prometheus for error rates, Loki for specific error messages, and Tempo for problematic traces, then present a consolidated root cause analysis.

Quick Start

Analyze the recent latency spike in the 'checkout' service. Start by checking HTTP server duration metrics, then look for corresponding error logs and slow traces.

Frequently Asked Questions about observability

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

FAQPage Schema
How do I build PromQL, LogQL, and TraceQL queries to debug performance issues?

This Skill automatically constructs PromQL, LogQL, and TraceQL queries to diagnose performance problems in distributed systems. It generates efficient queries for metrics, logs, and traces, then correlates results across signals to pinpoint root causes without requiring manual expertise in each query language.

Can I correlate metrics, logs, and traces to investigate errors in distributed systems?

Yes. Multi-signal correlation is a core feature—the Skill connects metrics from Prometheus, error logs from Loki, and problematic traces from Tempo using trace_id, service.name, and timestamps to build a consolidated root cause analysis across your observability stack.

What's the fastest way to analyze latency spikes and error rates?

Query metrics for error rate trends, retrieve corresponding error logs and slow traces, then correlate findings across signals in one workflow. This Skill automates that progression, reducing investigation time from hours to minutes with token-efficient, structured output.

Do I need to learn PromQL, LogQL, and TraceQL syntax myself?

No. The Skill generates syntactically correct queries automatically, interpreting results and presenting concise, actionable insights. This eliminates the learning curve and lets you focus on diagnosis rather than query construction.

How does this approach differ from querying logs and metrics separately?

Single-signal querying forces manual context-switching and incomplete diagnosis. This Skill correlates metrics, logs, and traces together using shared identifiers, delivering faster root cause analysis and reducing false leads from isolated signals.

What observability data sources does this work with?

The Skill targets Prometheus metrics, Loki logs, and Tempo traces using their native query languages: PromQL, LogQL, and TraceQL. It leverages trace IDs and service names to connect data across all three systems.