Pestaña Audit en orígenes de datos

Pestaña Audit en orígenes de datos

Resumen

La pestaña Auditoría está disponible dentro de cada origen de datos y ofrece visibilidad completa sobre todas las solicitudes que el motor le hizo a ese origen. Es la herramienta principal para monitorear el comportamiento, detectar errores y analizar el rendimiento de las APIs y fuentes de datos configuradas. En este video ve cómo leer las métricas, aplicar filtros, revisar el detalle de cada solicitud y exportar los registros.

Antes de comenzar

  • La auditoría de orígenes debe estar habilitada en la cuenta. Si la pestaña no aparece en la ficha del origen, consulte con soporte.
  • Se registran las solicitudes que el motor hace al origen al ejecutar las vistas. Las respuestas servidas desde la caché del gateway o del motor no generan una solicitud nueva al origen.

Métricas principales

Al ingresar a la pestaña se muestran cinco métricas calculadas sobre los registros filtrados:

  • Total de solicitudes: cantidad de solicitudes al origen en el período.
  • Tasa de error: porcentaje de respuestas con código 400 o superior, con la cantidad entre paréntesis.
  • Respuesta promedio: tiempo medio de respuesta del origen, en milisegundos.
  • Respuesta p95: tiempo por debajo del cual respondió el 95 % de las solicitudes.
  • Respuesta máxima: el mayor tiempo de respuesta registrado.

Las métricas se recalculan al aplicar filtros de fecha, código de estado o Trace ID.

Filtros disponibles

  • Código de estado: todos (por defecto), 200, 400, 500, etc.
  • Fecha inicio y Fecha fin: acotan el período. Por defecto se muestra la última semana.
  • Trace ID: búsqueda exacta por el identificador de trazabilidad de la solicitud.

Los botones de acción son Filtrar, que aplica los filtros a la tabla y al gráfico; Limpiar, que restablece los filtros; Exportar CSV, que descarga los registros visibles, y Exportar todo, que descarga todos los registros sin importar el filtro activo.

Visualización gráfica

El gráfico de barras muestra la distribución de solicitudes por día, coloreadas según el código de estado: verde para 200 y rojo para 400 o superior. Permite identificar picos de error o períodos de baja actividad, y al hacer clic en una barra se filtra la tabla por ese estado.

Tabla de registros

Debajo del gráfico se lista cada solicitud con las columnas Fecha (ISO 8601 con zona horaria), Trace ID, Revisión del origen que procesó la solicitud, Endpoint con su path y parámetros, Status (200 en verde, 400 o más en rojo) y Response time en milisegundos. Cada fila tiene un botón (+) para expandir el detalle completo de la solicitud: cabeceras, cuerpo enviado y respuesta recibida. La paginación muestra 50 registros por página.

Resultado esperado

La pestaña muestra las solicitudes al origen del período elegido, con sus métricas, el gráfico por día y la tabla con el detalle de cada una. En el video, el origen REST de demostración acumula las solicitudes del día y cada fila se expande para ver la respuesta del origen.

Errores frecuentes

  • No hay registros aunque la API recibe llamadas: las respuestas están saliendo de la caché. Verifique el tiempo de caché del método o el período filtrado.
  • La tasa de error es alta: expanda una fila con estado 400 o 500 para ver la respuesta del origen y corrija la solicitud o las credenciales.
  • Un Trace ID no aparece: la búsqueda es exacta; copie el identificador completo desde la respuesta del gateway.

Artículos relacionados