artubss 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:
- Log Commands
- Metrics
- Query Syntax
- Workflows
- Dashboards
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.