Logs de integraciones

¿Qué puedes hacer?

Ver tus integraciones — obtén la lista de todas las integraciones ETL configuradas para tu empresa.
Revisar el historial de actividad — consulta cuántas veces se ejecutó una integración y cuándo.
Analizar resultados — ve el resumen de éxitos y fallos por fase en un rango de fechas.
Explorar registros — busca y navega los datos que procesó una ejecución específica.

Antes de empezar

Necesitas:

Un client_id y un client_secret — los genera un administrador de Fracttal desde la sección Grupos de Permisos.
Que tu cuenta tenga habilitado el módulo Automatizador → Fracttal Hub.

Si no tienes alguno de estos, contacta al administrador de tu cuenta antes de continuar.

Inicio rápido

1. Obtén tu token de acceso

curl -X POST "https://one.fracttal.com/oauth/token" \
  -H "Authorization: Basic $(echo -n 'TU_CLIENT_ID:TU_CLIENT_SECRET' | base64)" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials"

Guarda el valor de access_token — lo necesitas en los siguientes pasos. Dura 2 horas.

2. Lista tus integraciones

curl -X GET "https://one.fracttal.com/hub/api/v1/dags" \
  -H "Authorization: Bearer TU_ACCESS_TOKEN"

Obtendrás la lista de tus integraciones con su dag_id. Usa ese identificador para los siguientes endpoints.

3. Consulta los registros de una ejecución

curl -X GET "https://one.fracttal.com/hub/api/v1/dags/TU_DAG_ID/runs/2026-06-05/TU_RUN_ID/phases/load/data" \
  -H "Authorization: Bearer TU_ACCESS_TOKEN"

Contenido

Sección	Descripción
Cómo autenticarte	Cómo obtener y usar tu token de acceso
Listar integraciones ETL	Ver todas tus integraciones
Resumen de ejecuciones	Estadísticas de éxitos y fallos por fase
Historial de actividad	Actividad agrupada por día, semana o mes
Ver registros procesados	Explorar los datos de una ejecución específica

URL base

Todos los endpoints parten de:

https://one.fracttal.com/hub

# 1. Obtain an access token
TOKEN=$(curl -s -X POST https://one.fracttal.com/oauth/token \
  -H "Authorization: Basic $(echo -n 'CLIENT_ID:CLIENT_SECRET' | base64)" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" | jq -r .access_token)

# 2. List available DAGs
curl -s https://one.fracttal.com/hub/api/v1/dags \
  -H "Authorization: Bearer $TOKEN" | jq .

# 3. Inspect a specific run
DAG_ID="589b6c65-1ce9-4a46-9c11-ad380d9bf27a"
curl -s "https://one.fracttal.com/hub/api/v1/dags/$DAG_ID/runs/2026-06-05/manual_20260605T140709_c003" \
  -H "Authorization: Bearer $TOKEN" | jq .

# 4. Browse load-phase rows
curl -s "https://one.fracttal.com/hub/api/v1/dags/$DAG_ID/runs/2026-06-05/manual_20260605T140709_c003/phases/load/data?page=0&limit=50" \
  -H "Authorization: Bearer $TOKEN" | jq