Dd Apm

datadog-labs/agent-skills/dd-apm

作者 datadog-labs5b40c73824ec無授權條款177 個星標收錄於 2026年10月8日更新於 2026年10月8日儲存庫今天更新

APM - install, onboard, instrument, enable, set up, configure, traces, services, dependencies, performance analysis, Data Streams Monitoring (DSM), queue lag, pipeline latency. Use for any request involving Datadog APM setup, instrumentation (SSI, ddtrace, agent install), or analysis.

僅含說明DevOps & CloudData & Analytics
AI 產生的概覽

指導 Datadog APM 的安裝、插樁、服務重新對應與資料流監控，並提供追蹤與服務分析。

功能
此技能會將 Datadog APM 請求導向對應的子技能，涵蓋 Kubernetes 或 Linux 主機插樁、服務重新命名或資料流監控。它也記錄了列出服務、檢視服務地圖、搜尋追蹤以及查詢關鍵 APM 指標和 SLO 的指令。其中包含疑難排解指引和常用查詢模式。
適用情境
適用於涉及 Datadog APM 安裝、導入或插樁的請求，包括 SSI、ddtrace 和代理程式設定。也適用於服務重新命名、佇列或管線延遲監控，以及追蹤或服務效能分析。
執行需求
需要安裝並驗證 Datadog Labs Pup，並具備 Datadog 環境存取權限。此技能僅為說明文件，不附帶指令碼。

Datadog APM

Distributed tracing, service maps, and performance analysis.

Routing — Read This First

Match the user's request to one of the entries below. Each entry has the same shape: triggers → which sub-skill to load → the anti-pattern to avoid. If a request seems to fit more than one entry, see "Overlap disambiguation". If nothing matches, see "None of the above" at the end.

Kubernetes APM install / instrument / onboard — trigger when the user mentions Kubernetes, K8s, EKS, GKE, AKS, kind, minikube, K3s, helm, DatadogAgent CR, kubectl, SSI on a cluster, pod injection, or init containers.

Immediately read .claude/skills/dd-apm/k8s-ssi/agent-install/SKILL.md now, then .claude/skills/dd-apm/k8s-ssi/enable-ssi/SKILL.md, then .claude/skills/dd-apm/k8s-ssi/verify-ssi/SKILL.md — do not proceed from memory.

Common wrong approaches that LOOK like they work but silently fail:

  • helm install datadog datadog/datadog — the standard chart does NOT support SSI via DatadogAgent CR.
  • Adding ddtrace imports or ddtrace-run to the app — SSI auto-instruments WITHOUT any code changes.
  • admission.datadoghq.com/enabled annotations — that's admission controller config injection, not SSI init container injection.

Linux APM install / instrument / onboard — trigger when the user mentions a single host, VM, EC2 instance, bare-metal, RHEL/Ubuntu/Debian, systemd, or no orchestrator.

Immediately read .claude/skills/dd-apm/linux-ssi/agent-install/SKILL.md now, then .claude/skills/dd-apm/linux-ssi/enable-ssi/SKILL.md, then .claude/skills/dd-apm/linux-ssi/verify-ssi/SKILL.md — do not proceed from memory.

Do NOT install the agent via plain apt-get install datadog-agent (or yum equivalent) and assume SSI follows — host auto-instrumentation requires the install script with the SSI flags, which the sub-skill walks through.

Service rename / service remapping — trigger when the user mentions renaming a service, collapsing multiple service names, stripping suffixes/prefixes, or cleaning up inferred services.

Immediately read .claude/skills/dd-apm/service-remapping/SKILL.md now — do not proceed from memory.

Do NOT change tags.datadoghq.com/service labels or DD_SERVICE env vars to rename a service in Datadog. That requires a rollout and only affects new data. Use a service remapping rule — it rewrites the name at ingestion time with no deployment change.

Data Streams Monitoring (DSM) / queue and pipeline monitoring: trigger when the user mentions data streams, DSM, consumer or queue lag, pipeline latency, end-to-end latency across queues, or monitoring Kafka / RabbitMQ / SQS / SNS / Kinesis / Pub/Sub flows between services.

Immediately read .claude/skills/dd-apm/enable-dsm/SKILL.md now. Do not proceed from memory.

Do NOT install a separate DSM agent, package, or library. DSM runs in the Datadog SDK that APM already injected and is enabled with one setting per service. Do NOT enable it without first telling the user it is included with APM Pro and Enterprise and billed separately on base APM.

Overlap disambiguation

When a request could plausibly fit more than one entry above, use these tiebreakers:

