> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acrity.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit Trail

> Histórico de execução e diagnóstico das execuções de review do seu workspace: execuções concluídas, ignoradas, com erro e em andamento.

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.

<Note>
  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.
</Note>

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.

<Frame>
  <img src="https://mintcdn.com/techdriven/eiJQrWxdoD9fo1DY/images/console/audit-trail-list.png?fit=max&auto=format&n=eiJQrWxdoD9fo1DY&q=85&s=b9900da137b5f42d1f786ad2f869db2c" alt="Log de atividades do Audit Trail listando as execuções de review com selos de status" width="2213" height="1262" data-path="images/console/audit-trail-list.png" />
</Frame>

## 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.                                                                                            |

```mermaid theme={null}
stateDiagram-v2
    [*] --> InProgress: Execução acionada
    [*] --> Skipped: Condições de acionamento não atendidas
    InProgress --> Completed: Review finalizado
    InProgress --> Error: Execução falhou
```

## 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

<Steps>
  <Step title="Abrir Audit Trail">
    Acesse `Console > Audit Trail`.
  </Step>

  <Step title="Filtrar período">
    Escolha um intervalo que inclua o horário esperado do review.
  </Step>

  <Step title="Filtrar repositório">
    Selecione o repositório relacionado ao PR/MR.
  </Step>

  <Step title="Revisar status">
    Procure execuções com erro, ignoradas ou em andamento.
  </Step>

  <Step title="Abrir detalhe">
    Abra a execução para ver as informações disponíveis e a ação recomendada.
  </Step>

  <Step title="Corrigir a origem">
    Se a execução apontar para uma credencial, webhook, conector ou regra de branch, ajuste a tela correspondente.
  </Step>
</Steps>

## 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](/pt-BR/security/data-handling).