Logs Estruturados

Por que Estruturar?

Logs tradicionais são difíceis de analisar em escala. Logs estruturados permitem:

  • Busca eficiente por campos específicos
  • Agregação automática de dados
  • Correlação entre diferentes fontes
  • Alertas inteligentes baseados em padrões

Formatos Comuns

JSON

{
  "timestamp": "2026-03-18T10:00:00Z",
  "level": "INFO",
  "service": "api-gateway",
  "message": "Request processed",
  "request_id": "abc-123",
  "duration_ms": 150
}

Structured Logging Libraries

  • Python: structlog
  • Java: SLF4J with JSON layout
  • Go: logrus
  • JavaScript: winston

Campos Essenciais

  • Timestamp (ISO 8601)
  • Nível de log (DEBUG, INFO, WARN, ERROR)
  • Serviço/componente
  • ID de correlação (request ID, trace ID)
  • Contexto relevante
  • Métricas inline quando aplicável

Centralização

Use ferramentas como:

  • ELK Stack (Elasticsearch, Logstash, Kibana)
  • Loki + Grafana
  • CloudWatch Logs
  • Datadog Logs