debug-missing-spans

Diagnose missing OpenTelemetry spans by inspecting SDK initialization, sampling, exporter, and network connectivity.

7|3|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/jagreehal/autotel --skill debug-missing-spans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-missing-spans
Source: https://github.com/jagreehal/autotel/tree/main/packages/autotel/skills/debug-missing-spans
Command: npx skills add https://github.com/jagreehal/autotel --skill debug-missing-spans

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers identify why expected OpenTelemetry traces are not reaching the backend, enabling rapid diagnosis of configuration or network issues.

Core Features & Use Cases

  • Chain Diagnostics: Walks through the entire span chain from code to backend ingestion with concrete tests.
  • Runtime Checks: Verifies SDK initialization, sampling configuration, exporter status, and network connectivity.
  • Use Case: When spans are missing remotely, use this Skill to pinpoint the faulty component or misconfiguration causing data loss.

Quick Start

Use the debug-missing-spans skill to walk through the troubleshooting steps for your OpenTelemetry setup and identify the root cause of missing spans.

Frequently Asked Questions about debug-missing-spans

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

FAQPage Schema
Why are my OpenTelemetry spans missing in the backend?

Missing OpenTelemetry spans usually result from misconfigurations in SDK initialization, sampling, exporter setup, or network connectivity. You diagnose the issue by systematically checking each component from code to backend ingestion.

How do I troubleshoot missing distributed tracing data?

To troubleshoot missing distributed tracing data, walk through the entire span chain from code to backend ingestion. Run concrete tests to verify SDK initialization, sampling configuration, exporter status, and network connectivity.

What is the best way to debug OpenTelemetry exporter configuration?

The best way to debug OpenTelemetry exporter configuration is to verify the exporter status and network connectivity. This isolates whether data loss occurs during transmission or at the backend ingestion stage.

How does sampling configuration affect OpenTelemetry traces?

Sampling configuration affects OpenTelemetry traces by determining which spans are exported to the backend. Incorrect sampling settings can drop spans before they reach the exporter, causing expected traces to disappear.

Can I diagnose OpenTelemetry SDK initialization errors without a backend?

You can diagnose OpenTelemetry SDK initialization errors locally by verifying the runtime setup. Checking SDK initialization isolates code-level configuration issues from downstream network or backend ingestion problems.