HintRoute to
Cluster orchestrator mentioned (EKS/GKE/AKS/kind/K3s/minikube) — even if "just one node"k8s-ssi
Single host, VM, or EC2 with no orchestratorlinux-ssi
"Several services that should be one"service-remapping — the sub-skill picks the rule type based on whether the duplicates are real instrumented services or inferred entities (DBs, queues, external APIs)
"My service shows under the wrong name"First check DD_SERVICE on the deploy. If correct and the name is still wrong → service-remapping.
"Monitor Kafka" / "monitor my queues"Ask whether they mean broker/cluster health (Kafka Console, an Agent check: https://docs.datadoghq.com/data_streams/kafka/setup/) or message flow between their services (enable-dsm)
"Reduce APM volume / cost / noise"No sub-skill yet. Ask whether the user means sampling (fewer ingested traces) or retention filters (less indexed data) before suggesting commands.

None of the above

If the request doesn't match any entry above, continue reading the trace-search, service analysis, and metrics content below. If even that doesn't fit, ask the user to clarify — do not invent a workflow.

Requirements

Datadog Labs Pup should be installed. See Setup Pup if not.

Command Execution Order (Token-Efficient)

For scoped commands, use this order:

  1. Check context first (prior outputs, conversation, saved values).
  2. If a required value is missing, run a discovery command first.
  3. If still ambiguous, ask the user to confirm.
  4. Then run the target command.
  5. Avoid speculative commands likely to fail.

Quick Start

bash
pup auth login# Confirm env tag with the user first (do not assume production/prod/prd).pup apm services list --env <env> --from 1h --to nowpup traces search --query "service:api-gateway" --from 1h

Services

List Services

bash
pup apm services list --env <env> --from 1h --to nowpup apm services stats --env <env> --from 1h --to now

Service Stats

bash
pup apm services stats --env <env> --from 1h --to now

Service Map

bash
# View dependenciespup apm flow-map --query "service:api-gateway&from=$(($(date +%s)-3600))000&to=$(date +%s)000" --env <env> --limit 10

Traces

Search Traces

bash
# By servicepup traces search --query "service:api-gateway" --from 1h
# Errors onlypup traces search --query "service:api-gateway status:error" --from 1h
# Slow traces (>1s)pup traces search --query "service:api-gateway @duration:>1000ms" --from 1h
# With specific tagpup traces search --query "service:api-gateway @http.url:/api/users" --from 1h

Trace Detail

bash
# No direct get command for a single trace ID.# Use traces search with a narrow query and time window.pup traces search --query "trace_id:<trace_id>" --from 1h

Key Metrics

MetricWhat It Measures
trace.http.request.hitsRequest count
trace.http.request.durationLatency
trace.http.request.errorsError count
trace.http.request.apdexUser satisfaction

Service Level Objectives

Link APM to SLOs:

bash
pup slos create --file slo.json

Common Queries

GoalQuery
Slowest endpointsavg:trace.http.request.duration{*} by {resource_name}
Error ratesum:trace.http.request.errors{*} / sum:trace.http.request.hits{*}
Throughputsum:trace.http.request.hits{*}.as_rate()

Troubleshooting

ProblemFix
No tracesCheck ddtrace installed, DD_TRACE_ENABLED=true
Missing serviceVerify DD_SERVICE env var
Traces not linkedCheck trace headers propagated
High cardinalityDon't tag with user_id/request_id

References/Docs

來源與署名

來源：datadog-labs/agent-skills位於dd-apm提交5b40c73

授權條款： 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 datadog-labs/agent-skills 的技能

Upgrade Browser Sdk V7

datadog-labs

指導將 Datadog Browser SDK 從 v6 逐步升級至 v7，涵蓋已移除選項、變更的 API 與基礎架構更新。

Software Development177今天更新

Upgrade Browser Sdk V6

datadog-labs

指導將 Datadog Browser SDK 從 v5 升級至 v6，涵蓋已移除選項、預設值變更與基礎架構更新。

Software Development177今天更新

Dd Audit Security Investigation

datadog-labs

使用 pup audit-logs 查詢 Datadog Audit Trail 記錄，回答安全調查問題。

Security177今天更新

Upgrade Browser Sdk V5

datadog-labs

指導將 Datadog Browser SDK 從 v4 升級至 v5，涵蓋重新命名的選項、API、預設值與基礎架構變更。

Software Development177今天更新

Dd Audit Key Compromise

datadog-labs

透過稽核記錄調查可能外洩的 Datadog API 金鑰：時間軸、地理位置/IP 來源、呼叫端點、異常訊號與處置建議。

Security177今天更新

Dd Audit Cost Spike Investigation

datadog-labs

將 Datadog 用量計量資料與 Audit Trail 設定變更相互關聯，以解釋成本或用量暴增。

DevOps & Cloud177今天更新

更多DevOps & Cloud技能

Playwright Devops

microsoft

精選

Playwright 的 DevOps 工作流程：分析 main 分支最新提交的 GitHub Actions 失敗並下載失敗作業日誌。

包含腳本
DevOps & Cloud97K今天更新

M5 Onboard

anthropics

精選

透過 USB 偵測 M5Stack ESP32 開發板，燒錄 UIFlow 2.0 韌體並安裝 MicroPython 應用程式套件。

DevOps & Cloud37K今天更新

Yeet

openai

精選

使用 GitHub CLI 一次完成暫存、提交、推送並建立或更新 GitHub 拉取請求。

DevOps & Cloud27K4 週前更新

Runbook

anthropics

精選

為重複性任務建立或更新逐步操作手冊，包含疑難排解、回復與升級流程。

DevOps & Cloud27K今天更新

Incident Response

anthropics

精選

引導事故回應流程：嚴重程度分級、狀態更新、緩解追蹤，以及無責事後檢討。

DevOps & Cloud27K今天更新

Deploy Checklist

anthropics

精選

產生部署前就緒檢查清單，涵蓋部署前、部署、部署後與回復觸發條件。

DevOps & Cloud27K今天更新