Un host es la parte de Hermetry que ejecuta flujos de un tipo. El host IoT ejecuta los flujos que reciben mensajes de dispositivos; el host General ejecuta flujos para programaciones, webhooks y eventos. En el host IoT, cada mensaje de dispositivo va a exactamente un flujo raíz, que almacena los datos. Esta página explica los hosts, los flujos raíz y cómo modificarlos con seguridad.
Los dos hosts
| IoT | General | |
|---|---|---|
| Tipos de mensaje | telemetry, attributes, connect, disconnect, activity, inactivity, rpc_request, rpc_response, attributes_updated, alarm; también programaciones, injects, webhooks, temporizadores y eventos | Programaciones, injects, webhooks, temporizadores, eventos y mensajes de otros flujos |
| Flujos raíz | Sí: la raíz de todo el inquilino y las raíces de perfil | No |
| Bloques de dispositivo | Device message, Save telemetry, Save attributes, Alarm rules, Send command, Raise alarm, bloques de enriquecimiento … | No |
| Recuento mensual | Los mensajes de dispositivo cuentan como mensajes de IoT | Las entradas aceptadas cuentan como mensajes de Automation |
Eliges el host al crear un flujo; no puede cambiarse después. El filtro Host de la lista de flujos muestra los flujos de un solo host.
Flujos raíz
Un flujo raíz es la entrada de los mensajes de dispositivo de un host. En el host IoT hay dos tipos:
| Raíz | Se ejecuta para | Obligatorio |
|---|---|---|
| Raíz de todo el inquilino | Todo dispositivo cuyo perfil no tenga raíz propia | Sí: siempre hay una. Puede reemplazarse, nunca eliminarse. |
| Raíz de perfil | Los dispositivos de un perfil de dispositivo | No |
Cada mensaje de dispositivo inicia una raíz: la raíz de su perfil si la tiene, si no la raíz de todo el inquilino. Entra por el bloque Flow input de la raíz (llamado Device messages en la raíz predeterminada). La telemetría llega un mensaje por registro: un dispositivo que envía un lote de 10 registros con marca de tiempo inicia 10 mensajes.
Los flujos raíz muestran una insignia Root en la lista de flujos, con aquello para lo que se ejecutan (“Root · Tenant-wide”, o el nombre del perfil).
El flujo raíz predeterminado
Cada organización comienza con el Default root flow, asociado a todo el inquilino. Se crea y despliega automáticamente:
Device messages (Flow input)
→ Alarm rules
→ Message type (Switch on msg.metadata.msgType)
telemetry → Save telemetry
attributes → Save client attributes
rpc_request → System log "RPC request from …"
otherwise → System log "Other device message"
Errors (Catch, uncaught only) → System log
“Cada mensaje de dispositivo del ámbito de esta raíz entra por su Flow input: se evalúan las reglas de alarma del perfil de dispositivo, se guardan la telemetría y los atributos de cliente, y se registran las solicitudes RPC de los dispositivos y los demás mensajes. Si eliminas un nodo de guardado, esos datos dejan de almacenarse.”
Puedes editarlo como cualquier flujo: añadir valores derivados, reenvíos o filtros. Mantén Alarm rules, Save telemetry y Save client attributes en sus caminos, o ese trabajo se detendrá para todos los dispositivos que atiende la raíz.
Crear una raíz de perfil
Usa una raíz de perfil cuando un grupo de dispositivos necesite un tratamiento distinto, por ejemplo un decodificador para un perfil que envía datos binarios, o pasos adicionales para una línea de producto.
- Crea un flujo en el host IoT, idealmente a partir de la plantilla Default root flow para que la ruta de almacenamiento esté desde el principio.
- Añade tus pasos. Mantén Alarm rules, Save telemetry y Save client attributes.
- Despliégalo activado. “Solo un flujo que se ejecuta puede ser raíz allí.”
- En la lista de flujos, abre los Details del flujo y selecciona Set as root.
- En Run it for, elige el perfil de dispositivo y confirma con Set as root.
Si el perfil ya tiene una raíz, el diálogo dice “Reemplaza a flow, que se ejecuta aquí ahora.” y te pide escribir el nombre del flujo reemplazado.
Una raíz nunca es ejecutada por otro flujo. Al establecer un flujo como raíz se eliminan los bloques Run flow que lo ejecutan desde otros flujos; cada uno de esos flujos obtiene una nueva versión, y el diálogo los enumera primero.
Desvincular o eliminar una raíz
- Desvincula una raíz de perfil desde sus Details: escribe el nombre del flujo para confirmar. Los dispositivos del perfil pasan entonces a la raíz de todo el inquilino.
- Eliminar un flujo raíz pide lo mismo, con Unbind and delete.
- La raíz de todo el inquilino no puede desvincularse ni eliminarse. Para retirarla, primero establece otro flujo en ejecución como raíz de todo el inquilino; después podrás eliminar la anterior.
- Una raíz debe permanecer activada y en ejecución. Solo la parada de emergencia pausa una raíz; la pausa automática nunca lo hace. Consulta Protecciones y mensajes fallidos.
Flujos que no son raíz
Un flujo que no es raíz no recibe los mensajes ordinarios de dispositivos. Se llega a él de estas formas:
| Vía | Cómo |
|---|---|
| Desde una raíz | Run flow (pasa el mensaje) o Link out / Link call |
| Cambios de alarma y actualizaciones de atributos | Un disparador Device message con el tipo alarm o attributes_updated marcado por nombre: estos llegan a todos los flujos que escuchan, sean raíz o no |
| Resultados de comandos | Los mensajes rpc_response son mensajes de dispositivo: llegan a la raíz del dispositivo. Pásalos desde ahí con Run flow. |
| Tiempo, webhooks, eventos | Disparadores Schedule, Inject, Webhook, Event y Named timer |
Un mensaje pasado con Run flow conserva su dispositivo, así que bloques como Save telemetry siguen funcionando allí.
Orden de los mensajes
Los mensajes de un mismo dispositivo se ejecutan uno tras otro, en el orden en que llegaron, hasta la primera llamada externa (una petición HTTP, un correo, una espera o un Detach). Después de ese punto el orden no está garantizado. Los mensajes de dispositivos distintos se ejecutan en paralelo.
Mensajes tardíos
Un mensaje de dispositivo que esperó más que su tiempo de vida (5 minutos por defecto, tras una caída) sigue pasando por su raíz y se almacena, marcado como tardío. Los bloques que actúan fuera de la plataforma lo omiten. Otros flujos que escuchan lo descartan. Consulte Marcas de tiempo, lecturas tardías y duplicadas.
En línea, pero no se almacena nada
Un dispositivo puede aparecer como en línea (su conexión la registra la plataforma) mientras sus lecturas no se almacenan. Comprueba:
- ¿Hay una raíz en ejecución? En Automation, filtra por el host IoT. Un flujo raíz debe estar Running. Un aviso “No worker is running the IoT host right now…” significa que el procesamiento de la plataforma está caído; contacta con soporte.
- ¿Está activada la parada de emergencia? Un aviso “Emergency stop: n flows are paused…” significa que nada se ejecuta hasta que la reanudes.
- ¿El perfil del dispositivo tiene raíz propia? Su raíz, no la de todo el inquilino, gestiona el dispositivo. Revisa su bloque Save telemetry.
- ¿El mensaje llega a Save telemetry? Abre el panel Activity de la raíz: las pestañas Debug y Errors, y los recuentos de mensajes en los cables.
- ¿Save telemetry informa errores?
not_a_device,too_old,no_values,key_limit: consulta IoT data blocks. - ¿Está disponible la automatización de IoT para su organización? Sin ella, no se almacena ningún dato de dispositivo. Póngase en contacto con soporte.
Consulta también Los datos no llegan.

