Skill Store 33

Onboarding Summary

Generate a live Single Step Instrumentation (SSI) onboarding confirmation report for Linux hosts…

by datadog-labs · MIT

The skill

Generate a live Single Step Instrumentation (SSI) onboarding confirmation report for Linux hosts — verifies APM instrumentation is working end-to-end with deep links into the Datadog UI. Only use after agent-install and enable-ssi have both completed.

APM Onboarding Summary — Linux Host

Triggers

Invoke this skill when:

  • All steps in verify-ssi have passed
  • All checks in troubleshoot-ssi have been resolved
  • The user asks "is everything working?", "show me the status", or "confirm APM is set up"

Do NOT invoke this skill if any verification or troubleshooting check is still failing — resolve those first.

Context to resolve before acting

Variable How to resolve
HOSTNAME hostname -f on the target host
DD_HOSTNAME Hostname as Datadog sees it — from sudo datadog-agent status
SERVICE_NAME DD_SERVICE value from /proc/<PID>/environ or the systemd unit
ENV DD_ENV value from /proc/<PID>/environ or the systemd unit
DD_SITE grep "^site:" /etc/datadog-agent/datadog.yaml
SSH_KEY Path to SSH private key
SSH_USER SSH username
SSH_HOST Hostname or IP of the target host

Prerequisites

Claude runs

pup auth status --site <DD_SITE>

If valid token — proceed.

ERROR: Not authenticated:

Claude runs

pup auth login --site <DD_SITE>

This opens a browser tab for OAuth. Complete the login there — Claude will continue once the command exits.

Collect live confirmation data

Run all of the following. Each populates a row in the final report.

Claude runs

# Agent version and status
sudo datadog-agent status 2>&1 | grep -E "Agent \(v|Status:|API Keys status"

# Inject library armed in ld.so.preload
ssh -o StrictHostKeyChecking=no -i <SSH_KEY> <SSH_USER>@<SSH_HOST> "cat /etc/ld.so.preload"

# Process confirmed injected — launcher + language library in /proc/<PID>/maps
ssh -o StrictHostKeyChecking=no -i <SSH_KEY> <SSH_USER>@<SSH_HOST> \
  "pgrep -a -f '<SERVICE_NAME>' | head -3"

Use the PID from above:

ssh -o StrictHostKeyChecking=no -i <SSH_KEY> <SSH_USER>@<SSH_HOST> \
  "sudo cat /proc/<PID>/maps | grep -E 'launcher|apm-library|datadog'"

# UST vars in process environment
ssh -o StrictHostKeyChecking=no -i <SSH_KEY> <SSH_USER>@<SSH_HOST> \
  "sudo cat /proc/<PID>/environ | tr '\0' '\n' | grep -E 'DD_SERVICE|DD_ENV|DD_VERSION'"

# Agent APM receiver — trace counts
ssh -o StrictHostKeyChecking=no -i <SSH_KEY> <SSH_USER>@<SSH_HOST> \
  "sudo datadog-agent status 2>&1 | grep -A 10 'Receiver (previous minute)'"

# Service visible and traced in APM backend
DD_SITE=<DD_SITE> pup apm services list --env <ENV> --from 1h

# Traces arriving in the last hour
DD_SITE=<DD_SITE> pup traces search --query "service:<SERVICE_NAME>" --from 1h --limit 5

Only if DSM was enabled via enable-dsm:

# DSM pipeline data for the service
DD_SITE=<DD_SITE> pup metrics query \
  --query "avg:data_streams.latency{service:<SERVICE_NAME>,env:<ENV>} by {pathway_type}" \
  --from 15m --to now

Present the report

Fill in every value from live command output. Do not leave any placeholder unfilled. If a value cannot be confirmed, mark that row as failed and link to troubleshoot-ssi.

APM onboarding complete

Check Detail Status
Datadog Agent v<VERSION> running on <HOSTNAME>, API key valid OK
SSI armed /etc/ld.so.preload contains launcher path OK
Process injected launcher + language library in /proc/<PID>/maps for <SERVICE_NAME> OK
Unified Service Tags DD_SERVICE=<SERVICE_NAME> DD_ENV=<ENV> DD_VERSION=<VERSION> OK
Agent receiving traces <N> trace(s)/min in APM receiver OK
APM service visible <SERVICE_NAME> in env <ENV> OK
Traces arriving <N> trace(s) found in the last hour OK
Data Streams (only if enabled) data_streams.latency series for <SERVICE_NAME>, or "pending first message" OK

Your service in Datadog — click to open:

Construct each URL by substituting real values. Do not print placeholder URLs.

View URL
Service overview https://app.<DD_SITE>/apm/services/<SERVICE_NAME>?env=<ENV>
Traces explorer https://app.<DD_SITE>/apm/traces?query=service:<SERVICE_NAME>%20env:<ENV>
Service map https://app.<DD_SITE>/apm/map?env=<ENV>&service=<SERVICE_NAME>
Infrastructure host https://app.<DD_SITE>/infrastructure?q=host:<HOSTNAME>
Agent fleet https://app.<DD_SITE>/fleet-automation
Data Streams (only if enabled) https://app.<DD_SITE>/data-streams

Security constraints

  • Never write a raw API key into any file or chat message

Use this skill

Connect your agent to the Skill Store MCP server and ask for it by ref: datadog-labs/onboarding-summary-20823114061.

Download SKILL.md · Markdown version

Details

Publisher
datadog-labs
Category
Software Development › DevOps & cloud
License
MIT
Updated
2026-10-15

References

More from datadog-labs

Related skills

  • Verify Ssi Verify Single Step Instrumentation (SSI) is working end-to-end on Linux hosts — SSI automatically…
  • Enable Ssi Configure Unified Service Tags and verify Single Step Instrumentation (SSI) injection on Linux ho…
  • Troubleshoot Ssi Diagnose and fix Single Step Instrumentation (SSI) issues on Linux hosts — SSI automatically inst…
  • Agent Install Install the Datadog Agent on Linux hosts via SSH with Single Step Instrumentation (SSI) enabled —…
  • Docker MCP Catalog Run signed MCP servers in isolated containers