pup

Purpose

Use this skill when you need to query Datadog for observability data: searching logs, querying time-series metrics, aggregating log statistics, listing available metrics, or inspecting metric metadata. pup is a CLI wrapper around Datadog APIs.

When to use what

Metrics

• pup metrics query: Query time-series metric data with aggregation, filtering, and grouping. Primary command for metric analysis.
• pup metrics search: Same query syntax as query but uses the simpler v1 API. Use when you don't need v2 timeseries formula semantics.
• pup metrics list: Discover available metric names. Use with --filter to narrow by pattern.
• pup metrics metadata get: Read metadata (description, unit, type) for a specific metric.
• pup metrics tags list: List available tags for a specific metric.

Logs