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

VariableHow to resolve
AGENT_NAMESPACENamespace where Datadog Agent is installed
APP_NAMESPACENamespace of the application
APP_LABELCheck spec.selector.matchLabels.app in the Deployment manifest
CLUSTER_NAMEspec.global.clusterName in datadog-agent.yaml
SERVICE_NAMEtags.datadoghq.com/service label on the Deployment
ENVtags.datadoghq.com/env label on the Deployment
DD_SITEspec.global.site in datadog-agent.yaml

Prerequisites

Claude runs

bash
pup auth status --site <DD_SITE>

If valid token — proceed.

ERROR: Not authenticated:

Claude runs

bash
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

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

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

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

CheckDetailStatus
Datadog Agent<N> pod(s) Running in <AGENT_NAMESPACE>OK
SSI enabledTargeting namespace <APP_NAMESPACE>, language <LANGUAGE> v<MAJOR_VERSION>OK
Init container injecteddatadog-lib-<language>-init present in pod specOK
Tracer reportingService <SERVICE_NAME> appears in pup apm services list with isTraced: trueOK
APM service visible<SERVICE_NAME> in env <ENV>OK
Traces arriving<N> trace(s) found in the last hourOK
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.

ViewURL
Service overviewhttps://app.<DD_SITE>/apm/services/<SERVICE_NAME>?env=<ENV>
Traces explorerhttps://app.<DD_SITE>/apm/traces?query=service:<SERVICE_NAME>%20env:<ENV>
Service maphttps://app.<DD_SITE>/apm/map?env=<ENV>&service=<SERVICE_NAME>
Agent fleethttps://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 從公開儲存庫中收錄這些內容。

檢舉或申請下架