Cómo interpretar ejecuciones

El dashboard es la herramienta central para:

✔ Supervisar integraciones en tiempo real

Ver qué flujos se están ejecutando y cómo evolucionan.

✔ Analizar ejecuciones anteriores

Historial completo para auditoría o debugging.

✔ Identificar errores rápidamente

Nubyhub muestra el paso exacto donde algo ha fallado.

✔ Ver qué datos entraron y salieron

Fundamental para verificar integraciones sensibles.

✔ Optimizar flujos

Permite detectar cuellos de botella o patrones de fallo.

Aunque la interfaz visual pueda variar, toda ejecución en nubyhub contiene estos elementos universales:

Los estados más frecuentes:

• Éxito (todo ha salido bien)
• Fallo (error en algún paso)
• Parcial (algunos pasos bien, otros con error)
• En proceso (ejecución activa)

El estado es el indicador principal para soporte.

nubyhub registra:

• Qué paso se ejecutó
• En qué orden
• Con qué datos de entrada
• Qué operación realizó
• Qué respuesta devolvió el sistema
• Si el paso terminó bien o mal

Esto permite reconstruir exactamente lo que ocurrió.

Para cada paso, puedes ver:

• Datos recibidos por la operación
• Datos enviados a la API
• Datos generados por transformaciones
• Datos resultantes para el siguiente paso

Esto es clave para diagnosticar errores de mapeo o estructuras JSON mal formadas.

Incluye:

• Código HTTP (200, 201, 400, 404, 500…)
• Mensaje de error (si lo hay)
• El body devuelto por la API

Con esto puedes distinguir entre:

• Error en tu flujo (transformación incorrecta)
• Error en la API externa (endpoint caído, token caducado…)

Una ejecución fallida siempre incluye:

• Descripción del error
• Paso exacto donde ocurrió
• Datos que provocaron el fallo
• Respuesta completa de la API implicada
• Sugerencias (si aplica)

Esto permite corregir de forma rápida y precisa.

Para cada paso:

• Tiempo total
• Tiempo de espera de la API
• Tiempo de transformación
• Retrasos del sistema

Y para la ejecución global:

• Inicio
• Fin
• Duración total

Esto es útil para:

• Optimizar flujos pesados
• Detectar APIs lentas
• Calcular cargas de trabajo

❌ Error de autenticación

Suele aparecer al inicio.
Causa: conexión con token caducado o incorrecto.

❌ Error de estructura JSON

Causa: payload mal mapeado.

❌ Error 404

Causa: endpoint incorrecto o ID inexistente.

❌ Error 409 (conflicto)

Causa: duplicidad de datos.

❌ Error 500

Causa: fallo interno en la API externa.

❌ Campo requerido no enviado

Causa: transformación o mapeo incompleto.

❌ Lógica incorrecta

Un paso depende de datos que no existen en la respuesta anterior.

✔ Revisa siempre el primer paso que falló

Lo que ocurre después puede ser consecuencia, no causa.

✔ Activa logs detallados durante el desarrollo

Desactívalos en producción si no son necesarios.

✔ Guarda ejecuciones críticas para auditoría

Especialmente en finanzas, stock o facturación.

✔ Si un flujo falla varias veces, revisa transformaciones

Los errores de mapeo son los más comunes.

✔ Usa validaciones internas antes de enviar datos a una API

Ej.: si un campo obligatorio está vacío, corta el flujo antes de la operación.

El dashboard y los logs son una de las partes más potentes de nubyhub.
No solo te dicen “qué ha fallado”, sino exactamente por qué, con qué datos, en qué paso y qué respondió cada sistema externo.

Esto convierte la depuración en un proceso rápido, transparente y profesional.