Atividade Recente
Trilha de auditoria completa — quem fez o quê, quando e a partir de qual IP. Use para diagnosticar problemas, investigar incidentes ou conferir mudanças.
A tela de Atividade Recente é a trilha de auditoria do sistema. Cada ação relevante — criar viagem, editar veículo, excluir lugar, fazer login — gera um registro com ator, data/hora, IP, resultado e um trace ID rastreável.
Os registros são imutáveis. Você não consegue editar nem excluir um log. Use a tela para consultar, não para alterar.
Onde encontrar
Menu lateral → Gestão → Atividade Recente. URL direta:
/management/audit-logs.
Permissões necessárias
| Ação | Permissão exigida |
|---|---|
| Visualizar a tela | auditLogs:read |
Sem essa permissão, o item de menu nem aparece. Auditoria normalmente fica restrita a perfis administrativos.
A tela em um relance
Atividade Recente
Rastreabilidade completa de ações realizadas no sistema.
De cima para baixo:
- Cabeçalho com o botão Exportar logs (em breve — fica desabilitado).
- Quatro cartões de estatísticas do período filtrado.
- Barra de filtros — busca livre + 3 menus suspensos.
- Tabela de registros, com colunas Data / hora e Ação.
- Paginação — 15 registros por página.
Os quatro indicadores
| Cartão | O que mostra |
|---|---|
| Eventos hoje | Quantos registros foram gerados hoje. À direita, total no período filtrado. |
| Última atividade | Tempo relativo desde o último evento (ex.: há 3 min) + data/hora curta. |
| Ação mais frequente | Quantas vezes a ação mais comum apareceu, e qual ação é. |
| Atores únicos | Quantos usuários diferentes geraram eventos no período. |
Os números respeitam os filtros — mude o período ou o ator e os indicadores recalculam.
Filtrar e buscar
Você combina quatro filtros:
- Busca livre — casa com nome do ator, código da ação, IP e trace ID.
- Ator — escolha um usuário específico, ou Todos os atores.
- Ação — escolha um código de ação (ex.:
trip.create), ou Todas. - Período — Últimas 24h, 7 dias, 30 dias ou Todo período. Padrão: 7 dias.
O botão Limpar aparece quando há qualquer filtro diferente do padrão.
O backend devolve no máximo 200 registros por consulta. Para auditar janelas longas, refine os filtros (ator + ação + período) em vez de pedir "todo período" sem critério.
Lendo a tabela
Cada linha tem dois blocos:
- Esquerda — data e hora (segundo a segundo).
- Direita — ícone colorido conforme o tipo de ação, descrição
humanizada e, abaixo, o código bruto (
trip.create) e os primeiros 8 caracteres do ID do recurso afetado.
As cores classificam o tipo de operação:
| Cor | Categoria | Exemplos |
|---|---|---|
| Verde | Criação | *.create, *.add |
| Azul | Edição | *.update, *.edit |
| Vermelho | Exclusão | *.delete, *.remove |
| Âmbar | Autenticação | auth.login |
| Salmão | Outras | Qualquer ação que não case |
Ver detalhes de um registro
Clique em qualquer linha para abrir o diálogo completo.
Detalhes do registro
Criou viagem
trip.create
Campos exibidos:
- Cabeçalho — descrição humanizada + código bruto + selo Sucesso/Falha.
- Data / hora — completa, fuso local.
- Ator — nome e iniciais coloridas (cor derivada do ID do usuário).
- IP — endereço de origem da requisição.
- Resultado — payload bruto retornado pela API (JSON).
- Recurso — UUID do objeto afetado (quando aplicável).
- Trace — ID de rastreamento da requisição, com botão Copiar para colar em chamados de suporte.
- Tenant e ID do registro — úteis para reportar bugs ao time técnico.
O Trace ID é a peça mais importante para suporte. Ao abrir um chamado sobre um comportamento estranho, copie o trace e envie junto — o time consegue correlacionar com logs de servidor instantaneamente.
Paginação
15 registros por página. Os contadores refletem o resultado filtrado, não o total absoluto do sistema.
Estado vazio
Nenhum registro encontrado.
Tente ampliar o período ou remover filtros.
Aparece quando os filtros não casam com nenhum registro. Comum em períodos curtos com filtros restritivos — amplie o período ou remova um filtro de cada vez.
Casos de uso comuns
| Situação | Como investigar |
|---|---|
| "Quem excluiu aquela viagem ontem?" | Período = 24h, Ação = trip.delete, busca pelo ID/nome no resultado. |
| "Por que minha alteração não persistiu?" | Filtre pelo seu usuário, encontre o evento e veja o selo Sucesso/Falha. |
| "Reportar bug — comportamento esquisito ao salvar" | Encontre o evento, abra o detalhe e copie o Trace ID para o chamado. |
| "Auditoria do mês para o cliente" | Período = 30 dias, sem outros filtros, exporte (quando disponível). |
Limitações atuais
- Exportar logs está marcado como em breve — botão desabilitado.
- A consulta traz no máximo 200 registros; se sua busca atinge esse teto, refine os filtros para garantir que está vendo o universo correto.
- Logs são somente leitura — não há como editar ou apagar entradas.
Próximos passos
Use a Atividade Recente em conjunto com:
- Usuários e Perfis — para identificar quem é o ator de cada evento.
- Cargos — para entender por que um usuário tinha (ou não) permissão de executar a ação registrada.