Audit Logs
Audit logs
O que são
Os Audit Logs (Logs de Auditoria) são um mecanismo de rastreabilidade, segurança e governança do ENSPACE. Eles registram automaticamente todas as ações executadas por usuários e sistemas (via API) na plataforma, fornecendo um histórico detalhado de alterações.
Os registros permitem auditorias completas, análises de conformidade e investigação de incidentes --- sem necessidade de qualquer configuração prévia. Tudo é capturado automaticamente.
Como Acessar
Acesse as Configurações do workspace → Logs → Audit Logs.
O que é Registrado
A tabela de Audit Logs traz uma coluna para cada informação do registro:
| Coluna | Descrição |
|---|---|
| ID | Identificador do registro de auditoria. |
| Data | Dia em que a ação foi realizada. |
| Mensagem | Descrição da ação em texto corrido, informando quem fez o quê e onde. |
| Modelo | O elemento do workspace que foi afetado: uma categoria, os campos de uma categoria, um grupo, um convite, entre outros. |
| Membro | Membro ou integração via API que executou a ação, com nome, e-mail e tipo de acesso. |
| Ação | Tipo da operação realizada, identificado por um rótulo colorido. |
| Referência | Código de referência do registro afetado. |
Visualizando os Registros
Listagem de Logs
A tela principal exibe os registros em formato de tabela, ordenados cronologicamente do mais recente para o mais antigo. Cada linha representa uma ação registrada.
Detalhe de um Registro
Clique em qualquer registro para abrir o painel de detalhes à direita. Ele tem três abas:
| Aba | O que mostra |
|---|---|
| Resumo | Quem executou a ação, com e-mail e tipo de acesso, o modelo afetado, o tipo de ação e o bloco Mudanças, que lista cada campo alterado com o valor anterior à esquerda e o novo à direita. |
| Pós-Ação | O conteúdo completo do registro depois da ação, no formato técnico. |
| Pré-Ação | O conteúdo completo do registro antes da ação, no mesmo formato. |
Em registros de criação a aba Pré-Ação fica desabilitada, porque não existe estado anterior ao da criação.
Como visualizar o detalhe
- Na tela de Audit Logs, localize o registro desejado na tabela.
- Clique sobre o registro.
- O painel lateral se abre na aba Resumo, com a comparação campo a campo em Mudanças.
- Abra Pré-Ação ou Pós-Ação para ver o registro inteiro antes e depois da ação.
Filtrando os Registros
A tela de Audit Logs conta com filtros adaptativos que podem ser combinados para localizar registros com precisão.
Campo / Opção Descrição
Filtro por coluna Disponível em cada coluna da tabela. Abre um seletor com busca integrada para filtrar por usuário, tipo de ação, recurso afetado e outros atributos.
Filtro de data Acessado pelo botão no canto superior esquerdo, ao lado da caixa de busca. Permite selecionar um dia único ou um intervalo de datas.
Filtros combinados Filtros por coluna e por data podem estar ativos simultaneamente. Os resultados respeitam todas as condições aplicadas.
Limpar filtros Botão que remove todos os filtros ativos de uma só vez, restaurando a listagem completa.
Reset automático de paginação Sempre que um filtro é alterado, a paginação retorna automaticamente à primeira página.
Como Usar os Filtros
- Clique no ícone de filtro da coluna desejada para abrir o seletor com busca integrada.
- Selecione os valores que deseja filtrar. A tabela é atualizada em tempo real.
- Para filtrar por data, clique no botão de período, onde aparece Em todo o período, e escolha Dia único ou Intervalo no calendário.
- Combine filtros de diferentes colunas e de data conforme necessário.
- Para desfazer um filtro, use Limpar dentro do seletor da coluna ou o X ao lado do período escolhido.
Tipos de Ações Registradas
O filtro da coluna Ação lista os tipos que o workspace registra:
| Ação | Quando aparece |
|---|---|
| Criou | Um registro, campo, categoria, membro, fluxo ou qualquer outro recurso foi criado no workspace. |
| Atualizou | Dados de um registro, campo, configuração ou estrutura existente foram alterados. |
| Deletou | Um recurso foi removido do workspace. |
| Descartou | Um recurso foi enviado para a lixeira. |
| Restaurou | Um recurso descartado voltou para o workspace. |
| Arquivou | Um recurso foi arquivado. |
| Desarquivou | Um recurso arquivado voltou a ficar ativo. |
Ações disparadas por integrações externas via API aparecem na mesma tabela, identificadas na coluna Membro.
Request Logs
Além dos Audit Logs, o ENSPACE mantém registros detalhados de cada requisição feita à API --- os Request Logs. Eles são complementares aos Audit Logs e voltados principalmente para depuração, análise de performance e rastreamento de falhas em integrações.
Campo / Opção Descrição
Audit Logs Registram O QUÊ foi feito: ação, usuário, recurso afetado e mudança antes/depois. Foco em governança e rastreabilidade.
Request Logs Registram COMO foi feito: detalhes técnicos de cada chamada à API (endpoint, status de resposta, tempo de execução). Foco em debug e integração.
ℹ Os Request Logs são acessados em Configurações → Logs → Request Logs.
Boas Práticas
- Monitore eventos críticos com frequência: exclusões em massa, alterações de permissões e ações de integrações externas.
- Revise os logs após mudanças estruturais no workspace --- novos campos, categorias, fluxos ou alterações de membros.
- Use os filtros de coluna e data combinados para isolar rapidamente o intervalo ou o usuário que deseja auditar.
- Utilize os registros para auditorias internas, resolução de conflitos e validação de processos.
- Em caso de comportamento inesperado em uma integração, cruze os Audit Logs com os Request Logs para identificar a origem do problema.