Onboarding Summary

作者 datadog-labs5b40c73824ec无许可证177 个星标收录于 2026年10月8日更新于 2026年10月8日仓库今天更新

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.

仅含说明DevOps & Cloud

AI 生成的概览

验证 Datadog APM 单步插桩（SSI）接入情况，并生成带 UI 链接的确认报告。

功能: 该技能收集 Datadog APM 单步插桩配置的实时确认数据，包括 Agent Pod 状态、SSI 配置、注入的 init 容器、APM 服务可见性和近期链路追踪。随后它会生成一份填写完整的接入报告表格，列出各项检查状态，并提供服务、链路、服务地图、Agent 集群以及可选 Data Streams 的 Datadog UI 深层链接。它仅应在安装、启用 SSI、验证和故障排查步骤全部成功后运行。
适用场景: 当用户询问 APM 是否正常工作、想要状态摘要，或要求确认 APM 已配置完成时使用。它适用于 Agent 安装和 SSI 启用已完成，且所有验证与故障排查检查均已通过之后。
运行要求: 需要对相关 Kubernetes 集群的 kubectl 访问权限，以及已登录到对应 Datadog 站点的 pup CLI，还需要解析出命名空间、应用标签、集群名称、服务名称、环境和 Datadog 站点等上下文值。该技能不附带脚本，仅为指令。

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

来源与署名

来源：datadog-labs/agent-skills位于dd-apm/k8s-ssi/onboarding-summary提交5b40c73

许可证：无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

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

来源与署名

更多来自 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

更多DevOps & Cloud技能

Playwright Devops

M5 Onboard

Yeet

Runbook

Incident Response

Deploy Checklist