Logs e observabilidade
Log é para achar um problema em produção em minutos. Um formato só, campos com nome, JSON no stdout com o traceId que nasce no front-end, Loki para buscar, Grafana para ver e alertar. Auditoria de negócio é outra coisa e mora numa tabela.
Decisões e por quê
- Formato único: [Classe]: mensagem - [Campo]: valor
- Dá para buscar por [OperationId] em qualquer serviço. Ninguém escreve "User ID:" de um jeito e "userId" de outro.
- Controller loga início e fim; caso de uso loga o resultado e toda recusa
- Toda resposta 4xx tem uma linha dizendo por quê, antes da exceção.
- stdout em JSON + Loki, sem arquivo
- stdout é o destino que não falha; Loki é onde se busca. Arquivo rotativo em container é log perdido.
- traceparent criado no front-end
- Uma requisição do usuário vira um traceId que atravessa todos os serviços e filas.
- Auditoria em logs.audit
- Quem fez o quê com quem, com ip e user agent, é dado de negócio consultável, não linha de log que expira.
requisiçãoresposta
Escolha um cenário acima para ver a mensagem percorrendo a arquitetura.