pup

Installation
SKILL.md

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

  • pup logs query: Query logs using the v2 API (recommended). Supports timezone and flexible sorting.
  • pup logs search: Search logs using the v1 API. Simpler but less capable than query.
  • pup logs list: List logs with basic filtering. Lightest-weight log retrieval.
Related skills
Installs
8
GitHub Stars
12
First Seen
Feb 13, 2026