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.