Onboarding Summary

by datadog-labs5b40c73824ecNo license177 starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated today

Generate a live Single Step Instrumentation (SSI) onboarding confirmation report — 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 successfully.

Instructions onlyDevOps & Cloud

AI-generated overview

Verifies Datadog APM Single Step Instrumentation onboarding and produces a confirmation report with UI links.

What it does: This skill collects live confirmation data about a Datadog APM Single Step Instrumentation setup, including agent pod status, SSI configuration, injected init containers, APM service visibility, and recent traces. It then presents a filled-in onboarding report table with per-check statuses and Datadog UI deep links for the service, traces, service map, agent fleet, and optionally Data Streams. It is intended to run only after installation, SSI enablement, verification, and troubleshooting steps have all succeeded.
When to use it: Use it when the user asks whether APM is working, wants a status summary, or asks to confirm that APM is set up. It applies after agent installation and SSI enablement are complete and all verification and troubleshooting checks have passed.
Requirements: Requires kubectl access to the relevant Kubernetes clusters and the pup CLI authenticated to the Datadog site, plus resolved context values such as namespaces, app label, cluster name, service name, environment, and Datadog site. It ships no scripts; it is instructions only.

APM Onboarding Summary

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
`AGENT_NAMESPACE`	Namespace where Datadog Agent is installed
`APP_NAMESPACE`	Namespace of the application
`APP_LABEL`	Check `spec.selector.matchLabels.app` in the Deployment manifest
`CLUSTER_NAME`	`spec.global.clusterName` in `datadog-agent.yaml`
`SERVICE_NAME`	`tags.datadoghq.com/service` label on the Deployment
`ENV`	`tags.datadoghq.com/env` label on the Deployment
`DD_SITE`	`spec.global.site` in `datadog-agent.yaml`

Prerequisites

Claude runs

If valid token — proceed.

ERROR: Not authenticated:

Claude runs

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

bash

# Agent pod count and statuskubectl get pods -n <AGENT_NAMESPACE> \  -l app.kubernetes.io/component=agent \  --no-headers
# SSI instrumentation config live in clusterkubectl get datadogagent datadog -n <AGENT_NAMESPACE> \  -o jsonpath='{.spec.features.apm.instrumentation}'
# Init container confirmed in app pod speckubectl get pod -l app=<APP_LABEL> -n <APP_NAMESPACE> \  -o jsonpath='{.items[0].spec.initContainers[*].name}'
# Service visible and traced in APMDD_SITE=<DD_SITE> pup apm services list --env <ENV> --from 1h
# Traces arriving in the last hourDD_SITE=<DD_SITE> pup traces search --query "service:<SERVICE_NAME>" --from 1h --limit 5

# Agent pod count and statuskubectl get pods -n <AGENT_NAMESPACE> \  -l app.kubernetes.io/component=agent \  --no-headers
# SSI instrumentation config live in clusterkubectl get datadogagent datadog -n <AGENT_NAMESPACE> \  -o jsonpath='{.spec.features.apm.instrumentation}'
# Init container confirmed in app pod speckubectl get pod -l app=<APP_LABEL> -n <APP_NAMESPACE> \  -o jsonpath='{.items[0].spec.initContainers[*].name}'
# Service visible and traced in APMDD_SITE=<DD_SITE> pup apm services list --env <ENV> --from 1h
# Traces arriving in the last hourDD_SITE=<DD_SITE> pup traces search --query "service:<SERVICE_NAME>" --from 1h --limit 5

Only if DSM was enabled via enable-dsm:

bash

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

# DSM pipeline data for the serviceDD_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	`<N>` pod(s) Running in `<AGENT_NAMESPACE>`	OK
SSI enabled	Targeting namespace `<APP_NAMESPACE>`, language `<LANGUAGE>` v`<MAJOR_VERSION>`	OK
Init container injected	`datadog-lib-<language>-init` present in pod spec	OK
Tracer reporting	Service `<SERVICE_NAME>` appears in `pup apm services list` with `isTraced: true`	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>`
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

Source and attribution

Source:datadog-labs/agent-skillsindd-apm/k8s-ssi/onboarding-summaryat commit5b40c73

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Onboarding Summary

APM Onboarding Summary

Triggers

Context to resolve before acting

Prerequisites

Claude runs

Claude runs

Collect live confirmation data

Claude runs

Present the report

Security constraints

Source and attribution

More from datadog-labs/agent-skills

Upgrade Browser Sdk V7

Upgrade Browser Sdk V6

Dd Audit Security Investigation

Upgrade Browser Sdk V5

Dd Audit Key Compromise

Dd Audit Cost Spike Investigation

More in DevOps & Cloud

Playwright Devops

M5 Onboard

Yeet

Runbook

Incident Response

Deploy Checklist