Official agent skill

Dd Apm

APM - traces, services, dependencies, performance analysis. An agent skill from DataDog/pup.

OfficialApache-2.0Auto-check passedDevOps & Cloud

Install Dd Apm

skills CLI

$ npx skills add DataDog/pup --skill dd-apm -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install DataDog/pup dd-apm --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dd-apm .claude/skills/dd-apm && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "dd-apm" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-apm into .claude/skills/dd-apm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-apm", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/DataDog/pup/tree/main/skills/dd-apm

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add DataDog/pup --skill dd-apm -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install DataDog/pup dd-apm --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/dd-apm .agents/skills/dd-apm && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "dd-apm" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-apm into .agents/skills/dd-apm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-apm", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add DataDog/pup --skill dd-apm -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install DataDog/pup dd-apm --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/dd-apm .cursor/skills/dd-apm && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "dd-apm" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-apm into .cursor/skills/dd-apm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-apm", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/DataDog/pup.git --path skills/dd-apm

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add DataDog/pup --skill dd-apm -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install DataDog/pup dd-apm --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/dd-apm .gemini/skills/dd-apm && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "dd-apm" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-apm into .gemini/skills/dd-apm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-apm", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install DataDog/pup dd-apm

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add DataDog/pup --skill dd-apm -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/dd-apm .github/skills/dd-apm && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "dd-apm" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-apm into .github/skills/dd-apm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-apm", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add DataDog/pup --skill dd-apm -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install DataDog/pup dd-apm --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/DataDog/pup.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/dd-apm .opencode/skills/dd-apm && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "dd-apm" agent skill from https://github.com/DataDog/pup/tree/main/skills/dd-apm into .opencode/skills/dd-apm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "dd-apm", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: dd-apm
GitHub stars: 1k
Token cost: ~1.5k tokens
SKILL.md length: 341 words
Files: 1
Skills in repo: 12
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

APM - traces, services, dependencies, performance analysis. An agent skill from DataDog/pup.

Tasks that involve Monitoring and alerting
SKILL.md covers Requirements, Quick Start, Services and Traces, plus 8 more sections
Calls brew

What it does

Dd Apm is an agent skill from DataDog/pup, published by the product's own GitHub organization. APM - traces, services, dependencies, performance analysis.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Monitoring and alerting. It works with Datadog. The repository describes itself as: Give your AI agent a Pup — a CLI companion with 200+ commands across 33+ Datadog products. The licence is Apache-2.0.

When your agent uses it

Tasks that involve Monitoring and alerting

Example prompts

“/dd-apm”

Requirements

Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 6a3c662. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- brew
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- docs.datadoghq.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dd Apm loads about 1.5k tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 341 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~17
When it runs · the whole SKILL.md, loaded when a task matches: ~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from DataDog/pup at commit 6a3c662, republished under its Apache-2.0 licence (© DataDog). 341 words, ~1,505 tokens.

