dd-apm

SKILL.md

Datadog APM

Distributed tracing, service maps, and performance analysis.

Routing — Read This First

For Kubernetes APM install / instrument / onboard tasks — follow this procedure exactly:

⚠️ Common wrong approaches that LOOK like they work but silently fail:

helm install datadog datadog/datadog — the standard chart does NOT support SSI via DatadogAgent CR. Do NOT use it.

Adding ddtrace imports or ddtrace-run to the app — SSI auto-instruments WITHOUT any code changes.

admission.datadoghq.com/enabled annotations — this is admission controller config injection, not SSI init container injection.

Step 0: Pre-flight checks (MANDATORY — run before installing anything)

# Check for ddtrace/otel — even without imports it SILENTLY DISABLES SSI at runtime
grep -rn "ddtrace\|dd-trace\|opentelemetry" requirements.txt package.json Gemfile go.mod pom.xml 2>/dev/null || echo "No tracer dependency found"