synthetics

List and inspect Datadog synthetic monitoring tests via the pup CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It gives you quick visibility into your Datadog synthetic monitoring setup, letting you list tests, inspect configurations, and check pass/fail status without navigating the Datadog UI. ## Core Features & Use Cases - List Synthetic Tests: View all configured synthetic tests with public ID, name, type, and status in a table. - Inspect Test Details: Retrieve full configuration for a specific test, including assertions, locations, frequency, and alert conditions. - Check Test Health: Identify failing or paused tests across API, browser, SSL, TCP, DNS, and mobile test types. - Use Case: When an alert fires, ask which synthetic tests are failing to quickly see that the login flow browser test cannot find the login button across all four locations. ## Quick Start Ask the agent to show all synthetic tests and highlight any that are currently failing.

Frequently Asked Questions about synthetics

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

FAQPage Schema
How do I list all Datadog synthetic tests from the command line?▼

Run pup synthetics list to retrieve all configured synthetic tests. The output shows each test's public ID, name, type, and status, which you can present as a table for quick review.

How do I get details of a specific Datadog synthetic test?▼

Run pup synthetics get followed by the test's public ID, for example pup synthetics get abc-def-ghi. This returns the full configuration including assertions, locations, frequency, and alert conditions.

What credentials does the pup CLI need for Datadog synthetics?▼

The pup CLI requires three environment variables: DD_API_KEY, DD_APP_KEY, and optionally DD_SITE which defaults to datadoghq.com. Set them with export commands before running any synthetics commands.

Can I create or modify Datadog synthetic tests with this tool?▼

No, test creation, modification, and result retrieval are not currently supported. Only read operations like listing tests and viewing configurations are available; use the Datadog Synthetic Monitoring UI to create or edit tests.

Why does pup synthetics fail with a missing credentials error?▼

This error occurs when DD_API_KEY or DD_APP_KEY environment variables are not set. Export both variables with your Datadog API and application keys, then rerun the command.