# Registros de auditoría

> Qué recoge el registro de auditoría de AI CodeOps, cómo leerlo y filtrarlo en Measure → Audit Log, quién puede verlo y cuánto tiempo se conservan las entradas en cada plan.

Fuente: https://aicodeops.dev/es/docs/audit-logs · Última actualización: 2026-10-18

El registro de auditoría recoge quién cambió qué en un espacio de trabajo: miembros y roles, claves, proveedores, proyectos, cuentas de Git, políticas, agentes, programaciones, presupuestos, secretos, aprobaciones, el triaje de hallazgos, el código que generan las sesiones de IA y cada sesión que se lanzó o se canceló. Cada entrada tiene una hora, la persona que actuó, el destino, la dirección IP cuando se conoce y una breve descripción.

## Qué se registra

| Área                        | Acciones                                                                                                            |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Miembros y roles            | `member.invited`, `member.removed`, `role.changed`                                                                  |
| Claves de API               | `apikey.created`, `apikey.revoked`, `apikey.scope.updated`, `apikey.scope.removed`                                  |
| Proveedores de modelos      | `provider.credential.added`, `provider.credential.removed`                                                          |
| Políticas y presupuestos    | `policy.updated`, `budget.updated`                                                                                  |
| Secretos                    | `secret.created`, `secret.updated`, `secret.toggled`, `secret.deleted`                                              |
| Aprobaciones                | `approval.decided`, `approval.canceled`                                                                             |
| Agentes y herramientas      | `agent.created`, `agent.updated`, `agent.deleted`, `mcp_server.created`, `mcp_server.updated`, `mcp_server.deleted` |
| Marketplace                 | `marketplace.installed`, `marketplace.uninstalled`                                                                  |
| Programaciones              | `schedule.created`, `schedule.updated`, `schedule.deleted`                                                          |
| Código generado             | `session.code.edited`, `session.code.created`, `session.code.deleted`                                               |
| Sesiones                    | `session.started`, `session.canceled` (con el motivo indicado)                                                      |
| Proyectos                   | `project.created`, `project.updated` (incluidos archivar y restaurar), `project.deleted`                            |
| Cuentas de Git              | `git_connection.created`, `git_connection.removed`                                                                  |
| Hallazgos                   | `finding.triaged` (el estado antes y después)                                                                       |
| Despliegues                 | `deployment.recorded`, `deployment.status_changed`, `deploy_target.updated`                                         |
| Evidencias y uso compartido | `change.evidence_exported`, `workspace.share_enabled`, `workspace.share_disabled`                                   |
| Espacio de trabajo          | `workspace.updated`                                                                                                 |

Las entradas `session.code.*` registran las ediciones que una persona hace en el código que generó una sesión, antes de que se convierta en un pull request.

Las sesiones lanzadas, los cambios de proyecto y las cuentas de Git se registran desde el 15 de noviembre de 2026, y el triaje de hallazgos desde el 16 de noviembre de 2026. Las entradas se escriben cuando ocurre el hecho y nunca se añaden después, así que las anteriores no están en el registro. La página lo indica mientras tu plan siga conservando entradas anteriores a esas fechas.

Los inicios de sesión, los cambios de dos pasos y la configuración de SSO también se registran, pero para la cuenta o la organización y no para un espacio de trabajo. No aparecen en la página Audit Log de un espacio de trabajo, y se conservan 7 días en todos los planes.

## Leer el registro de auditoría

1. Abre **Measure → Audit Log**.
2. Para acotarlo, elige una acción en **Action**. La lista solo ofrece las acciones que este espacio de trabajo ha registrado. **All actions** lo muestra todo.
3. Usa **← Prev** y **Next →** para pasar de página, de 50 en 50 entradas.

Cada fila muestra **When**, **Action**, **Account**, **Target**, **IP** y **Detail**. **Account** es la persona que actuó, por nombre o por correo electrónico. Pasa el cursor por encima para ver el ID de la cuenta. Alguien que ha dejado desde entonces el espacio de trabajo aparece como un ID abreviado.

Para tener una visión más amplia de lo que ocurrió en el espacio de trabajo, incluidas las sesiones y los despliegues, sigue el enlace **Activity feed →** de la parte superior de la página.

## Quién puede leerlo

Leer el registro de auditoría requiere el permiso audit-read. Lo tienen los roles Owner, Admin y Security Admin; los roles Developer, Member y Viewer no. Un rol personalizado puede incluirlo. Sin él, la página lo indica y te pide que contactes con un administrador del espacio de trabajo. Consulta [Roles y permisos](https://aicodeops.dev/es/docs/roles-and-permissions).

## Conservación

Cuánto tiempo se conservan las entradas depende del plan de tu organización:

| Plan       | Se conservan                    |
| ---------- | ------------------------------- |
| Free       | 7 días                          |
| Individual | 30 días                         |
| Pro        | 90 días                         |
| Enterprise | Mientras exista la organización |

Las entradas más antiguas se eliminan una vez al día. Los mismos plazos se aplican a las decisiones de política que se muestran en **Secure → Policies**.

- Las entradas de un espacio de trabajo eliminado se eliminan a los 7 días.
- Las entradas de inicio de sesión, de dos pasos y otras entradas a nivel de cuenta se conservan 7 días en todos los planes.

Más información en [Conservación de datos](https://aicodeops.dev/es/docs/data-retention).

## Exportación

No hay exportación de auditoría en la beta abierta. Para conservar un registro fuera de AI CodeOps:

- Los [paquetes de evidencias](https://aicodeops.dev/es/docs/evidence-packs) te dan un registro firmado de un único cambio, incluidas su revisión y su aprobación.
- La exportación de los datos de tu cuenta, en **Configure → Settings → Your data**, incluye tus propios eventos de auditoría.

## Siguientes pasos

- [Roles y permisos](https://aicodeops.dev/es/docs/roles-and-permissions)
- [Conservación de datos](https://aicodeops.dev/es/docs/data-retention)
- [Auditoría y RBAC](https://aicodeops.dev/es/product/audit-rbac)

## Preguntas frecuentes

### ¿Puedo exportar el registro de auditoría?

Todavía no. No hay botón de exportación en la beta abierta. Tus propios eventos de auditoría se incluyen en la exportación de los datos de tu cuenta.

### ¿Quién puede leer el registro de auditoría?

Los roles Owner, Admin y Security Admin, o cualquier rol personalizado con el permiso audit-read.

### ¿Cuánto tiempo se conservan las entradas de auditoría?

Las entradas del espacio de trabajo se conservan 7 días en Free, 30 días en Individual, 90 días en Pro y mientras exista la organización en Enterprise. Las entradas de cuenta y de SSO se conservan 7 días en todos los planes.
