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

> Historial de ejecución y diagnóstico de las ejecuciones de revisión de tu workspace: ejecuciones completadas, ignoradas, con error y en curso.

Audit Trail, también llamado Registro de actividad, registra las ejecuciones de revisión en tu workspace. Cada entrada es una única ejecución de revisión con su resultado (completada, ignorada, con error o en curso), además de los detalles de la ejecución que necesitas para diagnosticarla.

Usa `Consola > Audit Trail` para buscar ejecuciones, filtrar por periodo y abrir una ejecución para ver sus detalles.

<Note>
  Audit Trail es un registro de diagnóstico para ejecuciones de revisión. **No** registra cambios de configuración, cambios de miembros ni cambios de API keys. Esas acciones no se rastrean aquí.
</Note>

Haz seguimiento del estado de las revisiones, las decisiones y los hallazgos en el dashboard Ops. Usa Audit Trail para el historial de ejecución y el diagnóstico de las ejecuciones de revisión.

<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="Registro de actividad de Audit Trail que enumera las ejecuciones de revisión con distintivos de estado" width="2213" height="1262" data-path="images/console/audit-trail-list.png" />
</Frame>

## Cuándo usar

Usa Audit Trail para:

* investigar por qué una ejecución de revisión falló, fue ignorada o sigue en curso;
* confirmar si se ejecutó una revisión para un PR/MR determinado;
* inspeccionar los detalles y el diagnóstico de una ejecución específica;
* revisar el historial de ejecución de un repositorio;
* apoyar auditorías internas de la actividad de revisión.

Audit Trail no responde «¿quién cambió esta configuración?» ni «¿quién se agregó al workspace?». Solo refleja las ejecuciones de revisión.

## Quién puede acceder

Audit Trail requiere un administrador de workspace (los administradores de plataforma también tienen acceso). Los roles son conjuntos de capacidades fijos definidos por Acrity.

## Resultados de la ejecución

Cada ejecución se resuelve en uno de los siguientes estados:

| Resultado  | Significado                                                                                                                        |
| ---------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Completada | La ejecución de revisión terminó y produjo un resultado.                                                                           |
| Ignorada   | No se cumplieron las condiciones de activación, por lo que no se ejecutó ninguna revisión (por ejemplo, una rama o ruta ignorada). |
| Error      | La ejecución comenzó pero no pudo terminar. Ábrela para ver el detalle de diagnóstico.                                             |
| En curso   | La ejecución todavía se está ejecutando.                                                                                           |

```mermaid theme={null}
stateDiagram-v2
    [*] --> InProgress: Ejecución activada
    [*] --> Skipped: Condiciones de activación no cumplidas
    InProgress --> Completed: Revisión finalizada
    InProgress --> Error: Ejecución fallida
```

## Filtros comunes

| Filtro      | Propósito                                                                               |
| ----------- | --------------------------------------------------------------------------------------- |
| Periodo     | Restringe las ejecuciones por fecha de inicio y fin.                                    |
| Estado      | Filtra por resultado de la ejecución: completada, ignorada, con error o en curso.       |
| Repositorio | Filtra las ejecuciones asociadas a un repositorio específico.                           |
| Proveedor   | Filtra por proveedor de código u origen de integración.                                 |
| Búsqueda    | Encuentra ejecuciones por texto mostrado o identificador, como una referencia de PR/MR. |

## Investigar una revisión ausente

<Steps>
  <Step title="Abrir Audit Trail">
    Ve a `Consola > Audit Trail`.
  </Step>

  <Step title="Filtrar periodo">
    Elige un intervalo que incluya el horario esperado de la revisión.
  </Step>

  <Step title="Filtrar repositorio">
    Selecciona el repositorio relacionado con el PR/MR.
  </Step>

  <Step title="Revisar estado">
    Busca ejecuciones con error, ignoradas o en curso.
  </Step>

  <Step title="Abrir detalle">
    Abre la ejecución para ver la información disponible y la acción recomendada.
  </Step>

  <Step title="Corregir el origen">
    Si la ejecución apunta a una credencial, webhook, conector o regla de rama, ajusta la pantalla correspondiente.
  </Step>
</Steps>

## Buenas prácticas

* Filtra siempre por periodo antes de investigar.
* Usa el repositorio como filtro principal cuando el problema involucra actividad de revisión.
* Revisa primero las alertas en los menús de origen, como Credenciales o Repositorios.
* Registra los hallazgos relevantes en tu proceso interno.
* Recuerda que los cambios de configuración, de miembros y de API keys no están en este registro; usa en su lugar la pantalla correspondiente de la Consola.

## Problemas comunes

| Síntoma                                                 | Qué verificar                                                                   |
| ------------------------------------------------------- | ------------------------------------------------------------------------------- |
| No encuentro una ejecución esperada                     | Amplía el periodo, elimina los filtros y confirma el workspace seleccionado.    |
| La ejecución muestra una falla de credencial            | Ve a `Consola > Credenciales` o `Consola > Aplicaciones conectadas`.            |
| La ejecución muestra un problema de webhook             | Ve a `Consola > Repositorios` o `Consola > Webhooks`, según el tipo de webhook. |
| La ejecución indica que un conector está fuera de línea | Ve a `Consola > Conectores` y vuelve a validar la instalación local.            |
| No veo los detalles completos de la ejecución           | La vista puede depender del tipo de ejecución.                                  |

## Qué no publicar en auditorías externas

Al exportar o compartir evidencia fuera de tu organización:

* elimina tokens, secretos, URLs internas y datos personales innecesarios;
* comparte solo el periodo y las ejecuciones relevantes;
* sigue la política de seguridad de tu organización;
* usa canales aprobados para la comunicación con el soporte.

Los detalles sobre el tratamiento de datos están en [Tratamiento de datos](/es/security/data-handling).