O Audit Trail, também chamado de Log de Atividades, registra as execuções de review no seu workspace. Cada entrada é uma única execução de review com o seu resultado, concluída, ignorada, com erro ou em andamento, além dos detalhes da execução necessários para diagnosticá-la.
Use Console > Audit Trail para pesquisar execuções, filtrar por período e abrir uma execução para ver os detalhes.
O Audit Trail é um log de diagnóstico para execuções de review. Ele não registra alterações de configuração, alterações de membros nem alterações de API keys. Essas ações não são rastreadas aqui.
Acompanhe status, decisões e achados de review no dashboard Ops. Use o Audit Trail para o histórico de execução e o diagnóstico das execuções de review.
Quando usar
Use o Audit Trail para:
- investigar por que uma execução de review falhou, foi ignorada ou ainda está em andamento;
- confirmar se um review foi executado para um determinado PR/MR;
- inspecionar os detalhes e o diagnóstico de uma execução específica;
- revisar o histórico de execução de um repositório;
- apoiar auditorias internas da atividade de review.
O Audit Trail não responde “quem alterou esta configuração?” ou “quem foi adicionado ao workspace?”. Ele reflete apenas as execuções de review.
Quem pode acessar
O Audit Trail requer um admin de workspace. Os papéis são conjuntos fixos de capacidades definidos pela Acrity.
Resultados da execução
Cada execução resulta em um dos seguintes estados:
| Resultado | Significado |
|---|
| Concluída | A execução de review terminou e produziu um resultado. |
| Ignorada | As condições de acionamento não foram atendidas, então nenhum review foi executado (por exemplo, uma branch ou caminho ignorado). |
| Erro | A execução começou, mas não pôde ser concluída. Abra-a para ver o detalhe de diagnóstico. |
| Em andamento | A execução ainda está sendo executada. |
Filtros comuns
| Filtro | Para que serve |
|---|
| Período | Restringe as execuções por data inicial e final. |
| Status | Filtra pelo resultado da execução: concluída, ignorada, erro ou em andamento. |
| Repositório | Filtra as execuções associadas a um repositório específico. |
| Provedor | Filtra por provedor de código ou origem de integração. |
| Busca | Localiza execuções por texto exibido ou identificador, como uma referência de PR/MR. |
Investigar um review ausente
Abrir Audit Trail
Acesse Console > Audit Trail.
Filtrar período
Escolha um intervalo que inclua o horário esperado do review.
Filtrar repositório
Selecione o repositório relacionado ao PR/MR.
Revisar status
Procure execuções com erro, ignoradas ou em andamento.
Abrir detalhe
Abra a execução para ver as informações disponíveis e a ação recomendada.
Corrigir a origem
Se a execução apontar para uma credencial, webhook, conector ou regra de branch, ajuste a tela correspondente.
Boas práticas
- Sempre filtre por período antes de investigar.
- Use o repositório como filtro principal quando o problema envolver atividade de review.
- Verifique primeiro os alertas nos menus de origem, como Credenciais ou Repositórios.
- Registre os achados relevantes no seu processo interno.
- Lembre-se de que alterações de configuração, de membros e de API keys não estão neste log; use a tela correspondente do Console.
Problemas comuns
| Sintoma | O que verificar |
|---|
| Não encontro uma execução esperada | Amplie o período, remova os filtros e confirme o workspace selecionado. |
| A execução mostra uma falha de credencial | Vá para Console > Credenciais ou Console > Aplicativos conectados. |
| A execução mostra um problema de webhook | Vá para Console > Repositórios ou Console > Webhooks, conforme o tipo de webhook. |
| A execução indica que um conector está offline | Vá para Console > Conectores e revalide a instalação local. |
| Não vejo os detalhes completos da execução | A visualização pode depender do tipo de execução. |
O que não publicar em auditorias externas
Ao exportar ou compartilhar evidências fora da organização:
- remova tokens, segredos, URLs internas e dados pessoais desnecessários;
- compartilhe apenas o período e as execuções relevantes;
- siga a política de segurança da organização;
- use canais aprovados para comunicação com o suporte.
Detalhes sobre o tratamento de dados estão em Tratamento de dados.