Cuando un flujo no hace lo que esperas, revisa lo que realmente hizo antes de cambiarlo. Esta página muestra dónde mirar y enumera las causas más comunes.
Dónde mirar
| Lugar | Muestra | Conservado |
|---|---|---|
| Fila de la lista de flujos | Estado (Running, Off, Paused, Needs approval, Invalid, Draft), Activity, errores en 24 h, Limited · … cuando actuó una protección | |
| Barra superior del editor | Live o Every 5 s, mensajes por segundo, mensajes en espera, errores en 24 h | |
| Cables y bloques | Recuentos de mensajes en los cables; contadores In, Out y Errors en los bloques; una marca roja en un bloque que falla, un anillo amarillo donde actuó una protección | 24 horas |
| Activity > Debug | Mensajes que llegan a los bloques Debug | 24 horas |
| Activity > Runs | Ejecuciones registradas paso a paso: Started with, In, Sent on, It did, Left the flow | 24 horas |
| Activity > Trace | Un mensaje seguido por todos los pasos | 24 horas |
| Activity > Errors | Contadores de errores por bloque, errores más recientes, dónde se capturó cada uno | 7 días |
| Eventos: Log | Líneas de los bloques System log y del motor | 24 horas |
| Eventos: Lifecycle | Desplegado, encendido y apagado, pausado, reanudado, revertido, raíz cambiada, no arrancó, disyuntor abierto y cerrado | 30 días (últimos 100) |
| Eventos: Stats | Por bloque: entradas, salidas por puerto, errores, descartados, rechazados por un límite, tiempo medio y más largo, pasos lentos | 24 horas |
| Eventos: Audit | Quién cambió el flujo (últimas 50 entradas) | Retención del registro de auditoría |
| Failed messages | Mensajes que el flujo no pudo ejecutar | Hasta que se reproduzcan o se descarten |
| Errors and alerts (menú de la lista de flujos) | Alertas de 6 horas, flujos con errores, errores más frecuentes de 7 días |
El contenido de los mensajes solo se muestra a personas con Inject messages, see payloads and dead letters. Los demás ven recuentos.
Registrar lo que ocurre
Por defecto solo se guardan contadores. Para ver el contenido de los mensajes:
- Abre Activity y luego Runs.
- Establece Record en Runs that fail, o en Every run, for 5 minutes.
- Deja que lleguen mensajes y abre una ejecución. «Kept x of y runs» indica cuántas se registraron.
Para seguir exactamente un mensaje, selecciona un disparador y Trace the next message. Para centrarte en un bloque, haz clic derecho sobre él y elige Debug node (o Record this block for 5 minutes).
Desde cualquier entrada registrada, Test with this input la vuelve a ejecutar como prueba, sin guardar ni enviar nada.
Problemas comunes
| Síntoma | Causa probable | Solución |
|---|---|---|
| El flujo nunca arranca | Está Off, Paused, Needs approval o nunca se desplegó | Despliégalo con Run the flow after the deploy, o Resume it |
| Un flujo con un disparador Device message no recibe nada | No es una raíz; los mensajes ordinarios de dispositivos solo llegan a la raíz | Conviértelo en raíz de perfil, o pasa los mensajes desde la raíz con Run flow. Solo alarm y attributes_updated llegan a todos los flujos, y solo cuando se marcan por nombre. |
| Una raíz no recibe nada en su disparador Device message | El Flow input de la raíz está conectado, así que es la entrada | Conecta tus pasos después del Flow input |
| Los datos no se almacenan | Falta Save telemetry en la ruta, o informa de un error | Consulta Hosts, the root flow and profile root flows |
not_a_device | El mensaje lo inició una programación, inject, evento, temporizador o webhook, que no se refieren a un dispositivo | Haz el trabajo de dispositivos en la raíz, o en un flujo que ella ejecute |
| Una Schedule se dispara a una hora incorrecta | El tz del bloque está vacío y la zona por defecto de la organización es distinta | Establece tz; revisa Show the next runs |
| El despliegue rechaza una programación solar | No hay latitud ni longitud | Rellena lat y lon |
Un bloque sigue dando error con circuit_open | Sus llamadas fallaron repetidamente y están pausadas | Corrige el receptor; se recupera por sí solo |
La solicitud HTTP falla con ssrf_blocked | La dirección es privada, o no está en los hosts permitidos del endpoint, o la ruta sale de la ruta base | Usa una dirección pública y añade el host a allowed_hosts |
| No se envía nada después de una caída | Los mensajes llegaron tarde; los bloques de salida omiten los mensajes tardíos | Establece late en send en los flujos de datos que necesiten el acumulado |
| Un Notify no envía nada | Todos los destinatarios están en el periodo de espera (held), o no son válidos, o todos los canales superaron su cuota | Revisa msg.metadata.notify en una ejecución; establece Repeat reason |
| Los miembros no reciben correo de Notify | Los miembros (usuarios, roles, equipos) se alcanzan en la aplicación, por notificación push y solo en aplicaciones de chat | Añade filas de address |
| El flujo se pausó solo | Un bucle (ejecuta más de un minuto por encima del límite) o ejecuciones que fallan | Consulta Protections and failed messages |
| «Estos bloques envían mensajes en un bucle que nunca espera» | Un ciclo sin bloque de espera | Añade un Delay, o rompe el ciclo |
flow_cycle al desplegar | Los flujos se disparan entre sí mediante eventos o Run flow | Elimina un enlace del ciclo |
| Un contador o una media se reinició | La configuración del bloque cambió en el último despliegue | Es lo esperado: un bloque modificado empieza con una memoria vacía |
Un script falla con script_unavailable o host_busy | El servicio de scripts no es accesible o está ocupado | Reintenta más tarde; contacta con soporte si persiste |
Un script falla con timeout o blocked | Más de 50 ms de CPU, tres veces seguidas | Simplifica el script, o traslada el trabajo a bloques listos |
queue_full | Un bloque retiene demasiados mensajes o claves | Acorta las esperas, establece una clave, o reduce la tasa de entrada |
| Las lecturas llegan pero el panel va con retraso | Los gráficos de más de 24 horas leen resúmenes por minuto, que se rellenan cada minuto | Espera un minuto o dos |
Un flujo hace demasiado
- Stop one flow: desactívalo en la lista de flujos (su memoria y mensajes en espera se conservan).
- Detener todos los flujos: la parada de emergencia, desde el menú de la cabecera de la lista de flujos. Los datos de los dispositivos no se almacenan mientras esté activada. Consulte Protecciones y mensajes fallidos.
- Undo a change: Versions > Roll back to this. Consulta Versions, testing and rollback.
Pedir ayuda
Al contactar con soporte, incluye el nombre y el slug del flujo, la hora del problema (con tu zona horaria), el bloque y su código de error y, si puedes, una copia exportada del flujo (los secretos nunca están incluidos). Consulta Getting help.

