Registros de auditoría

Registros de auditoría es un registro de las solicitudes realizadas a Performance Hub en tu organización. Abarca las solicitudes de las personas que usan Performance Hub en un navegador o en la aplicación, y de herramientas conectadas como claves de API, agentes de IA conectados mediante MCP y Model Router. Úsalo para responder preguntas como quién desbloqueó una puerta, por qué no se guardó un cambio o cuándo dejó de funcionar una integración, ya sean tus sitios oficinas, tiendas, cafeterías, recintos, clínicas, campus o gimnasios.

Referencia rápida

Dónde encontrarlo: Configuración (icono de engranaje, abajo a la izquierda) → Registros de auditoría

Quién puede usarlo: Necesitas un rol que incluya Registros de auditoría e Identity & Access Management en tu organización, como Organisation Administrator. Consulta Quién puede usar Registros de auditoría.

Propósito: Ver quién hizo qué en Performance Hub y averiguar por qué falló una solicitud

Figura 1: El panel de Registros de auditoría: el intervalo de tiempo, las cifras principales y la línea de tiempo de solicitudes

Qué se registra

Cada entrada del registro corresponde a una solicitud realizada a Performance Hub. Muestra:

• Quién hizo la solicitud: la dirección de correo electrónico del usuario.
• Desde dónde: la dirección IP y el navegador o la herramienta que la envió.
• Qué se llamó: el método (por ejemplo, GET para leer o POST para crear) y el endpoint, que es la parte de Performance Hub a la que iba dirigida la solicitud, como /api/door-gate-access/doors/front-entrance/unlock.
• El resultado: el estado de la respuesta, por ejemplo, 200 si se realizó correctamente o 403 cuando la persona no tenía permiso.
• Cuánto tardó, en milisegundos.
• De dónde procede: una insignia de origen, como web para una persona que usa Performance Hub o api-key para una integración. Consulta Insignias de origen.

En las solicitudes recientes, la entrada del registro también contiene lo que se envió y lo que se devolvió. Consulta Leer una entrada del registro.

Las dos pestañas

Quién puede usar Registros de auditoría

Necesitas un rol que incluya Registros de auditoría e Identity & Access Management en tu organización, como Organisation Administrator. Si no ves Registros de auditoría en el menú de configuración, tu rol no lo incluye.

• Qué organizaciones ves: las organizaciones en las que tu rol incluye tanto Registros de auditoría como Identity & Access Management. La pestaña Logs muestra cuántas son, por ejemplo, "Viewing logs for 1 organisation".
• Plantillas de rol: la plantilla Organisation Administrator incluye Registros de auditoría. Las plantillas Site Manager y Site Owner no lo incluyen. Consulta Plantillas de rol.
• Roles personalizados: para que un rol personalizado pueda usar Registros de auditoría, incluye tanto Registros de auditoría como Identity & Access Management en su acceso a módulos. Consulta Alcance de acceso y acceso a módulos.

Registros de auditoría muestra las direcciones de correo electrónico de las personas, las direcciones IP y lo que enviaron, así que concédelo solo a quienes lo necesiten.

Cuánto tiempo se conservan los registros

La retención de los registros de auditoría determina cuánto tiempo se conservan: 90 días para cada entrada del registro y 7 días para el contenido completo de su solicitud y su respuesta.

El menú Range de la pestaña Logs indica:

"Los registros de auditoría se conservan durante 90 días. Los cargas útiles completas de solicitudes y respuestas se conservan durante 7 días, tras lo cual queda una vista previa corta. ¿Necesita un historial más antiguo? Póngase en contacto con el soporte técnico (se aplican cargos adicionales)."

Por lo tanto, puedes consultar hasta 90 días atrás. Durante los primeros 7 días, una entrada del registro contiene la solicitud y la respuesta completas. Después, los cuerpos más largos se recortan a una vista previa breve. Consulta Después de 7 días: vistas previas.

Qué puedes hacer

• Leer el panel: consulta el volumen de solicitudes, las tasas de error y los endpoints y usuarios con más actividad en un intervalo de tiempo.
• Buscar solicitudes: filtra por intervalo de tiempo, dirección de correo electrónico, dirección IP, endpoint, organización, instalación, método y estado, y comparte una vista filtrada.
• Leer una entrada del registro: consulta quién hizo una solicitud, desde dónde y qué se envió y devolvió. En el caso de una solicitud fallida, obtén un resumen del error en lenguaje sencillo.
• Exportar registros: descarga los registros cargados como un archivo CSV.
• Seguir un ejemplo de investigación: respuestas paso a paso a preguntas habituales, como quién desbloqueó una puerta o por qué una integración dejó de sincronizarse.
• Preguntas frecuentes

Páginas relacionadas

• Plantillas de rol: qué plantillas incluyen Registros de auditoría
• Alcance de acceso y acceso a módulos: concede Registros de auditoría a un rol personalizado
• Door & Gate Access: Registros de acceso: el registro independiente de cada intento de desbloqueo de puertas y portones