Como eu trabalho

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.