Usuários Avançado 5 min de leitura

Usuários - Auditoria e Logs de Atividade

Página de auditoria que lista todas as ações registradas na sua empresa (criação, alteração, exclusão, restauração, login, check-in e mais), com filtros por usuário, tipo de entidade, ação e período. Permite abrir o detalhamento campo a campo (antes/depois) de cada alteração e exportar até 10.000 linhas em CSV para auditoria externa.

Atualizado em 12/08/2026

Log de Auditoria

Tutorial em vídeo · 3:30 · gravado em 19/09/2026

Abrir na biblioteca de vídeos

Usuários - Auditoria e Logs de Atividade

O que é

A página de Auditoria é o registro centralizado de tudo que acontece no empresa: criação, alteração, exclusão e restauração de registros, além de eventos como login, logout, login falho, check-in, check-out e cancelamentos. Cada linha guarda quem fez, quando, em qual entidade, o IP de origem e - quando aplicável - o valor anterior e o valor novo de cada campo alterado.

O Proprietário ou Gerente normalmente chega aqui para investigar uma alteração suspeita (um valor que mudou sem aviso, um cadastro excluído), para auditar acessos em uma janela específica ou para gerar uma planilha em CSV exigida por um auditor externo. Por se tratar de dado sensível, a visualização é restrita à permissão de ver a auditoria.

Como usar

  1. Vá em Relatórios > Auditoria no menu lateral.
  2. Observe os três cartões no topo: Total de registros, Registros hoje e Tipos de entidade - dão uma noção do volume.
  3. Use a barra de filtros logo abaixo para encontrar o registro que precisa:
    • Busca - texto livre sobre nome do usuário, tipo da entidade ou nome da ação.
    • Tipo - entidade auditada (ex.: Cliente, Excursão, Pagamento, User, Role).
    • Ação - Criado, Atualizado, Excluído ou Restaurado.
    • Usuário - origem da ação: Admin, Cliente, Guia ou Sistema.
    • Data início / Data fim - recorta por período.
  4. Os filtros aplicam automaticamente conforme você escolhe; o ícone "X" da barra limpa todos de uma vez.
  5. Para abrir o detalhamento de uma linha, clique em Ver detalhes (botão azul à direita do item). O modal mostra:
    • Data/hora completa e relativa ("há 3 horas");
    • Tipo, ação colorida, usuário e tipo de usuário;
    • Entidade e ID afetados, IP de origem;
    • Tabela Alterações com colunas Campo / Antes / Depois quando há diff calculado (campos que realmente mudaram entre old_values e new_values);
    • Blocos Valores Anteriores e Valores Novos em JSON quando o diff não pode ser calculado;
    • Metadados adicionais, URL da requisição e Dispositivo (User-Agent) quando disponíveis.
  6. Para extrair tudo que está visível com os filtros atuais, clique no botão verde de download (último ícone da barra de filtros) - gera um CSV com BOM UTF-8 (abre direto no Excel) com até 10.000 linhas.

Casos especiais

Ação "Sistema" sem usuário identificado

Quando o registro foi gerado por um cron, job ou observer (sem usuário logado), o campo Usuário aparece como Sistema e o filtro Usuário > Sistema isola só esse tipo. É o esperado em ações automáticas, como sincronização noturna ou cancelamento automático por vencimento.

Login falho

A ação login_failed aparece em vermelho na lista. Use o filtro Ação (seleciona Criado/Atualizado/Excluído/Restaurado) combinado com a busca livre por login_failed para investigar tentativas suspeitas. O campo IP do detalhamento ajuda a identificar a origem.

Registro sem diff (apenas valores brutos)

Em ações antigas ou em criações/exclusões, pode não existir diff calculado entre antes/depois. Nesse caso o modal exibe blocos Valores Anteriores e Valores Novos em JSON puro, para inspeção manual.

Exportação acima de 10.000 linhas

A exportação CSV é limitada a 10.000 registros por arquivo. Para janelas maiores, restrinja o período (Data início / Data fim) e gere o relatório em lotes - cada chamada respeita os filtros ativos no momento do clique.

Filtros vindos por URL

Links externos (incluindo da Vivi) podem pré-aplicar filtros via query string, ex.: /admin/auditoria?tipo=Cliente&acao=updated. A barra exibe os filtros já preenchidos e o "limpar" volta para a listagem completa.

Erros comuns e como resolver

  • "Esta página requer permissão (403)" - Causa: o usuário não tem permissão de ver a auditoria. Solução: peça ao Proprietário para conceder a permissão em Configurações > Papéis e Permissões.
  • "Nenhum registro encontrado" (estado vazio da lista) - Causa: combinação de filtros muito restritiva, especialmente período sem movimentação. Solução: limpe os filtros pelo botão "X" e refaça a busca ampliando a janela de datas.
  • "CSV abre com caracteres estranhos" - Causa: o Excel ignorou o BOM UTF-8 (raro). Solução: importe pelo Excel via Dados > De Texto/CSV escolhendo "Unicode (UTF-8)" como codificação; o separador é ;.

Onde encontrar

  • URL: /admin/auditoria
  • Caminho no menu: Relatórios > Auditoria
  • Permissão necessária: ver a auditoria
  • Módulo necessário: nenhum

Veja também

  • Gestão de Usuários do Sistema
  • Gerenciar Papéis e Permissões
  • Editar e Desativar Usuários
  • Cadastrar Novo Usuário

Este artigo foi útil?

Obrigado pelo seu feedback!

Neste artigo

Comece a usar agora

Crie sua conta e teste grátis por 7 dias, com acesso a todas as funcionalidades.

Testar Grátis