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

# Logs de auditoría

> Rastrea cambios instrumentados de configuración y operaciones de reconciliación con un registro filtrable, que permite detectar manipulaciones, para resolución de problemas.

La página **Logs de auditoría** en la Matcher UI proporciona un registro filtrable de cambios instrumentados realizados en la configuración y operaciones de reconciliación. Úsala para investigar el actor, la acción y la hora registrada en esos flujos.

## Acceder a la página de Logs de auditoría

***

Navega a **Matcher → Reportes → Registros de auditoría** en la barra lateral izquierda.

<Note>
  Necesitas tener el rol de administrador o acceso de lectura a los logs de auditoría para abrir esta página.
</Note>

## Verificar la integridad de la cadena

***

El panel **Prueba de manipulación** aparece encima de los filtros. Haz clic en **Verificar integridad** para volver a verificar la cadena de hashes de auditoría del inquilino. La comprobación es de solo lectura — nunca altera un registro — y devuelve uno de dos veredictos:

| Veredicto                               | Significado                                                                                                                                                                        |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cadena íntegra**                      | Cada registro inspeccionado enlaza con el anterior y coincide con su hash almacenado. El panel informa cuántos registros se verificaron.                                           |
| **Cadena MANIPULADA — integridad rota** | La cadena de hashes está rota en una posición indicada. El registro de auditoría ya no puede considerarse confiable para detectar manipulaciones. Escala el problema de inmediato. |

<Note>
  Si la cadena es más larga que el límite de inspección, el veredicto de integridad indica que solo se inspeccionaron los primeros registros desde el inicio de la cadena y que las entradas más recientes no se comprobaron. Una solicitud fallida muestra un error con un botón **Reintentar** — no es un veredicto.
</Note>

## Filtros

***

Usa la barra de filtros para acotar los resultados. **Actor** es un campo de texto libre de hasta 255 caracteres. **Acción** y **Tipo de entidad** son campos de texto libre de hasta 50 caracteres cada uno; ninguno es una lista desplegable:

| Filtro              | Descripción                                                                               |
| ------------------- | ----------------------------------------------------------------------------------------- |
| **Actor**           | El identificador de actor sin procesar registrado con el cambio (por ejemplo, `user-123`) |
| **Acción**          | La operación realizada (por ejemplo, `CREATE`, `UPDATE`, `DELETE`)                        |
| **Tipo de entidad** | El tipo de recurso que se modificó (por ejemplo, `context`)                               |
| **Fecha inicial**   | Fecha de inicio del rango de tiempo                                                       |
| **Fecha final**     | Fecha de fin del rango de tiempo                                                          |

Haz clic en **Aplicar filtros** para ejecutar la búsqueda. Aplicar filtros restablece la paginación a la primera página.

## Tabla de logs de auditoría

***

<Frame caption="Figura 1. Tabla de Logs de auditoría.">
  <img src="https://mintcdn.com/lerian-49cb71fc/SFzzdxyH5SN7w_fC/es/matcher/ui/images/11-audit-logs.jpg?fit=max&auto=format&n=SFzzdxyH5SN7w_fC&q=85&s=f5efe243e2e5a0d633cc5ec0b2957538" alt="Tabla de Logs de auditoría de Matcher que enumera las acciones registradas de usuarios y del sistema" width="2000" height="1258" data-path="es/matcher/ui/images/11-audit-logs.jpg" />
</Frame>

Cada fila de la tabla muestra las siguientes columnas:

| Columna             | Descripción                                                                                                                                              |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Registro**        | El ID del registro de auditoría, mostrado como un enlace a una página de detalle dedicada para esa entrada — útil para pegarlo en un ticket de incidente |
| **Registrado el**   | Cuándo se registró el cambio                                                                                                                             |
| **Acción**          | La operación realizada                                                                                                                                   |
| **Tipo de entidad** | El tipo de recurso que se modificó                                                                                                                       |
| **ID de entidad**   | Identificador del recurso afectado                                                                                                                       |
| **Actor**           | El identificador de actor sin procesar registrado con el cambio (por ejemplo, `user-123`), no un nombre resuelto de persona o sistema                    |
| **Cadena**          | La posición del registro en la cadena (`n.º <secuencia>`) y su hash. Los registros anteriores a la cadena de hashes muestran **Sin prueba de cadena**    |
| **Cambios**         | Un botón **Ver** que abre la carga JSON de auditoría registrada. Las filas sin cambios JSON muestran un marcador de posición                             |

Usa los botones **Anterior** y **Siguiente** en el pie de la tabla para paginar los resultados. El pie también muestra el número de página actual y la cantidad de eventos en esa página.

## Ver el detalle de los cambios

***

<Frame caption="Figura 2. Panel de cambios del log de auditoría mostrando la carga JSON de auditoría registrada.">
  <img src="https://mintcdn.com/lerian-49cb71fc/SFzzdxyH5SN7w_fC/es/matcher/ui/images/12-audit-logs-expanded.jpg?fit=max&auto=format&n=SFzzdxyH5SN7w_fC&q=85&s=de8c8bbf63237111a45b01b7d331fdc6" alt="Entrada de log de auditoría de Matcher que muestra la carga JSON de auditoría registrada" width="1556" height="862" data-path="es/matcher/ui/images/12-audit-logs-expanded.jpg" />
</Frame>

Haz clic en **Ver** en la columna **Cambios** para abrir el panel **Cambios del log de auditoría**. El panel describe el cambio registrado (acción, tipo de entidad e ID de entidad) y luego muestra la carga JSON de auditoría registrada como un bloque formateado. Sus campos dependen de la operación; no garantiza un esquema de valores anteriores y nuevos.

También puedes hacer clic en el ID de la columna **Registro** para abrir una página de detalle dedicada para esa entrada.

<Note>
  Si el diff original superaba el límite de tamaño del payload de auditoría, la fila muestra un marcador **Diff truncado** y el panel explica que el conjunto de cambios completo fue reemplazado por un sobre marcador. El diff completo no puede recuperarse de ese registro.
</Note>
