Atividade Recente
Trilha de auditoria do sistema: quem executou cada ação, quando, a partir de qual IP e com qual resultado.
A tela de Atividade Recente é a trilha de auditoria do sistema. Cada ação relevante, como criar uma viagem, editar um veículo, excluir um local ou alterar o cargo de um usuário, gera um registro com ator, data e hora, IP, resultado e um identificador de rastreamento.
Os registros são imutáveis: não podem ser editados nem excluídos. A tela é de consulta.
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 | audit_logs.read |
Sem essa permissão, o item não é exibido no menu. A 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, ainda indisponível.
- Quatro cartões com os indicadores do período filtrado.
- Barra de filtros: busca e três seletores.
- Tabela de registros, com as colunas Data / hora, Ação e Resultado.
- Carregamento contínuo: novos registros são carregados conforme a rolagem, 25 por vez.
Os quatro indicadores
| Cartão | O que mostra |
|---|---|
| Eventos hoje | Quantos registros foram gerados hoje. À direita, o total no período filtrado. |
| Última atividade | Tempo desde o último evento, com a data e a hora. |
| Ação mais frequente | Qual é a ação mais comum e quantas vezes ela ocorreu. |
| Atores únicos | Quantos usuários distintos geraram os registros já carregados. |
Os indicadores respeitam os filtros: ao alterar o período ou o ator, eles são recalculados.
Os indicadores de eventos hoje, ação mais frequente e atores únicos são calculados sobre os registros já carregados na tela. Enquanto houver registros a carregar, a tela informa essa condição. O total do período é sempre exato.
Filtrar e buscar
Os quatro filtros podem ser combinados:
- Busca: feita no servidor a partir de 3 caracteres, considera a ação, o nome do ator e o resultado. O IP e o identificador de rastreamento não são pesquisados pela busca.
- Ator: um usuário específico, ou todos os atores.
- Ação: uma ação específica, apresentada pela descrição (por exemplo, Criou uma viagem), ou todas as ações.
- Período: últimas 24 horas, 7 dias, 30 dias ou todo o período. O padrão é 7 dias.
O botão Limpar aparece quando algum filtro está diferente do padrão.
Para auditar janelas longas, refine os filtros de ator, ação e período em lugar de percorrer todo o período sem critério.
Lendo a tabela
Cada linha apresenta três blocos:
- Data / hora do evento, no fuso da empresa.
- Ação: um ícone na cor do tipo de operação, a frase com o ator e a ação
(por exemplo, Ana Souza criou uma viagem) e, abaixo, o código da ação, por
exemplo
trips.create, com o início da identificação do registro afetado. - Resultado: a indicação Sucesso ou Falha.
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 |
| Laranja | Outras | Ações que não se enquadram nas categorias anteriores, como payments.record |
Ver detalhes de um registro
Clique em qualquer linha para abrir o diálogo Detalhes do registro.
Detalhes do registro
Criou uma viagem
trips.create
Campos exibidos:
- Cabeçalho: a descrição da ação e o código da ação.
- Data / hora: completa, no fuso da empresa.
- Ator: nome do usuário responsável pela ação.
- IP: endereço de origem da requisição.
- Resultado: a indicação Sucesso ou Falha, seguida do texto registrado pelo sistema.
- Recurso: a identificação do registro afetado, quando aplicável.
- Trace: o identificador da requisição, com um botão de cópia ao lado. Ao copiar, a tela confirma com a mensagem Trace ID copiado.
- Tenant e ID do registro: identificadores da empresa e do registro, utilizados no atendimento técnico.
O Trace é a informação mais útil no atendimento. Ao abrir um chamado, copie esse identificador e envie junto: a equipe consegue correlacionar o evento com os registros do servidor.
Carregamento contínuo
Os registros são carregados em blocos de 25 conforme a rolagem da página. O rodapé informa quantos registros já foram carregados sobre o total do período e, ao final, a indicação fim da lista. As contagens refletem o resultado filtrado, e não o total do sistema.
Lista vazia
Nenhum registro encontrado.
A lista vazia aparece quando nenhum registro atende aos filtros, o que é comum em períodos curtos com filtros restritivos. Amplie o período ou remova um filtro por vez.
Casos de uso comuns
| Situação | Como investigar |
|---|---|
| Identificar quem excluiu uma viagem | Período Últimas 24h e ação Excluiu uma viagem (código trips.delete). |
| Verificar por que uma alteração não foi salva | Filtre pelo próprio usuário, localize o evento e confira o resultado. |
| Registrar um chamado sobre um comportamento inesperado | Localize o evento, abra o detalhe e copie o Trace. |
| Levantar a auditoria do mês | Período Últimos 30 dias, sem outros filtros. |
Limitações atuais
- A exportação de registros ainda não está disponível: o botão fica desabilitado.
- A busca por texto é aplicada à ação, ao ator e ao resultado. O IP e o identificador de rastreamento não são pesquisados.
- O acesso ao sistema (login) não gera registro na trilha.
- Os registros são somente de leitura: não há edição nem exclusão.
Próximos passos
Use a Atividade Recente em conjunto com:
- Usuários e Perfis, para identificar o ator de cada evento.
- Cargos, para verificar se o usuário tinha permissão de executar a ação registrada.