Novedad: el cortafuegos de IA supervisa toda la plataforma y explica cada incidente con palabras sencillas. Vea cómo funciona

Solución de problemas de flujos

Descubre qué hizo un flujo: cifras en vivo, el panel Activity, registros de ejecución, trazas, eventos y registros de errores, y soluciones para los problemas más comunes de los flujos.

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

LugarMuestraConservado
Fila de la lista de flujosEstado (Running, Off, Paused, Needs approval, Invalid, Draft), Activity, errores en 24 h, Limited · … cuando actuó una protección
Barra superior del editorLive o Every 5 s, mensajes por segundo, mensajes en espera, errores en 24 h
Cables y bloquesRecuentos 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ón24 horas
Activity > DebugMensajes que llegan a los bloques Debug24 horas
Activity > RunsEjecuciones registradas paso a paso: Started with, In, Sent on, It did, Left the flow24 horas
Activity > TraceUn mensaje seguido por todos los pasos24 horas
Activity > ErrorsContadores de errores por bloque, errores más recientes, dónde se capturó cada uno7 días
Eventos: LogLíneas de los bloques System log y del motor24 horas
Eventos: LifecycleDesplegado, encendido y apagado, pausado, reanudado, revertido, raíz cambiada, no arrancó, disyuntor abierto y cerrado30 días (últimos 100)
Eventos: StatsPor bloque: entradas, salidas por puerto, errores, descartados, rechazados por un límite, tiempo medio y más largo, pasos lentos24 horas
Eventos: AuditQuién cambió el flujo (últimas 50 entradas)Retención del registro de auditoría
Failed messagesMensajes que el flujo no pudo ejecutarHasta 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:

  1. Abre Activity y luego Runs.
  2. Establece Record en Runs that fail, o en Every run, for 5 minutes.
  3. 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íntomaCausa probableSolución
El flujo nunca arrancaEstá 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 nadaNo es una raíz; los mensajes ordinarios de dispositivos solo llegan a la raízConvié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 messageEl Flow input de la raíz está conectado, así que es la entradaConecta tus pasos después del Flow input
Los datos no se almacenanFalta Save telemetry en la ruta, o informa de un errorConsulta Hosts, the root flow and profile root flows
not_a_deviceEl mensaje lo inició una programación, inject, evento, temporizador o webhook, que no se refieren a un dispositivoHaz el trabajo de dispositivos en la raíz, o en un flujo que ella ejecute
Una Schedule se dispara a una hora incorrectaEl tz del bloque está vacío y la zona por defecto de la organización es distintaEstablece tz; revisa Show the next runs
El despliegue rechaza una programación solarNo hay latitud ni longitudRellena lat y lon
Un bloque sigue dando error con circuit_openSus llamadas fallaron repetidamente y están pausadasCorrige el receptor; se recupera por sí solo
La solicitud HTTP falla con ssrf_blockedLa dirección es privada, o no está en los hosts permitidos del endpoint, o la ruta sale de la ruta baseUsa una dirección pública y añade el host a allowed_hosts
No se envía nada después de una caídaLos mensajes llegaron tarde; los bloques de salida omiten los mensajes tardíosEstablece late en send en los flujos de datos que necesiten el acumulado
Un Notify no envía nadaTodos los destinatarios están en el periodo de espera (held), o no son válidos, o todos los canales superaron su cuotaRevisa msg.metadata.notify en una ejecución; establece Repeat reason
Los miembros no reciben correo de NotifyLos miembros (usuarios, roles, equipos) se alcanzan en la aplicación, por notificación push y solo en aplicaciones de chatAñade filas de address
El flujo se pausó soloUn bucle (ejecuta más de un minuto por encima del límite) o ejecuciones que fallanConsulta Protections and failed messages
«Estos bloques envían mensajes en un bucle que nunca espera»Un ciclo sin bloque de esperaAñade un Delay, o rompe el ciclo
flow_cycle al desplegarLos flujos se disparan entre sí mediante eventos o Run flowElimina un enlace del ciclo
Un contador o una media se reinicióLa configuración del bloque cambió en el último despliegueEs lo esperado: un bloque modificado empieza con una memoria vacía
Un script falla con script_unavailable o host_busyEl servicio de scripts no es accesible o está ocupadoReintenta más tarde; contacta con soporte si persiste
Un script falla con timeout o blockedMás de 50 ms de CPU, tres veces seguidasSimplifica el script, o traslada el trabajo a bloques listos
queue_fullUn bloque retiene demasiados mensajes o clavesAcorta las esperas, establece una clave, o reduce la tasa de entrada
Las lecturas llegan pero el panel va con retrasoLos gráficos de más de 24 horas leen resúmenes por minuto, que se rellenan cada minutoEspera 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.