MANUAL 0.11.0

Logs, Observabilidade e Auditoria

Diferencie trilha funcional, eventos do pedido e diagnóstico técnico.

Auditoria funcional

A auditoria registra ações relevantes e ajuda a identificar usuário, data/hora e alteração realizada. Ela é importante para rastrear mudanças em pedidos, pagamentos, configurações, aprovações e outros módulos sensíveis.

Eventos do pedido

A Timeline/histórico do pedido preserva mudanças de status, pagamentos, aprovação, Consultor Py, mensagens, logística, cancelamentos e ações operacionais vinculadas ao pedido.

Observabilidade 0.11.0

A estrutura application_logs amplia o diagnóstico técnico com registros estruturados e filtráveis de aplicação. Ela complementa — não substitui — a auditoria.

Como investigar

  1. identifique o horário aproximado do problema;
  2. confira Timeline/auditoria da entidade;
  3. filtre application_logs pelo contexto disponível;
  4. consulte fila/outbox quando envolver comunicação;
  5. confira Saúde dos Serviços quando envolver integração externa;
  6. preserve a sequência de eventos antes de executar retries manuais.

Dados sensíveis

Senhas, tokens, API keys, chaves privadas e segredos não devem aparecer em claro nos logs. Ao exportar ou compartilhar diagnóstico, revise o conteúdo.