What commands are available in Datadog CLI?

The Datadog CLI includes commands for searching logs, streaming logs, querying metrics, managing dashboards, and more. Each command is designed to facilitate specific tasks related to observability.

How do I set up the Datadog CLI?

To set up the Datadog CLI, you need to export your Datadog API and application keys as environment variables. Detailed instructions are provided in the setup section of the documentation.

Can I use this CLI with non-US Datadog sites?

Yes, the CLI supports non-US Datadog sites. You can specify the site using the `--site` flag in your commands.

What output formats does the Datadog CLI support?

The CLI supports a human-readable output format with colors and the option to export results to a JSON file.

Is there a way to automate workflows with this CLI?

Yes, the CLI provides predefined workflows for incident triage, allowing users to follow a series of commands to efficiently diagnose and resolve issues.

Datadog CLI

Name: Datadog CLI
Availability: InStock
Author: davila7

Free

Efficiently manage Datadog logs and metrics from the command line.

by davila730.2k stars on davila7/claude-code-templates

Updated Aug 10, 2026

Get this skill

Free · Opens the source repo

What Datadog CLI does

Datadog CLI is a command-line interface tool designed for developers and operations teams to interact with Datadog’s observability features. This skill allows users to search logs, query metrics, trace requests, and manage dashboards directly from their terminal, streamlining the debugging and monitoring process. By leveraging the CLI, users can quickly diagnose production issues and gain insights into their applications without needing to navigate through the Datadog web interface.

To get started, users must set up their environment with the necessary API and application keys from Datadog. Once configured, the CLI provides a variety of commands tailored for different observability tasks. For example, users can execute commands to search logs with specific filters, stream logs in real-time, and query metrics over defined time periods. The CLI supports various output formats, including a human-readable option, making it easier to interpret results on the fly.

The tool is particularly useful in scenarios where rapid incident response is critical. By following predefined workflows, users can efficiently triage incidents, compare log data between periods, and identify error patterns across services. This capability is essential for teams that need to maintain high availability and performance in their applications. The Datadog CLI is ideal for DevOps engineers, site reliability engineers, and any team that relies on Datadog for monitoring and observability.

In summary, Datadog CLI enhances the user experience by providing a powerful command-line interface for interacting with Datadog’s features. It simplifies the process of debugging and monitoring, allowing teams to focus on resolving issues quickly and effectively.

When to use it

Use this tool when you need to quickly search logs, query metrics, or manage dashboards while debugging production issues.

When not to use it

This CLI may not be suitable for users who prefer a graphical interface or need extensive data visualization capabilities.

What you can build with it

Quick Error Overview

Use the `errors` command to get a summary of recent errors in your application, helping you identify issues quickly.

Real-time Log Streaming

Utilize the `logs tail` command to stream logs in real-time, allowing you to monitor your application as it runs.

Comparative Log Analysis

Leverage the `logs compare` command to analyze log counts between different time periods, helping you spot trends or anomalies.

How to install Datadog CLI

View source

1. Install with the skills CLI

npx skills add davila7/claude-code-templates/datadog-cli --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by davila7

Datadog CLI

A CLI tool for AI agents to debug and triage using Datadog logs and metrics.

Required Reading

You MUST read the relevant reference docs before using any command:

Setup

Environment Variables (Required)

export DD_API_KEY="your-api-key"
export DD_APP_KEY="your-app-key"

Get keys from: https://app.datadoghq.com/organization-settings/api-keys

Running the CLI

npx @leoflores/datadog-cli <command>

For non-US Datadog sites, use --site flag:

npx @leoflores/datadog-cli logs search --query "*" --site datadoghq.eu

Commands Overview

Command	Description
`logs search`	Search logs with filters
`logs tail`	Stream logs in real-time
`logs trace`	Find logs for a distributed trace
`logs context`	Get logs before/after a timestamp
`logs patterns`	Group similar log messages
`logs compare`	Compare log counts between periods
`logs multi`	Run multiple queries in parallel
`logs agg`	Aggregate logs by facet
`metrics query`	Query timeseries metrics
`errors`	Quick error summary by service/type
`services`	List services with log activity
`dashboards`	Manage dashboards (CRUD)
`dashboard-lists`	Manage dashboard lists

Quick Examples

Search Errors

npx @leoflores/datadog-cli logs search --query "status:error" --from 1h --pretty

Tail Logs (Real-time)

npx @leoflores/datadog-cli logs tail --query "service:api status:error" --pretty

Error Summary

npx @leoflores/datadog-cli errors --from 1h --pretty

Trace Correlation

npx @leoflores/datadog-cli logs trace --id "abc123def456" --pretty

Query Metrics

npx @leoflores/datadog-cli metrics query --query "avg:system.cpu.user{*}" --from 1h --pretty

Compare Periods

npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty

Global Flags

Flag	Description
`--pretty`	Human-readable output with colors
`--output <file>`	Export results to JSON file
`--site <site>`	Datadog site (e.g., `datadoghq.eu`)

Time Formats

Relative: 30m, 1h, 6h, 24h, 7d
ISO 8601: 2024-01-15T10:30:00Z

Incident Triage Workflow

# 1. Quick error overview
npx @leoflores/datadog-cli errors --from 1h --pretty

# 2. Is this new? Compare to previous period
npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty

# 3. Find error patterns
npx @leoflores/datadog-cli logs patterns --query "status:error" --from 1h --pretty

# 4. Narrow down by service
npx @leoflores/datadog-cli logs search --query "status:error service:api" --from 1h --pretty

# 5. Get context around a timestamp
npx @leoflores/datadog-cli logs context --timestamp "2024-01-15T10:30:00Z" --service api --pretty

# 6. Follow the distributed trace
npx @leoflores/datadog-cli logs trace --id "TRACE_ID" --pretty

See workflows.md for more debugging workflows.

Frequently asked questions about Datadog CLI

Similar skills

Turborepo

Optimized build system for JavaScript/TypeScript monorepos.

Azure Pipelines Validation

Streamline your Azure DevOps pipeline changes locally.

Azure Developer CLI

Streamline your Azure project workflows with best practices.

Azure Container Registry CLI

Manage Azure Container Registry resources with ease.

Aspire

Build and orchestrate polyglot distributed applications seamlessly.

Vercel CLI

Manage and deploy Vercel projects from the command line.