Cuando un flujo no hace lo que esperas, mira lo que realmente hizo antes de cambiarlo. Esta página indica dónde mirar y enumera las causas habituales.
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 | Recuento de mensajes en los cables; contadores In, Out y Errors en los bloques; una marca roja en un bloque con fallos, 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ó, cortacircuitos 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 las personas con Inject messages, see payloads and dead letters. Los demás ven recuentos.
Registrar lo que ocurre
Por defecto solo se conservan contadores. Para ver el contenido de los mensajes:
- Abre Activity y después 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).
A partir de cualquier entrada registrada, Test with this input la vuelve a ejecutar como prueba, sin almacenar ni enviar nada.
Problemas habituales
| 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 | La Flow input de la raíz está conectada, así que es la entrada | Conecta tus pasos después de la Flow input |
| Los datos no se almacenan | Falta Save telemetry en el camino, 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 predeterminada de la organización es distinta | Establece tz; revisa Show the next runs |
| El despliegue rechaza una programación solar | Falta la latitud y la longitud | Rellena lat y lon |
Un bloque sigue dando error circuit_open | Sus llamadas han fallado repetidamente y están en pausa | 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 historial pendiente |
| 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 han agotado la cuota | Revisa msg.metadata.notify en una ejecución; establece Repeat reason |
| Los miembros no reciben correo electrónico de Notify | Los miembros (usuarios, roles, equipos) se atienden en la app, por push y solo en las apps de chat | Añade filas de address |
| El flujo se pausó a sí mismo | Un bucle (ejecuta más de un minuto por encima del límite) o ejecuciones con fallos | Consulta Protections and failed messages |
| «Estos bloques envían mensajes en un bucle que nunca espera» | Un ciclo sin un 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 mueve el trabajo a bloques listos |
queue_full | Un bloque retiene demasiados mensajes o claves | Acorta las esperas, define 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 completan cada minuto | Espera un minuto o dos |
Un flujo hace demasiado
- Stop one flow: desactívalo en la lista de flujos (su memoria y sus mensajes en espera se conservan).
- Stop all flows: la parada de emergencia, desde el menú de la cabecera de la lista de flujos. Mientras esté activa, los datos de los dispositivos no se almacenan. Consulta Protections and failed messages.
- Deshacer un cambio: 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 se incluyen). Consulta Getting help.