tsuga-debug-missing-trace-propagation

Diagnose missing trace propagation across HTTP, gRPC, and async messaging.

2|Updated May 28, 2026
One-click install
npx skills add https://github.com/tsuga-dev/agent-plugins --skill tsuga-debug-missing-trace-propagation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tsuga-debug-missing-trace-propagation
Source: https://github.com/tsuga-dev/agent-plugins/tree/main/plugins/telemetry/skills/tsuga-debug-missing-trace-propagation
Command: npx skills add https://github.com/tsuga-dev/agent-plugins --skill tsuga-debug-missing-trace-propagation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you diagnose why distributed traces fail to connect across services, resulting in missing parent/child span relationships, orphaned spans, or multiple unrelated trace IDs for the same request.

Core Features & Use Cases

  • Trace parenting diagnosis: Determines whether callee spans are missing parentSpanId, have a wrong trace, or correctly link back to caller spans.
  • Propagation boundary checks: Validates whether HTTP/gRPC/messaging boundaries correctly inject and extract trace context (including transport-specific interceptor and header/attribute handling).
  • Root-cause oriented remediation guidance: Recommends the minimal code/config change for the identified language and transport and provides a verification loop using Tsuga span searches.
  • Use Case: When a request enters Service A and triggers Service B via HTTP/gRPC/queues, but Service B’s spans appear unlinked, this Skill guides you through finding the missing propagation point and correcting it.

Quick Start

Use this skill to investigate a suspected trace propagation break between a caller and callee service by specifying both service names, the transport type, and the languages of the caller and callee.

Frequently Asked Questions about tsuga-debug-missing-trace-propagation

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

FAQPage Schema
Why does my distributed tracing show multiple trace IDs for a single request across services?

Missing trace propagation causes parent/child span relationships to break across service boundaries, resulting in multiple trace IDs for a single request. This Skill diagnoses extraction or injection failures across HTTP, gRPC, and messaging transports to identify where context linking fails.

How do I fix null parent span IDs in OpenTelemetry when calling another service?

Fixing null parent span IDs requires validating trace context propagation at the transport boundary. This Skill checks whether your caller and callee languages correctly inject and extract trace context via transport-specific interceptors and headers to restore span parenting.

Does this trace propagation fix guidance work for both gRPC and HTTP requests?

Yes, the trace propagation diagnosis supports HTTP, gRPC, and asynchronous messaging scenarios. It applies transport-specific interceptor and header checks to ensure trace context is correctly propagated and linked across caller and callee services regardless of protocol.

How do I verify that my distributed trace spans are correctly linked after a propagation fix?

You verify distributed trace span linking by running a Tsuga span search to confirm parent/child relationships are established. This Skill provides a verification loop to ensure the caller and callee spans correctly connect under a single trace ID after applying the recommended code fixes.

What information do I need to diagnose a broken distributed trace across two microservices?

To diagnose a broken distributed trace across microservices, you need the caller and callee service names, the transport type connecting them, and the programming languages of both services. This information drives the transport-specific and language-specific propagation fix guidance provided by the Skill.