> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.
# Logs de auditoria
> Acompanhe as mudanças instrumentadas de configuração e de operação da conciliação com um registro filtrável e com evidência de adulteração para investigar problemas.
A página **Logs de auditoria** da Matcher UI traz um registro filtrável das mudanças instrumentadas feitas na configuração e nas operações de conciliação. Use-a para investigar o ator, a ação e o horário registrado desses workflows.
## Acessando a página de Logs de auditoria
***
Vá em **Matcher → Relatórios → Logs de auditoria** na barra lateral esquerda.
Você precisa de um papel de administrador ou de acesso de leitura ao log de auditoria para abrir esta página.
## Verificando a integridade da cadeia
***
O painel **Evidência de adulteração** fica acima dos filtros. Clique em **Verificar integridade** para verificar de novo a cadeia de hash de auditoria do tenant. A verificação é somente leitura (nunca altera um registro) e retorna um de dois veredictos:
| Veredicto | Significado |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cadeia íntegra** | Cada registro inspecionado se liga ao anterior e confere com o hash armazenado. O painel informa quantos registros foram verificados. |
| **Cadeia ADULTERADA — integridade quebrada** | A cadeia de hash está quebrada em uma posição informada. O log de auditoria não pode mais ser tratado como um registro com evidência de adulteração — escale imediatamente. |
A cadeia pode ser maior que o limite de inspeção. Nesse caso, o veredicto de cadeia íntegra informa que a verificação inspecionou apenas os primeiros registros a partir do início da cadeia. Ele também informa que a verificação pulou as entradas mais recentes. Uma requisição com falha mostra um erro com um botão **Tentar de novo**. Isso não é um veredicto.
## Filtros
***
Use a barra de filtros para restringir os resultados. O campo **Ator** aceita texto livre de até 255 caracteres. Os campos **Ação** e **Tipo de entidade** aceitam texto livre de até 50 caracteres cada. Nenhum deles é lista suspensa:
| Filtro | Descrição |
| -------------------- | -------------------------------------------------------------------------------- |
| **Ator** | O identificador bruto do ator registrado com a mudança (por exemplo, `user-123`) |
| **Ação** | A operação executada (por exemplo, `CREATE`, `UPDATE`, `DELETE`) |
| **Tipo de entidade** | O tipo de recurso que foi alterado (por exemplo, `context`) |
| **Data inicial** | Data de início do intervalo de tempo |
| **Data final** | Data de fim do intervalo de tempo |
Clique em **Aplicar filtros** para rodar a busca. Aplicar filtros volta a paginação para a primeira página.
## Tabela de logs de auditoria
***
Cada linha da tabela mostra as seguintes colunas:
| Coluna | Descrição |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Entrada** | O ID do registro de log de auditoria, mostrado como link para uma página de detalhe dedicada a essa entrada — útil para colar em um chamado de incidente |
| **Registrado em** | Quando a mudança foi registrada |
| **Ação** | A operação executada |
| **Tipo de entidade** | O tipo de recurso que foi alterado |
| **ID da entidade** | Identificador do recurso afetado |
| **Ator** | O identificador bruto do ator registrado com a mudança (por exemplo, `user-123`), não um nome resolvido de pessoa ou de sistema |
| **Cadeia** | A posição do registro na cadeia (`#`) e o hash do registro. Registros gravados antes de a cadeia de hash existir mostram **Sem prova de cadeia** |
| **Mudanças** | Um botão **Ver** que abre o payload JSON de auditoria registrado. Linhas sem mudanças em JSON mostram um placeholder |
Use os botões **Anterior** e **Próxima** no rodapé da tabela para navegar pelos resultados. O rodapé também mostra o número da página atual e a quantidade de eventos nessa página.
## Vendo os detalhes de uma mudança
***
Clique em **Ver** na coluna Mudanças para abrir o painel **Mudanças do log de auditoria**. O painel descreve a mudança registrada (ação, tipo de entidade e ID da entidade) e depois mostra o payload JSON de auditoria registrado como um bloco formatado. Os campos dele dependem da operação. Ele não garante um schema de antes e depois.
Você também pode clicar no ID da coluna **Entrada** para abrir uma página de detalhe dedicada a essa entrada específica.
Se o diff original era maior que o limite do payload de auditoria, a linha mostra um marcador **Diff truncado**. O painel explica que um envelope marcador substituiu o conjunto completo de mudanças. O diff completo não pode ser recuperado desse registro.