dd-monitors

Create, update, mute, and audit Datadog monitors using the pup CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Managing Datadog monitors manually through the UI is slow and error-prone, and poorly configured alerts cause alert fatigue or missed incidents. This Skill provides CLI-driven monitor management with built-in alerting best practices. ## Core Features & Use Cases - Monitor Lifecycle Management: List, search, get, create, update, mute, and unmute monitors via the pup CLI. - Alerting Best Practices: Enforces stable query windows, proper scoping, recovery thresholds, and runbook-linked messages to prevent flapping and alert fatigue. - Safe Deletion Workflow: Marks monitors with a "[MARKED FOR DELETION]" prefix instead of deleting them directly. - Use Case: A platform engineer needs to silence a noisy CPU monitor during a deploy, then audit all monitors lacking team ownership tags using pup and jq. ## Quick Start Ask the assistant to list all Datadog monitors currently in Alert status and mute the noisiest one for one hour.

Frequently Asked Questions about dd-monitors

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

FAQPage Schema
How do I create a Datadog monitor from the command line?

Use the pup CLI with pup monitors create --file monitor.json after authenticating with pup auth login. The monitor definition is supplied as a JSON file containing the query, thresholds, and notification message.

How do I mute a Datadog monitor temporarily?

Mute a monitor with pup monitors update <id> --file monitor-muted.json, optionally specifying an end time. For scheduled or recurring maintenance, create a downtime with pup downtime create instead of muting.

What is the difference between muting a monitor and creating a downtime?

Muting suits quick one-off silencing under an hour, while downtimes are preferred for scheduled or recurring maintenance windows. Downtimes are created with pup downtime create --file downtime.json.

How do I prevent Datadog alerts from flapping?

Use longer evaluation windows like last_5m instead of last_1m, scope queries to specific environments and services, and set recovery thresholds such as critical_recovery below the critical threshold.

Why is my Datadog monitor not firing alerts?

Check that the query actually returns data, thresholds are reachable, and the agent is connected and reporting the metric. Authentication errors can be resolved with pup auth refresh.

How do I safely delete a Datadog monitor?

Never delete monitors directly. Instead, rename the monitor with a "[MARKED FOR DELETION]" prefix using the update API, which preserves audit history and allows recovery before final removal.