Datadog CLI
Uma ferramenta CLI para agentes de IA depurarem e triarem usando logs e métricas do Datadog.
Leitura Obrigatória
Você DEVE ler a documentação de referência relevante antes de usar qualquer comando:
Configuração
Variáveis de Ambiente (Obrigatórias)
export DD_API_KEY="your-api-key"
export DD_APP_KEY="your-app-key"
Obtenha as chaves em: https://app.datadoghq.com/organization-settings/api-keys
Executando a CLI
npx @leoflores/datadog-cli <command>
Para sites Datadog fora dos EUA, use a flag --site:
npx @leoflores/datadog-cli logs search --query "*" --site datadoghq.eu
Visão Geral dos Comandos
| Comando | Descrição |
|---|
logs search | Buscar logs com filtros |
logs tail | Transmitir logs em tempo real |
logs trace | Encontrar logs para um rastreamento distribuído |
logs context | Obter logs antes/depois de um timestamp |
logs patterns | Agrupar mensagens de log semelhantes |
logs compare | Comparar contagens de logs entre períodos |
logs multi | Executar múltiplas consultas em paralelo |
logs agg | Agregar logs por faceta |
metrics query | Consultar métricas de séries temporais |
errors | Resumo rápido de erros por serviço/tipo |
services | Listar serviços com atividade de log |
dashboards | Gerenciar dashboards (CRUD) |
dashboard-lists | Gerenciar listas de dashboards |
Exemplos Rápidos
Buscar Erros
npx @leoflores/datadog-cli logs search --query "status:error" --from 1h --pretty
Transmitir Logs (Tempo Real)
npx @leoflores/datadog-cli logs tail --query "service:api status:error" --pretty
Resumo de Erros
npx @leoflores/datadog-cli errors --from 1h --pretty
Correlação de Rastreamento
npx @leoflores/datadog-cli logs trace --id "abc123def456" --pretty
Consultar Métricas
npx @leoflores/datadog-cli metrics query --query "avg:system.cpu.user{*}" --from 1h --pretty
Comparar Períodos
npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty
Flags Globais
| Flag | Descrição |
|---|
--pretty | Saída legível para humanos com cores |
--output <file> | Exportar resultados para arquivo JSON |
--site <site> | Site do Datadog (ex: datadoghq.eu) |
Formatos de Tempo
- Relativo:
30m, 1h, 6h, 24h, 7d
- ISO 8601:
2024-01-15T10:30:00Z
Fluxo de Triagem de Incidentes
# 1. Visão geral rápida de erros
npx @leoflores/datadog-cli errors --from 1h --pretty
# 2. Isso é novo? Comparar com período anterior
npx @leoflores/datadog-cli logs compare --query "status:error" --period 1h --pretty
# 3. Encontrar padrões de erro
npx @leoflores/datadog-cli logs patterns --query "status:error" --from 1h --pretty
# 4. Estreitar por serviço
npx @leoflores/datadog-cli logs search --query "status:error service:api" --from 1h --pretty
# 5. Obter contexto em torno de um timestamp
npx @leoflores/datadog-cli logs context --timestamp "2024-01-15T10:30:00Z" --service api --pretty
# 6. Seguir o rastreamento distribuído
npx @leoflores/datadog-cli logs trace --id "TRACE_ID" --pretty
Veja workflows.md para mais fluxos de depuração.