Filtros y fechas
Rango de fechas
Comportamiento por defecto
Cuando no se especifican fechas, la API consulta automáticamente los últimos 3 días. Si necesitas datos fuera de ese período, especifica el rango explícitamente.
Parámetros de fecha por endpoint
Los nombres de los parámetros de fecha varían según el endpoint:
| Endpoint | Parámetro inicio | Parámetro fin |
|---|---|---|
GET /dags/{dag_id}/runs |
date_from |
date_to |
GET /dags/{dag_id}/stats |
start_date |
end_date |
GET /dags/{dag_id}/timeline |
start_date |
end_date |
Todos los valores usan formato YYYY-MM-DD y son inclusivos en ambos extremos.
# Buscar ejecuciones del mes pasado (usa date_from / date_to)
curl "https://one.fracttal.com/hub/api/v1/dags/my-dag/runs?date_from=2026-04-01&date_to=2026-04-30" \
-H "Authorization: Bearer <token>"
# Estadísticas del mes pasado (usa start_date / end_date)
curl "https://one.fracttal.com/hub/api/v1/dags/my-dag/stats?start_date=2026-04-01&end_date=2026-04-30" \
-H "Authorization: Bearer <token>"
Límite de rango en /runs
El endpoint GET /dags/{dag_id}/runs acepta un rango máximo de 30 días por consulta. Para períodos más largos, divide la búsqueda en intervalos. Los endpoints /stats y /timeline no tienen límite de rango.
Niveles de log
| Valor | Descripción |
|---|---|
DEBUG |
Información de depuración detallada |
INFO |
Eventos normales del flujo de ejecución |
WARNING |
Situaciones inesperadas no críticas |
ERROR |
Errores que impiden una operación concreta |
CRITICAL |
Errores graves que afectan al sistema |
Los valores son sensibles a mayúsculas: usa siempre la forma en mayúsculas.
# Solo logs de error de una fase
curl "https://one.fracttal.com/hub/api/v1/dags/my-dag/runs/2026-05-01/my-run-id/phases/extract/logs?level=ERROR" \
-H "Authorization: Bearer <token>"
Búsqueda por texto
El parámetro keyword filtra por el contenido del mensaje. La búsqueda es insensible a mayúsculas/minúsculas y encuentra coincidencias parciales.
curl "https://one.fracttal.com/hub/api/v1/dags/my-dag/runs/2026-05-01/my-run-id/phases/extract/logs?keyword=timeout" \
-H "Authorization: Bearer <token>"
Filtros combinados
Puedes combinar level y keyword en una misma consulta: