dd-pup

Query and manage Datadog resources through the pup CLI with OAuth2 authentication.

5|2|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/lauhon/pi --skill dd-pup-lauhon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dd-pup
Source: https://github.com/lauhon/pi/tree/main/skills/dd-pup
Command: npx skills add https://github.com/lauhon/pi --skill dd-pup-lauhon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interacting with the Datadog platform for logs, monitors, traces, incidents, and infrastructure data normally requires navigating the web UI or writing raw API calls. This Skill provides a complete command reference for the pup CLI so you can query and manage Datadog resources directly from the terminal with proper authentication handling. ## Core Features & Use Cases - Observability Queries: Search logs, traces, metrics, and security signals with time-range filters and query syntax. - Resource Management: Create, update, list, and delete monitors, dashboards, SLOs, downtimes, synthetics, and incidents. - Live Debugging: Place debugger probes on running services and watch captured runtime values via symdb method discovery. - Auth Handling: OAuth2 browser login with token refresh, plus API key environment variables for headless CI environments. - Use Case: During an incident, run pup logs search --query "status:error" --from 1h to find errors, check pup monitors list for alerting state, and inspect pup incidents list without leaving your terminal. ## Quick Start Ask the AI to search Datadog error logs from the last hour using the pup CLI and summarize the top failing services.

Frequently Asked Questions about dd-pup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Datadog logs from the command line?

Use pup logs search with a query and time range, for example pup logs search --query "status:error" --from 1h. You can filter by service, HTTP status codes, and limit result counts.

How do I authenticate the pup Datadog CLI?

Run pup auth login for the OAuth2 browser flow, which is the recommended method. For headless or CI environments, set the DD_API_KEY, DD_APP_KEY, and DD_SITE environment variables instead.

Why does pup return 401 Unauthorized errors?

OAuth2 tokens expire after roughly one hour, causing 401 errors mid-session. Run pup auth refresh to renew the token without a browser, or pup auth login for a full re-authentication if refresh fails.

Can pup CLI work in CI pipelines without a browser?

Yes, pup supports headless authentication through environment variables. Set DD_API_KEY, DD_APP_KEY, and DD_SITE (such as datadoghq.com or datadoghq.eu) to run commands without the OAuth2 browser flow.

How do I place a live debugger probe on a running service?

First run pup symdb search to find probe-able methods, then use pup debugger probes create with the service, environment, and probe location in TYPE:METHOD format. Watch captured values with pup debugger probes watch.

What Datadog resources can pup manage?

Pup manages monitors, dashboards, SLOs, downtimes, synthetics, incidents, notebooks, observability pipelines, LLM observability projects, reference tables, and cloud cost configs. It also queries logs, traces, metrics, events, hosts, and security signals.