distributed-tracing

Analyzes Jaeger distributed traces to identify latency bottlenecks and error origins across microservices.

3|1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/LiboMa/agenticops-chat --skill distributed-tracing-liboma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: distributed-tracing
Source: https://github.com/LiboMa/agenticops-chat/tree/main/skills/distributed-tracing
Command: npx skills add https://github.com/LiboMa/agenticops-chat --skill distributed-tracing-liboma

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? When an alert fires on one microservice, the actual root cause often lives several hops downstream. Manually correlating traces, spans, and service dependencies in Jaeger is slow and error-prone, especially during cascading failures where the alerting service is only a symptom. ## Core Features & Use Cases - Trace Querying: Four tools (query_traces, get_trace_detail, get_service_dependencies, find_error_traces) to list traces, inspect full span trees, map service call graphs, and group error traces by origin service. - Guided Investigation Decision Trees: Step-by-step workflows for service degradation, intermittent failures, and unknown dependency failures, with span-tree interpretation rules (slowest span, error propagation, fan-out patterns). - Confidence Scoring: Structured evidence scoring that boosts root-cause confidence when traces show clear bottlenecks, repeated error origins, and metric correlation. - Use Case: An alert fires for high error rate on frontend. The skill maps dependencies, finds slow traces, drills into the span tree, and reveals redis-cart as the 4.2s bottleneck — not the frontend itself. ## Quick Start Ask the agent to investigate why the frontend service has high latency by analyzing recent Jaeger traces and identifying the root cause service.

Frequently Asked Questions about distributed-tracing

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

FAQPage Schema
How do I find the root cause of latency in microservices using Jaeger?▼

Query slow traces for the alerting service, then inspect the full span tree with get_trace_detail. The span consuming over 80% of the parent duration is the bottleneck, and the deepest slow span typically marks the root cause service.

How to trace cascading failures across multiple services?▼

Start with get_service_dependencies to map the call graph, then use find_error_traces to group errors by origin service. Drill into an error trace's span tree and fix the deepest service showing ERROR tags, not the alerting service.

When should I use distributed tracing versus metrics or logs?▼

Use tracing for cross-service issues like latency spikes, cascading failures, and intermittent errors where the origin is unclear. Skip it for single-service problems like pod OOM or infrastructure issues like VPC routing, where metrics and kubectl checks suffice.

What do error tags in Jaeger spans mean?▼

Jaeger marks failing spans with the error=true tag, supplemented by http.status_code (500, 503, 504) and OpenTelemetry fields otel.status_code and otel.status_description. An error on a leaf span indicates a single failure point, while errors propagating up the tree indicate cascading failure.

Why do some requests fail intermittently while others succeed?▼

Compare successful and failed traces for the same service to spot differences in path or downstream calls. Common causes include load balancers routing to unhealthy backends, connection pool exhaustion, and retry storms amplifying downstream overload.