Download SKILL.mdSave it as .claude/skills/dd-apm/SKILL.md (or your agent's skills folder).

name: dd-apm
description: APM - traces, services, dependencies, performance analysis.
metadata.version: 1.0.0
metadata.author: datadog-labs
metadata.repository: https://github.com/datadog-labs/agent-skills
metadata.tags: datadog,apm,tracing,performance,distributed-tracing,dd-apm
metadata.globs: **/ddtrace*,**/datadog*.yaml,**/*trace*
metadata.alwaysApply: false

Datadog APM

Distributed tracing, service maps, and performance analysis.

Requirements

Datadog Labs Pup should be installed via:

bash

brew tap datadog-labs/pack
brew install pup

Quick Start

bash

pup auth login
pup apm services list --env production
pup traces search --query="service:api-gateway" --from="1h"

Services

List Services

--env is required for all apm services commands.

bash

pup apm services list --env production
pup apm services list --env staging

Service Statistics

bash

pup apm services stats --env production
pup apm services stats --env production --from 4h

Service Operations and Resources

bash

# List operations for a service
pup apm services operations --env production --service api-gateway

# List resources (endpoints) for an operation
pup apm services resources --env production --service api-gateway --name http.request

Service Dependencies

bash

pup apm dependencies list --env production

Flow Map

bash

# View service flow map (--query and --env required)
pup apm flow-map --query "service:api-gateway" --env production

Traces

Traces are searched via the top-level traces command (not under apm).

Important: APM durations are in nanoseconds: 1 second = 1,000,000,000 ns.

Search Traces

bash

# By service
pup traces search --query="service:api-gateway" --from="1h"

# Errors only
pup traces search --query="service:api-gateway status:error" --from="1h"

# Slow traces (>1 second = 1000000000 ns)
pup traces search --query="service:api-gateway @duration:>1000000000" --from="1h"

# With specific tag
pup traces search --query="service:api @http.url:/api/users" --from="1h"

Aggregate Traces

bash

# Average duration by resource
pup traces aggregate \
  --query="service:api-gateway" \
  --compute="avg(@duration)" \
  --group-by="resource_name" \
  --from="1h"

# Error count by service
pup traces aggregate \
  --query="status:error" \
  --compute="count" \
  --group-by="service" \
  --from="1h"

# p99 latency
pup traces aggregate \
  --query="service:api-gateway" \
  --compute="percentile(@duration, 99)" \
  --from="1h"

Key Metrics

Metric	What It Measures
`trace.http.request.hits`	Request count
`trace.http.request.duration`	Latency
`trace.http.request.errors`	Error count
`trace.http.request.apdex`	User satisfaction

⚠️ Trace Sampling

Not all traces are kept. Understand sampling:

Mode	What's Kept
Head-based	Random % at start
Error/Slow	All errors, slow traces
Retention	What's indexed (billed)

Trace Retention Costs

Retention	Cost
Indexed spans	$$$ per million
Ingested spans	$ per million

Best practice: Only index what you need for search.

Service Level Objectives

Link APM to SLOs:

bash

pup slos create --file slo.json

Common Queries

Goal	Query
Slowest endpoints	`pup traces aggregate --query="service:api" --compute="avg(@duration)" --group-by="resource_name" --from="1h"`
Error rate by service	`pup traces aggregate --query="status:error" --compute="count" --group-by="service" --from="1h"`
Throughput	`pup traces aggregate --query="service:api" --compute="count" --group-by="resource_name" --from="1h"`

Service Config

Query service instance metadata — instance IDs, hostnames, and config IDs for all running instances of a service. Returns up to 100 instances.

bash

# Get instance metadata for a service
pup apm service-config get --service-name my-service

# Filter by environment
pup apm service-config get --service-name my-service --env prod

# Filter by specific instance IDs
pup apm service-config get --service-name my-service --service-instance-ids "id-1,id-2"

Note on service identity: service_name and env come from the SDK telemetry pipeline and may differ from values in the Service Catalog.

Service Library Config

Query the APM tracer configuration deployed across all running instances of a service. Useful for auditing config drift — finding instances where tracing, profiling, or AppSec is misconfigured relative to the rest of the fleet.

bash

# Get tracer config for a service
pup apm service-library-config get --service-name my-service

# Filter by environment
pup apm service-library-config get --service-name my-service --env prod

# Filter by language
pup apm service-library-config get --service-name my-service --env prod --language python

# Only show configs where instances disagree (config drift)
pup apm service-library-config get --service-name my-service --mixed

Note on service identity: service_name, env, and language_name come from the SDK telemetry pipeline and reflect what the tracer reports at runtime. These may differ from values in the Service Catalog, which aggregates data from multiple sources (APM spans, USM, infrastructure tags, manual definitions).

Troubleshooting

Problem	Fix
No traces	Check ddtrace installed, DD_TRACE_ENABLED=true
Missing service	Verify DD_SERVICE env var
Traces not linked	Check trace headers propagated
High cardinality	Don't tag with user_id/request_id
`--env` required error	Always pass `--env` to `apm services` commands

References/Docs

Files

Just SKILL.md in skills/dd-apm of DataDog/pup.

Open the folder on GitHubat commit 6a3c662

Compare with similar skills

Dd Apm next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dd Apm compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Dd Apm this skillDataDog/pup	1k	—	~1.5k	Automated safety check: Pass	Apache-2.0	yesterday
Apm IntegrationsDataDog/dd-trace-js	836	—	~3k	Automated safety check: Pass	Custom licence	today
Apm IntegrationsDataDog/dd-trace-java	736	—	~3.7k	Automated safety check: Notes	Apache-2.0	today
Tool ConnectorZhixiangLuo/10xProductivity	478	—	~925	Automated safety check: Pass	MIT	2 mo ago
Redis Observabilityredis/agent-skills	165	2 repos	~911	Automated safety check: Pass	MIT	1 mo ago
Frontmcp Observabilityagentfront/frontmcp	146	—	~4.6k	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

Apm Integrations
DataDog/dd-trace-js
Official
A skill your agent uses when adding, debugging, fixing, or modifying instrumentation and plugins for third-party libraries in dd-trace-js.
836 GitHub stars~3k tokensUpdated today
DevOps & CloudAuto-check passed
Apm Integrations
DataDog/dd-trace-java
Official
Write a new library instrumentation end-to-end. An agent skill from DataDog/dd-trace-java.
736 GitHub stars~3.7k tokensUpdated today
DevOps & CloudAuto-check: notes
Tool Connector
ZhixiangLuo/10xProductivity
Connect any tool you use at work to your agent — including internal company tools, custom-built systems, deployment portals, incident trackers, internal knowledge bases, HR systems, and commercial…
478 GitHub stars~925 tokensUpdated 2 mo ago
DevOps & CloudAuto-check passed
Redis Observability
redis/agent-skills
Official
Redis observability guidance — which metrics to monitor (memory, connections, hit ratio, ops/sec, rejected connections), which built-in commands to reach for during incident triage (SLOWLOG, INFO…
165 GitHub starsUsed in 2 repos~911 tokens
DevOps & CloudAuto-check passed
Frontmcp Observability
agentfront/frontmcp
A skill your agent uses when adding tracing, structured logging, metrics, or monitoring to a FrontMCP server.
146 GitHub stars~4.6k tokensUpdated yesterday
DevOps & CloudAuto-check passed
Monitoring Observability
ahmedasmar/devops-claude-skills
Monitoring and observability strategy, implementation, and troubleshooting.
203 GitHub stars~3.9k tokensUpdated 6 mo ago
DevOps & CloudAuto-check passed

Questions about Dd Apm

What does Dd Apm do?

APM - traces, services, dependencies, performance analysis. An agent skill from DataDog/pup. Dd Apm is an agent skill from DataDog/pup, published by the product's own GitHub organization. APM - traces, services, dependencies, performance analysis.

When should I use Dd Apm?

Dd Apm fits situations like: tasks that involve Monitoring and alerting.

How do I install Dd Apm in Claude Code?

Run `npx skills add DataDog/pup --skill dd-apm -a claude-code`. Or copy the skill folder (skills/dd-apm in DataDog/pup) into .claude/skills/dd-apm in your project. Claude Code loads it when a task matches its description.

How do I install Dd Apm in Codex?

Run `npx skills add DataDog/pup --skill dd-apm -a codex`. Or copy the skill folder (skills/dd-apm in DataDog/pup) into .agents/skills/dd-apm in your project. Codex loads it when a task matches its description.

Can I use Dd Apm in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add DataDog/pup --skill dd-apm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dd-apm, .gemini/skills/dd-apm, .github/skills/dd-apm and .opencode/skills/dd-apm in your project.

What does Dd Apm need to run?

Going by SKILL.md and its folder, Dd Apm needs the command-line tools its instructions call (brew). Our summary lists: Python 3.

Does Dd Apm access the network?

SKILL.md names 1 domain. As links in the text: docs.datadoghq.com. This is read from the text; nothing was executed.

Is Dd Apm safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dd Apm use?

Dd Apm is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dd Apm use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dd Apm?

Skills that share tags, products or a category with Dd Apm: Apm Integrations (DataDog/dd-trace-js, 836 stars), Apm Integrations (DataDog/dd-trace-java, 736 stars), Tool Connector (ZhixiangLuo/10xProductivity, 478 stars) and Redis Observability (redis/agent-skills, 165 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dd Apm?

DataDog (a GitHub organization, an official publisher) maintains it in DataDog/pup, which has 1,027 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 7, 2026.

Source: DataDog/pup on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Dd Apm

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Datadog APM

Requirements

Quick Start

Services

List Services

Service Statistics

Service Operations and Resources

Service Dependencies

Flow Map

Traces

Search Traces

Aggregate Traces

Key Metrics

⚠️ Trace Sampling

Trace Retention Costs

Service Level Objectives

Common Queries

Service Config

Service Library Config

Troubleshooting

References/Docs

Files

Compare with similar skills

Similar skills

More from DataDog/pup

Related

Questions about Dd Apm