Saltar a contenido

Hub Log Middleware

API Middleware para la consulta, análisis y descarga de logs de Airflow en la plataforma Fracttal.

Descripción general

Hub Log Middleware es una capa de integración que expone endpoints RESTful unificados para la consulta, análisis y descarga de logs de Airflow.

Base URL

http://<host>:<port>/api/v1

Grupos de endpoints

Grupo Prefijo Descripción
DAGs /api/v1 Navegación de DAGs y ejecuciones por compañía
Runs /api/v1/runs Artefactos y búsqueda avanzada por ejecución
Artifacts /api/v1/artifacts Descarga y acceso a artefactos
Problems /api/v1/problems Catálogo de errores RFC 9457

Autenticación

Todos los endpoints requieren un Bearer Token en el header Authorization. Ver Autenticación.

Conceptos clave

Antes de consumir la API, te recomendamos revisar:

  • Paginación — cómo recorrer listas grandes y usar el stream.
  • Filtros y fechas — rangos de fecha, niveles, búsqueda por texto y ordenamiento.
  • Manejo de errores — formato de error RFC 9457 y cómo tratar cada código.

Health check

GET /health

Retorna el estado de la API.

{
  "status": "healthy",
  "app_name": "Hub Log Middleware",
  "version": "1.0.0",
  "environment": "production"
}

Documentación interactiva

La API expone una interfaz de pruebas interactiva. Solicita la URL de acceso al equipo responsable del servicio.