AI agent skill · by @automateyournetwork

Datadog Metrics

Query metrics and explore dashboards in Datadog.

Archived 2026-10-23 · Source updated 2026-10-11 · License: Apache-2.0. Check the original repository for the latest version.

SKILL.md instructions

# Datadog Metrics Skill

Query metrics and explore dashboards in Datadog.

## Tools

| Tool | Description |
|------|-------------|
| `query_metrics` | Execute metric queries with aggregations |
| `list_metrics` | List available metrics matching a pattern |
| `get_metric_metadata` | Get metadata for a specific metric |
| `list_dashboards` | List all available dashboards |
| `get_dashboard` | Get dashboard definition and widgets |

## Example Queries

```
Query CPU utilization for network devices
→ query_metrics(query="avg:system.cpu.user{role:network_device} by {host}", time_range="1h")

Get interface traffic metrics
→ query_metrics(query="sum:network.bytes_rcvd{*} by {interface}", time_range="4h")

List all network-related metrics
→ list_metrics(pattern="network.*")

Get a specific dashboard
→ get_dashboard(dashboard_id="abc-def-123")
```

## Workflows

### Network Performance Monitoring
1. Query interface utilization: `query_metrics(query="avg:network.bytes_sent{*} by {host,interface}")`
2. Check error rates: `query_metrics(query="sum:network.errors{*} by {host}")`
3. Monitor latency percentiles: `query_metrics(query="p99:network.latency{*}")`
4. Compare against SLA thresholds

### Infrastructure Health Assessment
1. List all infrastructure metrics: `list_metrics(pattern="system.*")`
2. Query CPU/memory across fleet: `query_metrics(query="avg:system.cpu.user{*} by {availability_zone}")`
3. Identify outliers and degradation
4. Check dashboard for historical trends

### Capacity Planning
1. Query peak utilization: `query_metrics(query="max:system.disk.used{*} by {host}", time_range="30d")`
2. Calculate growth rate
3. Forecast exhaustion dates
4. Generate capacity report

## Prerequisites

- `DD_API_KEY` Datadog API key
- `DD_APP_KEY` Datadog application key
- `DD_SITE` Datadog site (optional, defaults to datadoghq.com)

## Server

This skill uses the `datadog-mcp` server via remote MCP transport.

## Failure Behavior

- On a tool error (timeout, unreachable host, malformed response), report the failure and its error message directly to the user rather than fabricating or guessing at results.
- For a confirmed read-only call, check connectivity and retry once if appropriate. For any call that changes state or sends a message, a timeout does not prove the action failed: inspect current state or delivery status before retrying, preserve the required approval/change gates, and do not repeat an action whose outcome is unknown.