Logs e Rastreabilidade

O sistema de logs do Romeo é a fundação da observabilidade. Captura eventos de todas as camadas da aplicação — desde requisições HTTP até operações de banco de dados — permitindo debug, monitoramento e investigação.

Diferente dos logs de auditoria (focados em ações de usuários), os logs de sistema capturam eventos técnicos: erros, performance, integrações, jobs assíncronos e comportamento da infraestrutura.

Observabilidade completa

Logs são apenas uma perna do tripé. Junto com métricas (Prometheus) e traces (OpenTelemetry), formam a base para entender o que acontece no sistema.

O Romeo gera diferentes tipos de logs, cada um com propósito e retenção específicos.

Categorias de logs

Detalhamento por categoria

Separação física: Security logs ficam em bucket separado com acesso restrito. Apenas time de segurança e DPO podem consultar.

Todos os logs seguem formato estruturado (JSON), permitindo queries eficientes e correlação entre eventos.

Schema padrão

Exemplo de log estruturado

{
  "timestamp": "2026-06-15T14:32:17.123Z",
  "level": "error",
  "service": "api-gateway",
  "version": "2.4.1",
  "environment": "prod",
  "trace_id": "abc123def456",
  "span_id": "span789",
  "request_id": "req-xyz",
  "tenant_id": "imob-abc",
  "user_id": "user-456",
  "message": "Failed to process payment",
  "context": {
    "payment_id": "pay-123",
    "amount": 1500.00,
    "gateway": "stripe"
  },
  "error": {
    "type": "PaymentGatewayError",
    "message": "Card declined",
    "code": "card_declined",
    "stack": "PaymentGatewayError: Card declined\n    at..."
  }
}

Dados sensíveis

Logs NUNCA contêm dados sensíveis em plain text. CPF, cartão, senhas são sempre mascarados (últimos 4 dígitos) ou omitidos.

Os níveis de log seguem convenção padrão da indústria, com critérios claros para uso de cada um.

Definição dos níveis

Critérios para alertas

Agregação de warnings

Warnings não geram alertas individuais, mas são agregados:

• Relatório diário de warnings por categoria
• Alerta se warning específico aumentar 5x vs. média da semana
• Dashboard de tendências para identificar degradação gradual

A arquitetura de logs do Romeo é projetada para alta disponibilidade, baixa latência de ingestão e custo otimizado de armazenamento.

Pipeline de logs

Infraestrutura

Custo otimizado: Logs em hot storage por 30 dias (~$2/GB), warm por 60 dias (~$0.50/GB), depois archive (~$0.01/GB). Volume médio: 50GB/dia = ~$3K/mês total.

O sistema oferece múltiplas interfaces para consultar logs, desde busca ad-hoc até dashboards pré-configurados.

Interfaces disponíveis

Queries comuns

Correlação

O trace_id permite seguir uma requisição através de todos os serviços. Uma busca por trace_id retorna logs de API, workers, integrações — tudo.

Além do uso operacional, logs são fundamentais para atender requisitos regulatórios e investigações de incidentes.

Marco Civil da Internet

O Marco Civil (Lei 12.965/2014) exige guarda de registros de acesso à aplicação por 6 meses. O Romeo atende com:

LGPD

Para atender requisitos da LGPD, os logs implementam:

• Minimização: apenas dados necessários para a finalidade
• Anonimização: IPs são anonimizados após 24h para análise agregada
• Acesso restrito: apenas funções autorizadas podem consultar
• Expurgo automático: logs são excluídos após período de retenção

Investigação de incidentes

Em caso de incidente de segurança, os logs permitem:

Tempo de resposta: Incidentes de segurança devem ser investigados em até 72 horas (LGPD). Os logs permitem análise inicial em minutos.