> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-superadmin/sistema/sistema-dados-e-configuracao/log-de-auditoria.md).

# Log de Auditoria

{% hint style="warning" %}
**Disponível para o perfil: Superadministrador**
{% endhint %}

A página de Log de Auditoria é a ferramenta de rastreabilidade do Z-PRO, projetada para monitorar todas as ações realizadas no sistema. Ela permite que o SuperAdmin identifique quem realizou uma alteração, em qual momento, a partir de qual endereço IP e qual dado específico foi modificado.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2F9dUkvrsF2QpPaT6vhxGQ%2Fimage.png?alt=media&amp;token=18ff1893-4a26-4f11-82e5-c6a4735bd0f4" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FVgXB6M5cAMm6x9s4q6b6%2Fimage.png?alt=media&amp;token=96ee1e13-4a93-4ac7-a464-691fd753cc72" alt=""><figcaption></figcaption></figure>

### 1. Filtrando Registros

Para localizar eventos específicos em meio ao histórico do sistema, utilize os filtros superiores:

* Tenant: Filtre as ações por uma empresa específica ou visualize "Todos os tenants";
* Ação: Selecione o tipo de operação realizada no sistema. As opções disponíveis no menu suspenso incluem:
  * Criar: Registros de novas inserções de dados;
  * Atualizar: Modificações em dados já existentes;
  * Deletar: Remoção de registros do sistema;
  * Testar: Ações de teste de conexões ou recursos;
  * Migrar: Registros de migrações de dados ou versões;
  * Reparar: Ações de correção ou manutenção de recursos.
* Entidade: Busque por um recurso específico do sistema, como `tickets`, `users` ou `messages`;
* Usuário: Filtre as ações executadas por um colaborador ou administrador específico;
* Data Inicial e Data Final: Defina um intervalo de tempo para restringir a busca.

Após configurar os campos desejados, clique no botão "Filtrar" para atualizar a listagem.

***

### 2. Interpretando a Listagem de Logs

A tabela de resultados apresenta as seguintes colunas para análise rápida:

* Data/Hora: O momento exato da execução da tarefa;
* Usuário: Nome e e-mail de quem realizou a ação;
* Ação e Entidade: O tipo de modificação e o ID do recurso afetado (ex: `tickets #5934`);
* Método e Caminho: Informações técnicas da API (POST, PUT, DELETE) e a rota acessada;
* Status: Código de resposta do servidor (ex: 200 ou 201 para sucesso);
* IP: O endereço de rede de onde partiu a requisição, útil para identificar acessos suspeitos.

***

### 3. Detalhes do Log

Ao clicar no ícone de olho (visualizar) na última coluna de um registro, uma janela modal será aberta com os Detalhes do Log.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FjF3GsU3MmyOp57NBr5gf%2Fimage.png?alt=media&amp;token=0ef8742c-7349-4ec4-ab99-b1e5adc4b556" alt=""><figcaption></figcaption></figure>

Esta visão contém:

* User-Agent: Identificação do navegador e sistema operacional utilizado pelo usuário;
* Corpo da Requisição: Exibe o arquivo JSON com os dados exatos que foram enviados ao servidor para realizar aquela ação específica.

***

### 4. Exportação e Boas Práticas

Para manter a conformidade e segurança do ambiente, recomenda-se:

* Arquivamento Externo: Utilize o botão "Exportar CSV" (conforme disponível na interface) para baixar o histórico filtrado e armazená-lo em local seguro;

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FK2U37cQfODpgGJj85J3K%2Fimage.png?alt=media&amp;token=b06b95f4-4ba0-4066-ab57-c2f2e6b11d46" alt=""><figcaption></figcaption></figure>

* Auditoria Regular: Verifique periodicamente os logs de entidades sensíveis e ações de exclusão (DELETE);
* Investigação: Em caso de erros reportados por usuários, utilize o campo "Entidade" para rastrear as últimas modificações naquele recurso específico.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/configuracao-superadmin/sistema/sistema-dados-e-configuracao/log-de-auditoria.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.