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

# Registros de auditoría

> Rastrea los cambios instrumentados en la configuración y las operaciones de conciliación con un registro filtrable y a prueba de manipulaciones, útil para solucionar problemas.

La página **Audit Logs** en la interfaz de Matcher ofrece un registro filtrable de los cambios instrumentados aplicados a la configuración y las operaciones de conciliación. Úsala para investigar el actor, la acción y la hora registrada de esos workflows.

## Cómo acceder a la página Audit Logs

***

Navega a **Matcher → Reporting → Audit Logs** en la barra lateral izquierda.

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

## Cómo verificar la integridad de la cadena

***

El panel **Tamper-evidence** se ubica encima de los filtros. Haz clic en **Verify integrity** para volver a verificar la cadena de hash de auditoría del tenant. La verificación es de solo lectura (nunca modifica un registro) y devuelve uno de dos veredictos:

| Veredicto                             | Significado                                                                                                                                              |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chain intact**                      | Cada registro inspeccionado se vincula con el anterior y coincide con su hash almacenado. El panel indica cuántos registros se verificaron.              |
| **Chain TAMPERED — integrity broken** | La cadena de hash está rota en una posición indicada. El registro de auditoría ya no puede considerarse a prueba de manipulaciones. Escala de inmediato. |

<Note>
  La cadena puede ser más larga que el límite de inspección. En ese caso, el veredicto **Chain intact** indica que la verificación inspeccionó solo los primeros registros desde el inicio de la cadena. También indica que la verificación omitió las entradas más recientes. Una solicitud fallida muestra un error con un botón **Retry**. Eso no es un veredicto.
</Note>

## Filtros

***

Usa la barra de filtros para acotar los resultados. El campo **Actor** admite texto libre de hasta 255 caracteres. Los campos **Action** y **Entity type** admiten 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`) |
| **Action**      | La operación ejecutada (por ejemplo, `CREATE`, `UPDATE`, `DELETE`)                        |
| **Entity type** | El tipo de recurso que se modificó (por ejemplo, `context`)                               |
| **Date from**   | Fecha de inicio del rango de tiempo                                                       |
| **Date to**     | Fecha de fin del rango de tiempo                                                          |

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

## Tabla de registros de auditoría

***

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

Cada fila de la tabla muestra las siguientes columnas:

| Columna         | Descripción                                                                                                                                                              |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Entry**       | El ID del registro de auditoría, mostrado como un enlace a una página de detalle dedicada para esa entrada. Resulta útil para pegarlo en un ticket de incidente          |
| **Recorded**    | Cuándo se registró el cambio                                                                                                                                             |
| **Action**      | La operación ejecutada                                                                                                                                                   |
| **Entity type** | El tipo de recurso que se modificó                                                                                                                                       |
| **Entity ID**   | 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                                    |
| **Chain**       | La posición de la cadena del registro (`#<sequence>`) y su hash de registro. Los registros escritos antes de que existiera la cadena de hash muestran **No chain proof** |
| **Changes**     | Un botón **View** que abre el payload JSON de auditoría registrado. Las filas sin cambios JSON muestran un marcador de posición                                          |

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

## Cómo ver los detalles de los cambios

***

<Frame caption="Figura 2. Panel Audit log changes que muestra el payload JSON de auditoría registrado.">
  <img src="https://mintcdn.com/lerian-49cb71fc/kb1KNsLI0JW1ssLF/en/products/matcher/ui/images/12-audit-logs-expanded.jpg?fit=max&auto=format&n=kb1KNsLI0JW1ssLF&q=85&s=1e16b39b4f713d4e9e4d3c1b81790b2d" alt="Entrada del registro de auditoría que muestra el payload JSON de auditoría registrado para el cambio" width="1556" height="862" data-path="en/products/matcher/ui/images/12-audit-logs-expanded.jpg" />
</Frame>

Haz clic en **View** en la columna Changes para abrir el panel **Audit log changes**. El panel describe el cambio registrado (action, entity type y entity ID) y luego muestra el payload JSON de auditoría registrado como un bloque con formato. Sus campos dependen de la operación. No garantiza un esquema de antes y después.

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

<Note>
  Si el diff original superaba el límite del payload de auditoría, la fila muestra un marcador **Diff truncated**. El panel explica que un envelope de marcador reemplazó el conjunto completo de cambios. El diff completo no se puede recuperar de ese registro.
</Note>
