Buscar solicitudes
En esta página
La pestaña Logs muestra las solicitudes realizadas en tu organización, de la más reciente a la más antigua. Usa los filtros de la parte superior para limitar la lista a una persona, una dirección IP, una parte de Performance Hub o un tipo de resultado y, luego, haz clic en una solicitud para ver sus detalles.
Referencia rápida
Dónde encontrarlo: Configuración (icono de engranaje, abajo a la izquierda) → Registros de auditoría → Logs
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: Encontrar las solicitudes que responden a una pregunta, como quién cambió algo o por qué falló algo
Figura 1: La pestaña Logs: los filtros en la parte superior, las solicitudes coincidentes a la izquierda y la solicitud seleccionada a la derecha
La pestaña Logs
- Barra de filtros: los filtros de la parte superior, con Live, actualizar y Exportar CSV a la derecha.
- Lista: las solicitudes coincidentes, de la más reciente a la más antigua. Encima aparece "Viewing logs for 1 organisation" (o el número de organizaciones que puedes ver). Cada fila muestra el código de estado, el método, la insignia de origen, la fecha y la hora, el endpoint, la dirección de correo electrónico del usuario y el tiempo de respuesta en milisegundos.
- Detalles: la solicitud que seleccionaste. Consulta Leer una entrada del registro.
La lista carga más solicitudes a medida que te desplazas. Al final de la lista se indica cuántas solicitudes coincidieron, por ejemplo, "End of results · 5 logs".
Filtrar la lista
- Haz clic en un filtro de la barra de filtros, por ejemplo, Endpoint.
- Elige una opción o escribe un valor. Por ejemplo, escribe
/api/door-gate-access/*en Endpoint y haz clic en Apply. - El filtro muestra el valor que elegiste y la lista se actualiza. Agrega más filtros para limitarla aún más: una solicitud debe coincidir con todos los filtros para aparecer.
- Para quitar un filtro, haz clic en la × que contiene. Para quitarlos todos, haz clic en Clear, que aparece en cuanto se establece algún filtro.
Figura 2: La barra de filtros: Range, Email, IP, Endpoint, Org, Facility, Method y Status, seguidos de Live, actualizar y Export CSV
| Filtro | Con qué coincide |
|---|---|
| Range | La hora en que se realizó la solicitud. El valor predeterminado es Last 24 hours. Consulta Range. |
La dirección de correo electrónico completa del usuario, por ejemplo, priya.shah@example.com. Puede sugerir direcciones mientras escribes. | |
| IP | La dirección IP completa desde la que se originó la solicitud, por ejemplo, 203.0.113.140 |
| Endpoint | La parte de Performance Hub a la que iba dirigida la solicitud. Coincide con cualquier parte de la ruta y puedes usar un comodín *. Consulta Endpoint y comodines. |
| Org | Una organización o Any org. Se muestra cuando tienes acceso a al menos una organización. |
| Instalación | Una instalación o Any facility. Se muestra cuando tienes acceso a al menos una instalación. |
| Method | GET, POST, PUT, PATCH o DELETE |
| Status | El estado de la respuesta. Consulta Status. |
Email e IP necesitan el valor completo
Email e IP solo encuentran coincidencias exactas. Escribe la dirección de correo electrónico completa, como ruby.castellano@example.com, o la dirección IP completa. Una parte de una dirección, como ruby o 203.0.113, no encuentra nada.
Para encontrar a una persona sin su dirección completa, usa Top Users en el panel o abre una de sus solicitudes y copia la dirección del campo User.
Rango
Haz clic en Range para elegir cuánto tiempo atrás quieres consultar.
- Valores predefinidos: Last 15 minutes, Last hour, Last 12 hours, Last 24 hours, Last 7 days, Last 30 days y Last 90 days.
- Fechas: elige una fecha de inicio y una fecha de finalización en el calendario de dos meses y, luego, haz clic en Apply. Haz clic en Cancel para cerrar el menú sin cambiar el intervalo. No se pueden elegir fechas de hace más de 90 días.
La nota de la parte inferior del menú indica durante cuánto tiempo se conservan los registros: "Audit logs are kept for 90 days. Full request and response payloads are kept for 7 days, after which a short preview remains. Need a longer history? Contact Support (additional charges apply)."
Figura 3: Range: elige un valor predefinido o fechas en el calendario. La nota indica durante cuánto tiempo se conservan los registros
Endpoint y comodines
El endpoint es la ruta a la que se envió la solicitud, como /api/door-gate-access/doors/front-entrance/unlock. Indica a qué parte de Performance Hub iba dirigida la solicitud.
- Sin un
*, coincide cualquier parte de la ruta. Por ejemplo,unlockencuentra todas las solicitudes que tienen "unlock" en su ruta. - Con un
*, cada fragmento entre los asteriscos debe aparecer en la ruta. Por ejemplo,/api/door-gate-access/*encuentra todas las solicitudes de Door & Gate Access y/partner/v1/*encuentra todas las solicitudes de una integración que usa la Partner API.
Figura 4: Endpoint acepta un comodín *, por ejemplo, para todas las solicitudes de puertas
Figura 5: La lista después de filtrar por un patrón de endpoint
¿No sabes qué endpoint usar? Abre una solicitud que conozcas, como una puerta que tú mismo desbloqueaste, y copia el inicio de su endpoint desde los detalles.
Estado
Haz clic en Status para filtrar por el estado de la respuesta. Escribe en Search… para encontrar un estado rápidamente, por ejemplo, "403". Elige Any para mostrar todos los estados.
Los estados aparecen con sus nombres, como 200 OK, 201 Created, 400 Bad Request, 401 Unauthorised, 403 Forbidden, 404 Not Found, 409 Conflict, 429 Too Many Requests, 500 Server Error y 503 Service Unavailable. Consulta Códigos de estado para saber qué significan.
Figura 6: Filtrar por estado de la respuesta
Live y actualizar
En la pestaña Logs, Live está en Off de forma predeterminada, por lo que la lista no cambia mientras investigas. Actívalo y elige con qué frecuencia se actualiza la lista para ver cómo llegan las nuevas solicitudes. Haz clic en el botón de actualizar (las flechas circulares) para volver a cargar la lista una vez.
Compartir o guardar como marcador una vista filtrada
Tus filtros se guardan en la dirección de la página. Guarda la página como marcador para volver a la misma vista o envía la dirección a un compañero. Verá la misma lista filtrada si tiene acceso a Registros de auditoría y a la misma organización.
Por ejemplo, una dirección que termina en /audit-logs/logs?email=priya.shah%40example.com abre la lista filtrada por esa persona, y una que termina en /audit-logs/logs?endpoint=%2Fapi%2Fdoor-gate-access%2F* abre todas las solicitudes de puertas.
Moverse por la lista
- Haz clic en una solicitud para abrir sus detalles a la derecha.
- Usa las teclas de flecha arriba y abajo para pasar a la solicitud anterior o siguiente de la lista.
- En una pantalla estrecha, los detalles se abren sobre la lista. Haz clic en el botón de cerrar para volver a la lista.
Sin resultados
Si nada coincide, la lista muestra "No logs match these filters" y "Try widening the time range or clearing a filter."
Figura 7: No hay solicitudes que coincidan: amplía el intervalo o quita un filtro
Para encontrar lo que buscas:
- Elige un Range más largo, como Last 7 days.
- Comprueba que Email e IP contengan la dirección completa. Una parte de una dirección no encuentra nada.
- Quita los filtros de uno en uno con su × o haz clic en Clear.
Páginas relacionadas
- Leer una entrada del registro: lo que muestra cada solicitud
- Exportar registros: descarga la lista como archivo CSV
- Ejemplos de investigación: filtros para preguntas habituales
- El panel: haz clic en un gráfico para abrir los registros correspondientes