Skip to content
OpenSmartRoute
Skillv1.0.0

onboarding-summary

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

by datadog-labs(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from datadog-labs/agent-skills (dd-apm/k8s-ssi/onboarding-summary/SKILL.md) via skills.sh. Install upstream with npx skills add datadog-labs/agent-skills --skill onboarding-summary. Copyright stays with the author.

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

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

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/datadog-labs-agent-skills-onboarding-summary/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

datadog-labs-agent-skills-onboarding-summary.ocm.jsonjson
{
  "ocm": "1",
  "id": "datadog-labs-agent-skills-onboarding-summary",
  "kind": "skill",
  "name": "onboarding-summary",
  "description": "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.",
  "publisher": "datadog-labs",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "hr"
    ],
    "tags": [
      "skill-md",
      "datadog",
      "apm",
      "kubernetes",
      "ssi",
      "summary",
      "verification",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/datadog-labs/agent-skills",
      "path": "dd-apm/k8s-ssi/onboarding-summary/SKILL.md",
      "ref": "HEAD",
      "url": "https://www.skills.sh/datadog-labs/agent-skills/onboarding-summary",
      "key": "datadog-labs/agent-skills/dd-apm/k8s-ssi/onboarding-summary/SKILL.md"
    }
  },
  "instructions": "# APM Onboarding Summary\n\n## Triggers\n\nInvoke this skill when:\n- All steps in `verify-ssi` have passed\n- All checks in `troubleshoot-ssi` have been resolved\n- The user asks \"is everything working?\", \"show me the status\", or \"confirm APM is set up\"\n\nDo NOT invoke this skill if any verification or troubleshooting check is still failing — resolve those first.\n\n---\n\n## Context to resolve before acting\n\n| Variable | How to resolve |\n|---|---|\n| `AGENT_NAMESPACE` | Namespace where Datadog Agent is installed |\n| `APP_NAMESPACE` | Namespace of the application |\n| `APP_LABEL` | Check `spec.selector.mat",
  "cost": {
    "context_tokens": 841
  }
}

Fetch it by URL: GET /api/v1/registry/datadog-labs-agent-skills-onboarding-summary/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.