Logotipo de Performance HubPerformance Hub
Sección del sitio: Documentación

Ejemplos de investigación

En esta página

Estos ejemplos muestran cómo responder preguntas habituales con Registros de auditoría. Cada uno incluye la pregunta, los filtros y los clics que debes usar, y lo que debes buscar. Los mismos pasos funcionan en cualquier tipo de sitio, así que adapta los filtros a tu propia pregunta.

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: Pasar de una pregunta a las solicitudes que la responden

¿Quién desbloqueó la entrada principal?

Un gimnasio o centro recreativo: la entrada principal se desbloqueó de forma remota y el gerente de turno quiere saber quién lo hizo y por qué.

  1. En la pestaña Logs, haz clic en Endpoint, escribe /api/door-gate-access/* y haz clic en Apply. La lista muestra solo las solicitudes de Door & Gate Access.
  2. Ajusta Range para que abarque la hora del desbloqueo.
  3. Haz clic en la solicitud cuyo endpoint termina en /front-entrance/unlock.

La pestaña Logs filtrada por /api/door-gate-access/*, con la solicitud de desbloqueo de la entrada principal abiertaLa pestaña Logs filtrada por /api/door-gate-access/*, con la solicitud de desbloqueo de la entrada principal abierta

Figura 1: Todas las solicitudes de puertas, con el desbloqueo de la entrada principal abierto

Qué buscar: User muestra quién desbloqueó la puerta, en este caso oscar.tran@example.com. Request POST Body muestra el motivo que indicó, "Member forgot access card", y Response Body muestra que la puerta se desbloqueó.

Siguiente paso: revisa el registro propio de la puerta en Registros de acceso de Door & Gate Access, que registra cada intento de desbloqueo en la puerta, incluidos los realizados desde la aplicación móvil.

¿Por qué un miembro del personal no pudo cambiar el rol de alguien?

Una clínica de fisioterapia: una coordinadora intentó asignar un nuevo rol a un compañero y no funcionó.

  1. En la pestaña Logs, haz clic en Status y elige 403 Forbidden.
  2. Haz clic en la solicitud 403 Forbidden de la hora del cambio de rol.
  3. En AI Error Summary, haz clic en Generate summary.

AI Error Summary explica que la persona que hizo el cambio no tenía permiso para asignar ese rolAI Error Summary explica que la persona que hizo el cambio no tenía permiso para asignar ese rol

Figura 2: El resumen explica por qué se rechazó el cambio de rol

Qué buscar: el resumen indica que la persona "does not have permission to assign that role". Compáralo con Response Body, que dice "You don't have permission to assign this role." Request POST Body muestra qué rol intentó asignar.

Siguiente paso: pide a un Organisation Administrator que haga el cambio o revisa el rol de la persona. Consulta Cambiar los roles de un usuario y Plantillas de roles.

Nuestra integración de reservas dejó de sincronizarse durante la noche

Un centro acuático o una instalación municipal: los registros de entrada del sistema de reservas dejaron de aparecer durante la noche.

  1. En la pestaña Logs, haz clic en Endpoint, escribe /partner/v1/* y haz clic en Apply.
  2. Ajusta Range a Last 24 hours.
  3. Observa el estado al comienzo de cada fila y, luego, haz clic en las solicitudes fallidas para leer su Response Body.

Qué buscar: solicitudes con la insignia api-key de integrations@example.org. Aquí la lista muestra 429 Too Many Requests, cuando la integración envió demasiadas solicitudes en poco tiempo, y 503 Service Unavailable. Anota cuándo comenzaron los errores y si después hubo solicitudes correctas.

Siguiente paso: haz clic en Exportar CSV y envía el archivo al socio de la integración para que revise su parte. Consulta Exportar registros y la página Errores de la Partner API.

Un webhook no se guardó

Una cafetería, tienda o local de hostelería: un gerente configuró un webhook para enviar los datos de los visitantes a otro sistema y no se guardó.

  1. En la pestaña Logs, haz clic en Email y escribe la dirección de correo electrónico completa del gerente, en este caso leo.hargreaves@example.com.
  2. Busca las dos solicitudes POST del momento en que el gerente guardó el webhook: una 400 Bad Request y una 201 Created en el mismo endpoint.
  3. Haz clic en 400 Bad Request y, luego, en 201 Created unos minutos después, y compáralas.

Qué buscar: el Response Body de la 400 dice "url must start with https://". En su Request POST Body, la dirección no tiene https:// al principio. En la 201, el gerente había agregado https:// y el webhook se guardó.

Siguiente paso: en una solicitud fallida, haz clic en Generate summary para obtener una explicación en lenguaje sencillo. Consulta AI Error Summary.

¿Qué hizo la semana pasada un miembro del personal que se va?

Una oficina o espacio de coworking: antes de que un miembro del personal se vaya, su gerente quiere un registro de su actividad reciente.

  1. En la pestaña Logs, haz clic en Email y escribe la dirección de correo electrónico completa de la persona.
  2. Ajusta Range a Last 7 days.
  3. Desplázate hasta el final de la lista para que se carguen todas las solicitudes. La exportación solo incluye las filas cargadas.
  4. Haz clic en Exportar CSV y, luego, en Export.

Qué buscar: cambios en lugar de lecturas. Ajusta Method a POST, PUT, PATCH o DELETE, uno tras otro, para ver las solicitudes que crearon, cambiaron o eliminaron elementos. Si encuentras algo inesperado, abre la solicitud y lee su Request POST Body.

Siguiente paso: cuando se vaya, quítale el acceso. Consulta Quitar usuarios. Guarda el archivo CSV de acuerdo con la política de tu organización.

¿Qué sitio tuvo más solicitudes fallidas?

Un operador con varios sitios: varios sitios informaron problemas ayer y la oficina central quiere saber por dónde empezar.

  1. En la pestaña Panel, ajusta Window para que abarque el día.
  2. En Errors Over Time, haz clic en el intervalo con más errores. Se abre la pestaña Logs con las solicitudes fallidas de ese momento.
  3. Haz clic en Instalación, elige cada sitio por turno y compara cuántas solicitudes fallidas tiene cada uno.

Qué buscar: un sitio con muchos más errores que los demás, o errores en un mismo endpoint. Abre algunas de sus solicitudes y lee el Response Body o haz clic en Generate summary.

Siguiente paso: consulta El panel para ver los demás gráficos, e Instalaciones para ver los sitios de tu organización.