skills.rest
datadog-labs
datadog-labsOFFICIAL
Explore all skills by this author →
Website𝕏@datadoghqGitHub

troubleshoot-ssi

Diagnose and fix SSI issues on Linux hosts with pup and SSH.

150|23|Updated Feb 3, 2026
Search Tags:#troubleshooting#instrumentation#linux#datadog#apm#ssi
One-click install
npx skills add https://github.com/datadog-labs/agent-skills --skill troubleshoot-ssi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: troubleshoot-ssi
Source: https://github.com/datadog-labs/agent-skills/tree/main/dd-apm/linux-ssi/troubleshoot-ssi
Command: npx skills add https://github.com/datadog-labs/agent-skills --skill troubleshoot-ssi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose and fix Single Step Instrumentation (SSI) issues on Linux hosts when traces are missing or instrumentation is not functioning, enabling quicker restoration of observability.

Core Features & Use Cases

  • Triage SSI problems using pup to verify injection status, service config, and trace availability.
  • Guide SSH-based investigations to inspect ld.so.preload, tracer libraries, and agent status.
  • Propose remediation paths, including package reinstallation and service restarts with user-confirmed safeguards.

Quick Start

Provide a concise, actionable triage plan for diagnosing SSI issues on a Linux host.

Frequently Asked Questions about troubleshoot-ssi

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

FAQPage Schema
How do I troubleshoot missing Datadog APM traces on Linux hosts?▼

To troubleshoot missing Datadog APM traces, use this Skill to triage Single Step Instrumentation (SSI) issues by verifying injection status, checking tracer configs, and inspecting runtime libraries via SSH.

How do I verify SSI injection status during Datadog instrumentation triage?▼

Verify SSI injection status by using the pup tool to check trace presence, service configuration, and injection health, followed by SSH-based inspections of ld.so.preload and agent status on the Linux host.

What is the remediation process for failing Datadog SSI instrumentation?▼

Remediation for failing Datadog SSI instrumentation involves a structured workflow that guides package reinstallation and safelisted service restarts, requiring explicit user confirmation before executing any changes.

How do I inspect ld.so.preload for Datadog tracer issues on Linux?▼

Inspect ld.so.preload by running SSH-based investigations on the Linux host to verify the tracer libraries, check runtime dependencies, and confirm the Datadog agent status.

Why are traces missing after Datadog Single Step Instrumentation on Linux?▼

Traces are missing after Datadog SSI due to injection failures, incorrect tracer config, or runtime library issues, which can be diagnosed by inspecting ld.so.preload and agent status via SSH.

Related Skills

Explore More Software Engineering Skills→
datadog-labsdatadog-labs
150

onboarding-summary

Generate a live SSI onboarding confirmation report for Linux hosts.

Official
Advanced
datadog-labsdatadog-labs
150

verify-ssi

Verify Single Step Instrumentation injection and trace reception on Linux hosts.

Official
Intermediate
steipetesteipete
385.7k

clawdis-nodes

Discover Clawdis nodes and check their connection status.

Community
Basic
ClawLink-HQClawLink-HQ
117

datadog-monitoring

Automate monitoring and inspection of Datadog resources via ClawLink.

Official
Advanced