---
title: Auditoria
description: Consulte a trilha de auditoria do tenant, busque por segmentos como e-mail, IP ou resultado e filtre por período.
updated: 2026-09-27
---

A página **Auditoria** mostra quem fez o quê no tenant, de onde e com que resultado. A trilha fica guardada por 365 dias.

## Antes de começar

Você precisa da permissão `audit.read`. O papel **Tenant Admin** tem essa permissão.

## Buscar na trilha

1. Acesse **Administração** > **Acesso** > **Auditoria**.
2. Escolha o período.
3. Digite o termo na busca. Texto livre pesquisa em todos os campos. Um segmento no formato `campo:valor` pesquisa apenas naquele campo.

A busca aceita vários segmentos combinados, por exemplo: `email:ana@x.com ip:203.0.113. resultado:denied`. Use aspas para valores com espaço.

## Segmentos da busca

| Segmento | Procura em | Exemplo |
|---|---|---|
| `email` | E-mail de quem fez a ação. Aceita parte do e-mail. | `email:ana@x.com` |
| `ator` ou `id` | ID de quem fez a ação. | `ator:<id>` |
| `ip` | IP de origem. Um prefixo cobre a faixa inteira. | `ip:203.0.113.` |
| `req` | ID da requisição (Request ID). | `req:<id>` |
| `acao` | Ação registrada. | `acao:<ação>` |
| `resultado` | Resultado da ação. | `resultado:denied` |
| `tenant` | Tenant em que a ação aconteceu. | `tenant:<id>` |
| `tipo` | Tipo de alvo da ação. | `tipo:<tipo>` |
| `alvo` | ID do alvo da ação. | `alvo:<id>` |
| `metodo` | Método HTTP da requisição. | `metodo:POST` |
| `rota` | Rota da requisição. Aceita parte da rota. | `rota:<rota>` |

## Resultados

| Resultado | Na busca | O que significa |
|---|---|---|
| **Sucesso** | `resultado:success` | A ação foi concluída. |
| **Negado** | `resultado:denied` | A ação foi recusada. |
| **Falha** | `resultado:failure` | A ação foi tentada e retornou erro. |

## Período

| Opção | Alcance |
|---|---|
| **Últimas 24 horas** | O último dia. |
| **Últimos 7 dias** | A última semana. É o padrão. |
| **Últimos 30 dias** | O último mês. |
| **Todo o histórico** | Tudo o que está guardado, até 365 dias. |
| **Período personalizado** | As datas que você escolher. |

## Filtros avançados

Para montar a busca campo a campo, selecione **Filtros avançados**. O painel reúne os mesmos segmentos da busca, agrupados por ator, ação e alvo, requisição negada e período.

1. Preencha os campos desejados.
2. Selecione **Aplicar filtros**.

Para voltar à trilha completa, selecione **Limpar tudo**.

:::tip
Os filtros ficam no endereço da página. Copie o link para compartilhar a mesma busca com outra pessoa do tenant.
:::

---

> Guardnet Docs · https://docs.guardnet.com.br/pt-br/advisor/administracao/auditoria/
> Índice da documentação: https://docs.guardnet.com.br/pt-br/llms.txt