# 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="/files/cVJBcIAWWW3DAOlfbPhh" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/4YJcHgV8AxM5IHImxnp5" 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;
  * Login / Logout: Monitoramento de acessos e saídas de usuários;
  * 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="/files/Hsv3H2TyaqShPK9HFO8m" 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="/files/n0ezf2ARMONmiWr60NhD" 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: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.