get
https://one.fracttal.com/hub/api/v1/dags/{dag_id}/timeline/
Con este endpoint puedes visualizar la actividad de ejecuciones de un DAG agrupada por intervalos de tiempo: hora, día, semana o mes. Útil para identificar patrones de carga y detectar períodos con mayor cantidad de fallos.
Autenticación
Requiere un Bearer token OAuth2 obtenido mediante el flujo client_credentials. Ver Autenticación.
Parámetros de ruta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
dag_id | string (UUID) | ✅ | UUID del DAG/ETL en formato 8-4-4-4-12 |
Query parameters
| Parámetro | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
start_date | string (YYYY-MM-DD) | ✅ | — | Inicio del rango de fechas |
end_date | string (YYYY-MM-DD) | ✅ | — | Fin del rango de fechas |
interval | string | — | day | Agrupación: hour, day, week o month |
Encabezados
| Nombre | Valor |
|---|---|
Authorization | Bearer <access_token> |
Accept | application/json |
Ejemplo de request
GET /hub/api/v1/dags/589b6c65-1ce9-4a46-9c11-ad380d9bf27a/timeline?start_date=2026-06-01&end_date=2026-06-05&interval=day
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...
Accept: application/jsonRespuesta exitosa — 200
{
"interval": "day",
"points": [
{ "timestamp": "2026-06-03", "total_runs": 5, "successful": 5, "failed": 0 },
{ "timestamp": "2026-06-04", "total_runs": 8, "successful": 7, "failed": 1 },
{ "timestamp": "2026-06-05", "total_runs": 6, "successful": 6, "failed": 0 }
]
}| Campo | Tipo | Descripción |
|---|---|---|
interval | string | Intervalo de agrupación aplicado |
points | array | Puntos de la línea de tiempo |
points[].timestamp | string | Inicio del bucket (formato según interval) |
points[].total_runs | integer | Total de ejecuciones en el bucket |
points[].successful | integer | Ejecuciones completamente exitosas |
points[].failed | integer | Ejecuciones con al menos una fase fallida |
Códigos de error
| Código | Descripción |
|---|---|
401 | Token inválido o expirado |
422 | Rango de fechas o intervalo inválido — revisar details[] |
502 | Error al consultar la línea de tiempo |
Problemas posibles
Todos los errores siguen el formato RFC 9457 con Content-Type: application/problem+json.
401 — Token ausente, inválido o expirado
401 — Token ausente, inválido o expiradoVer Problemas de autenticación.
422 — Parámetro inválido
422 — Parámetro inválido{
"error_code": "VALIDATION_ERROR",
"message": "Invalid request parameters",
"status_code": 422,
"details": [
{ "field": "interval", "message": "interval must be one of: hour, day, week, month" }
]
}Causas frecuentes: fechas en formato incorrecto, start_date posterior a end_date, o valor de interval fuera del enum.
502 — Error en servicio dependiente
502 — Error en servicio dependiente{
"error_code": "BACKEND_RPC_ERROR",
"message": "Upstream service returned an unexpected error",
"status_code": 502
}Solución: Reintenta con backoff exponencial.