events

Submit, search, and filter Datadog events using the pup CLI tool.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Tracking deployments, incidents, and infrastructure changes across systems is difficult without a centralized event stream, and manually querying the Datadog Events API requires knowing its syntax and parameters. ## Core Features & Use Cases - Event Submission: Create custom events for deployments, incidents, configuration changes, and releases with tags, priorities, alert types, and aggregation keys. - Event Search & Filtering: Query the event stream by time range, tags, status, source, and priority using Datadog query syntax with pagination support. - Use Case: After deploying a new service version, record a deployment event tagged with environment and version, then later search all deployment events from the past 30 days to correlate them with error spikes. ## Quick Start Ask the agent to show all error events in production from the last 24 hours.

Frequently Asked Questions about events

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

FAQPage Schema
How do I submit a custom event to Datadog?

Use the pup events submit command with a title, text, alert type, and tags. For example, record a deployment with alert-type info and tags like env:production and version:v2.1.0. Submission requires user confirmation before execution.

How to search Datadog events by tags and time range?

Use pup events search with a query parameter and time range flags. Queries support Datadog syntax like tags:env:production AND status:error, with relative times such as 24h or 7d, and results can be paginated with cursors.

What environment variables does the Datadog events CLI require?

The pup CLI requires DD_API_KEY for authentication, DD_APP_KEY for reading events, and optionally DD_SITE which defaults to datadoghq.com. Missing credentials produce an error prompting you to set these variables.

What alert types and priorities does Datadog events support?

Valid alert types are error, warning, info, success, user_update, recommendation, and snapshot. Valid priorities are normal and low. Using invalid values like critical or high returns a validation error listing the accepted options.

Why does my Datadog events query fail with a time range error?

The API rejects time ranges exceeding the maximum allowed window. Reduce the range between the from and to parameters, or use pagination with the limit and cursor flags to iterate through large result sets.