tempo-troubleshoot

Community

Debug distributed traces with precise TraceQL.

Authortimbuchinger
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill simplifies the complex task of troubleshooting distributed traces and crafting effective TraceQL queries in Grafana Tempo. It helps you quickly identify latency, errors, and bottlenecks across your services.

Core Features & Use Cases

  • Efficient TraceQL Query Building: Guides in constructing precise TraceQL queries to filter traces by service, status, duration, and other attributes.
  • Distributed Trace Debugging: Helps you navigate and understand complex distributed traces for request-level root cause analysis.
  • Log & Metric Correlation: Provides best practices for linking traces with relevant logs (Loki) and metrics (Mimir) for a holistic view.
  • Use Case: You're investigating a slow API response. This Skill helps you craft a TraceQL query to find all traces for the 'payments' service that took longer than 1 second, allowing you to pinpoint the exact span causing the delay.

Quick Start

Craft a TraceQL query to find all error traces in the 'payments' service from the last 15 minutes, filtering by service name.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: tempo-troubleshoot
Download link: https://github.com/timbuchinger/loadout/archive/main.zip#tempo-troubleshoot

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository