Observabilidade para finance ops: eventos, trilhas e métricas
Como implementar observabilidade em sistemas contábeis sem comprometer performance, com foco em trilhas de auditoria, eventos de domínio e métricas operacionais.
Observabilidade além do APM
Quando engenheiros falam em observabilidade, geralmente pensam em logs, traces e métricas de infraestrutura. Em sistemas financeiros, observabilidade tem uma dimensão adicional: a capacidade de reconstruir a história completa de qualquer operação, a qualquer momento, para qualquer auditor.
Essa dimensão não é atendida por ferramentas tradicionais de APM. Um trace distribuído mostra que uma requisição HTTP levou 230ms para completar. Uma trilha de auditoria contábil mostra que o usuário Maria aprovou a conciliação da conta 1234 no dia 15 de janeiro às 14:32, após revisar a evidência anexada por João no dia anterior.
Ambas as informações são necessárias. Nenhuma substitui a outra.
Os três pilares da observabilidade financeira
1. Eventos de domínio
Cada mutação no domínio contábil gera um evento estruturado. Não um log textual, mas um registro tipado com todos os atributos relevantes para reconstrução futura.
interface ConciliationEvent {
type: 'STATE_TRANSITION' | 'EVIDENCE_ATTACHED' | 'BALANCE_UPDATED';
conciliationId: string;
userId: string;
tenantId: string;
timestamp: Date;
payload: Record<string, unknown>;
previousState?: string;
newState?: string;
}
Eventos de domínio diferem de logs de aplicação em propósito e durabilidade. Logs podem ser rotacionados e descartados após semanas. Eventos de domínio contábil não são reescritos nem descartados -- eles constituem a trilha de auditoria do sistema.
A separação é importante porque permite otimizar cada tipo de dado para seu caso de uso. Logs vão para Elasticsearch com retenção de 30 dias. Eventos de domínio vão para o banco relacional com retenção indefinida.
2. Trilhas de auditoria
A trilha de auditoria é a materialização dos eventos de domínio em uma estrutura navegável. Ela responde perguntas como:
- Quem alterou o saldo desta conta e quando?
- Qual era o estado desta conciliação antes da última transição?
- Quantas vezes esta conciliação foi reaberta e por quem?
Para ser útil em contexto regulatório, a trilha deve ser só de inclusão (a aplicação insere, e não altera nem apaga), completa (todas as operações registradas) e acessível (consultas eficientes por entidade, usuário ou período).
O modelo de dados para trilhas de auditoria segue um padrão consistente:
| Campo | Propósito |
|---|---|
| entityType | Tipo da entidade afetada (conciliação, balancete, conta) |
| entityId | Identificador único da entidade |
| action | Operação realizada (criação, atualização, transição, exclusão) |
| userId | Usuário que executou a ação |
| timestamp | Momento exato da operação |
| changes | Diff estruturado (campo, valor anterior, valor novo) |
| metadata | Contexto adicional (IP, sessão, justificativa) |
3. Métricas operacionais
Métricas agregadas fornecem visão panorâmica da operação contábil. Diferente de eventos individuais, métricas revelam padrões e tendências.
Métricas de throughput:
- Conciliações concluídas por período
- Balancetes importados por dia
- Transições de estado por hora
Métricas de qualidade:
- Taxa de rejeição na revisão
- Conciliações reabertas após aprovação
- Divergências identificadas por importação
Métricas de SLA:
- Porcentagem de conciliações dentro do prazo
- Tempo médio de cada fase do workflow
- Contas com SLA crítico (próximas do vencimento)
Essas métricas alimentam dashboards operacionais e relatórios gerenciais. A granularidade ideal depende do volume: operações de alto volume justificam métricas por minuto, enquanto operações mensais (como fechamento) funcionam bem com agregação diária.
Desafios de implementação
Performance da escrita de eventos
Registrar eventos de auditoria de forma síncrona em cada operação adiciona latência. Em operações unitárias (aprovar uma conciliação), o impacto é desprezível. Em operações em lote (importar balancete com 500 contas), o impacto acumula.
A solução é garantir atomicidade sem sacrificar throughput. Eventos são escritos na mesma transação de banco que a operação principal, eliminando o risco de operação sem registro. A performance é mantida através de batch inserts e índices otimizados.
Consistência entre sistemas
Quando métricas são derivadas de eventos, e quando eventos são a fonte de verdade para auditoria, é fundamental que ambos os sistemas reflitam a mesma realidade. Discrepâncias entre o dashboard de métricas e a trilha de auditoria erodem a confiança no sistema.
O padrão mais confiável é derivar métricas diretamente dos eventos de domínio, tratando-os como fonte única de verdade. Views materializadas ou agregações pré-calculadas podem otimizar consultas sem introduzir fontes duplicadas.
Retenção e conformidade
Regulamentações contábeis exigem retenção de registros por períodos que variam de 5 a 10 anos. A arquitetura de armazenamento deve suportar essa retenção sem degradar a performance de consultas correntes.
Estratégias de particionamento por data, compressão de registros antigos e archival para storage de menor custo permitem atender requisitos regulatórios sem impacto operacional.
Observabilidade como diferencial
Em um mercado onde conformidade regulatória é requisito mínimo, a qualidade da observabilidade é o que diferencia uma plataforma madura de uma ferramenta improvisada.
Quando cada operação é rastreável, cada decisão é auditável e cada tendência é mensurável, a equipe contábil opera com confiança. A auditoria se torna uma verificação rotineira, não uma crise trimestral.
Investir em observabilidade financeira é investir na credibilidade do processo contábil como um todo.