Auditoria de Logs
O módulo de Auditoria de Logs centraliza o histórico de ações executadas no sistema, permitindo rastrear autenticações, alterações de dados, acessos a telas e chamadas HTTP.
Ele é essencial para:
- "Rastreabilidade" de operações críticas
- "Investigação" de inconsistências e incidentes
- "Conferência" de quem fez o quê, quando e em qual recurso
Visão Geral
A tela é composta por:
- "Cabeçalho" com título, botão "Atualizar" e menu de ações
- "Busca rápida" por rota, mensagem, usuário e e-mail
- "Filtros avançados" para refinar a consulta
- "Tabela de logs" com ordenação e paginação
- "Ação de detalhes" para abrir o evento completo
Acessando o Módulo
- Faça login com um usuário que possua permissão para o módulo "Auditoria"
- No menu lateral, acesse "Sistema > Auditoria de Logs"
- A listagem de eventos será exibida
Barra de Busca e Filtros
O campo de busca permite localizar registros por texto livre, incluindo termos como:
- rota HTTP
- mensagem do evento
- nome do usuário
- e-mail do usuário
Além da busca, o botão "Adicionar Filtro" abre o filtro avançado com os campos:
| Filtro | Descrição |
|---|---|
| "Período" | Intervalo de data/hora dos eventos |
| "Ação" | Tipo de ação (ex.: Login, Criação, Alteração, Exclusão, Acesso a relatório) |
| "Origem" | Origem técnica do evento (HTTP, Autenticação, Manual, Sistema) |
| "Recurso" | Entidade/recurso afetado (ex.: parceiros-negocios, billing) |
| "ID do Recurso" | Identificador do registro afetado |
| "ID do Usuário" | ID interno do usuário que gerou o evento |
| "Trace ID" | ID de rastreio da execução para correlação técnica |
Para auditorias técnicas, combine "Período" + "Trace ID". Isso acelera a identificação de toda a cadeia de eventos relacionados.
Listagem de Logs
A grade exibe os registros com ordenação por coluna e paginação no rodapé.
Colunas da tabela
| Coluna | Conteúdo |
|---|---|
| Data/Hora | Momento em que o log foi registrado |
| Ação | Classificação do evento com badge visual |
| Origem | Fonte do evento (ex.: Autenticação, HTTP) |
| Usuário | Nome e e-mail do usuário responsável |
| Recurso | Entidade afetada e, quando disponível, ID do registro |
| Detalhe | Método/rota HTTP, status e mensagem resumida |
| Ações | Botão de visualização detalhada |
Ações mais comuns
| Ação exibida | Significado |
|---|---|
| "Login" | Tentativa de autenticação bem-sucedida ou falha |
| "Criação" | Inclusão de novo registro |
| "Alteração" | Edição de dados existentes |
| "Exclusão" | Remoção de registro |
| "Acesso a tela/relatório" | Navegação e uso de recursos de consulta |
Botão Atualizar
O botão "Atualizar" recarrega a listagem com os filtros atuais, útil para monitoramento em tempo real durante testes ou suporte.
Detalhes do Log
Ao clicar no ícone de visualização (olho), o sistema abre o modal com os dados completos do evento.
O modal pode apresentar as seguintes seções (conforme o tipo de evento):
| Seção | Informações |
|---|---|
| Resumo | Ação, origem, data/hora, Trace ID e ID do log |
| Usuário | Nome, e-mail, ID, perfil e indicação de super admin |
| HTTP | Método, rota, status, duração, IP e user-agent |
| Dados afetados | Recurso, ID do recurso, mudanças, estado anterior e posterior |
| Erro | Tipo da exceção, mensagem e status |
| Contexto adicional | JSON complementar enviado pelo sistema |
No modal, campos como Trace ID e ID do log possuem ação de cópia para facilitar abertura de chamados e correlação com logs técnicos.
Paginação e Ordenação
- A listagem trabalha com paginação (ex.: 50 registros por página)
- É possível ordenar por colunas como "Data/Hora", "Ação", "Origem" e "Usuário"
- O padrão é abrir com ordenação decrescente por "Data/Hora" (mais recentes primeiro)
Boas Práticas
- Sempre filtre por "Período" antes de investigar um caso
- Use "Trace ID" para mapear uma execução específica ponta a ponta
- Em eventos de alteração, confira os blocos de "Estado Anterior" e "Estado Após" para validar o que mudou
- Para incidentes de acesso, combine filtros de "Ação" + "Usuário" + "Origem"
- Mantenha o uso de contas administrativas restrito e monitore eventos de autenticação com frequência