majiayu000 Datadog Observability Skill
Overview
Provides 90%+ context savings vs raw Datadog API integration. Multi-service support with progressive disclosure by observability category.
Requirements
- Datadog API configured
- Environment variables:
DD_API_KEY(required): Datadog API keyDD_APP_KEY(required): Datadog application keyDD_SITE(optional): Datadog site (default: datadoghq.com)
Tools (Progressive Disclosure)
Metrics Operations
| Tool | Description | Confirmation |
|---|---|---|
| query-metrics | Query metric timeseries | No |
| list-metrics | List available metrics | No |
| post-metrics | Submit custom metrics | Yes |
APM/Traces Operations
| Tool | Description | Confirmation |
|---|---|---|
| list-services | List APM services | No |
| service-summary | Get service performance summary | No |
| search-traces | Search distributed traces | No |
Logs Operations
| Tool | Description | Confirmation |
|---|---|---|
| search-logs | Search log entries | No |
| log-indexes | List log indexes | No |
| log-pipelines | View log processing pipelines | No |
Monitors/Alerts Operations
| Tool | Description | Confirmation |
|---|---|---|
| list-monitors | List monitors | No |
| monitor-status | Get monitor status | No |
| create-monitor | Create new monitor | Yes |
| mute-monitor | Mute monitor alerts | Yes |
Infrastructure Operations
| Tool | Description | Confirmation |
|---|---|---|
| list-hosts | List infrastructure hosts | No |
| host-metrics | Get host-level metrics | No |
| list-containers | List containers | No |
Quick Reference
# Query metrics
curl -X POST "https://api.${DD_SITE}/api/v1/query" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d '{"query":"avg:system.cpu.user{*}"}'
# Search logs
curl -X POST "https://api.${DD_SITE}/api/v2/logs/events/search" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d '{"filter":{"query":"service:web","from":"now-1h","to":"now"}}'
# List monitors
curl -X GET "https://api.${DD_SITE}/api/v1/monitor" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
# Get service summary
curl -X GET "https://api.${DD_SITE}/api/v1/apm/service/{service_name}" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}"
Configuration
- DD_API_KEY: Datadog API key (required)
- DD_APP_KEY: Datadog application key (required)
- DD_SITE: Datadog site domain (optional, default: datadoghq.com)
- US1: datadoghq.com
- US3: us3.datadoghq.com
- US5: us5.datadoghq.com
- EU: datadoghq.eu
- AP1: ap1.datadoghq.com
Security
⚠️ Never hardcode API keys or application keys ⚠️ Use environment variables or secret management ⚠️ Monitor mutations (create, mute) require confirmation ⚠️ Never expose DD_API_KEY or DD_APP_KEY in logs or responses
Agent Integration
- devops (primary): Infrastructure monitoring and SRE
- incident-responder (primary): Crisis management and troubleshooting
- performance-engineer (secondary): Performance analysis
- developer (secondary): Application monitoring
Troubleshooting
| Issue | Solution |
|---|---|
| Authentication failed | Verify DD_API_KEY and DD_APP_KEY |
| Site not found | Check DD_SITE configuration |
| Rate limit exceeded | Implement exponential backoff |
| Empty metrics | Verify metric names and time range |