gabrielmoreira APM Onboarding Summary
Triggers
Invoke this skill when:
- All steps in
verify-ssihave passed - All checks in
troubleshoot-ssihave 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
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 pod count and status
kubectl get pods -n <AGENT_NAMESPACE> \
-l app.kubernetes.io/component=agent \
--no-headers
# SSI instrumentation config live in cluster
kubectl get datadogagent datadog -n <AGENT_NAMESPACE> \
-o jsonpath='{.spec.features.apm.instrumentation}'
# Init container confirmed in app pod spec
kubectl get pod -l app=<APP_LABEL> -n <APP_NAMESPACE> \
-o jsonpath='{.items[0].spec.initContainers[*].name}'
# Service visible and traced in APM
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
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 |
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 |
Security constraints
- Never write a raw API key into any file or chat message