Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Hôtes, flux racine et racines de profil

Les hôtes IoT et General, comment chaque message d'appareil atteint une seule racine, la racine par défaut, les racines de profil, et ce qu'il faut vérifier lorsque rien n'est stocké.

Un hôte est la partie de Hermetry qui exécute les flux d’un type donné. L’hôte IoT exécute les flux qui reçoivent les messages des appareils ; l’hôte General exécute les flux pour les planifications, les webhooks et les événements. Sur l’hôte IoT, chaque message d’appareil est envoyé à exactement un flux racine, qui stocke les données. Cette page explique les hôtes, les flux racines et comment les modifier en toute sécurité.

Les deux hôtes

IoTGeneral
Types de messagestelemetry, attributes, connect, disconnect, activity, inactivity, rpc_request, rpc_response, attributes_updated, alarm ; ainsi que les planifications, injections, webhooks, minuteries et événementsPlanifications, injections, webhooks, minuteries, événements et messages provenant d’autres flux
Flux racinesOui : la racine à l’échelle du locataire et les racines de profilNon
Blocs d’appareilDevice message, Save telemetry, Save attributes, Alarm rules, Send command, Raise alarm, blocs d’enrichissement …Non
Nombre mensuelLes messages d’appareil comptent comme messages IoTLes entrées acceptées comptent comme messages Automation

Vous choisissez l’hôte lors de la création d’un flux ; il ne peut pas être modifié ensuite. Le filtre Hôte de la liste des flux affiche les flux d’un seul hôte.

Flux racines

Un flux racine est le point d’entrée des messages d’appareil d’un hôte. Sur l’hôte IoT, il en existe deux types :

RacineS’exécute pourObligatoire
Racine à l’échelle du locataireChaque appareil dont le profil n’a pas de racine propreOui : il y en a toujours une. Elle peut être remplacée, jamais supprimée.
Racine de profilLes appareils d’un même profil d’appareilNon

Chaque message d’appareil démarre une racine : celle de son profil si elle existe, sinon la racine à l’échelle du locataire. Il entre par le bloc Flow input de la racine (nommé Device messages dans la racine par défaut). La télémétrie arrive à raison d’un message par enregistrement : un appareil qui envoie un lot de 10 enregistrements horodatés démarre 10 messages.

Les flux racines affichent un badge Root dans la liste des flux, avec ce qu’ils exécutent (« Root · Tenant-wide », ou le nom du profil).

Le flux racine par défaut

Chaque organisation commence avec le Default root flow, lié à l’échelle du locataire. Il est créé et déployé automatiquement :

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

« Chaque message d’appareil de la portée de cette racine entre par son Flow input : les règles d’alarme du profil d’appareil sont évaluées, la télémétrie et les attributs client sont enregistrés, les requêtes RPC des appareils et les autres messages sont journalisés. Si vous supprimez un nœud d’enregistrement, ces données ne sont plus stockées. »

Vous pouvez le modifier comme n’importe quel flux : ajouter des valeurs dérivées, du transfert ou des filtres. Gardez Alarm rules, Save telemetry et Save client attributes sur leurs chemins, sinon ce travail s’arrête pour tous les appareils servis par la racine.

Créer une racine de profil

Utilisez une racine de profil lorsqu’un groupe d’appareils nécessite un traitement différent, par exemple un décodeur pour un profil qui envoie des données binaires, ou des étapes supplémentaires pour une gamme de produits.

  1. Créez un flux sur l’hôte IoT, idéalement à partir du modèle Default root flow afin que le chemin de stockage soit présent dès le départ.
  2. Ajoutez vos étapes. Gardez Alarm rules, Save telemetry et Save client attributes.
  3. Déployez-le activé. « Seul un flux en cours d’exécution peut être une racine ici. »
  4. Dans la liste des flux, ouvrez les Details du flux et sélectionnez Set as root.
  5. Sous Run it for, choisissez le profil d’appareil et confirmez avec Set as root.

Si le profil a déjà une racine, la boîte de dialogue indique « Elle remplace flow, qui s’exécute ici actuellement. » et vous demande de saisir le nom du flux remplacé.

Une racine n’est jamais exécutée par un autre flux. Définir un flux comme racine supprime les blocs Run flow qui l’exécutent depuis d’autres flux ; chacun de ces flux reçoit une nouvelle version, et la boîte de dialogue les liste en premier.

Détacher ou supprimer une racine

  • Unbind une racine de profil depuis ses Details : saisissez le nom du flux pour confirmer. Les appareils du profil passent alors à la racine à l’échelle du locataire.
  • La suppression d’un flux racine demande la même chose, avec Unbind and delete.
  • La racine à l’échelle du locataire ne peut pas être détachée ni supprimée. Pour la retirer, définissez d’abord un autre flux en cours d’exécution comme racine à l’échelle du locataire ; l’ancienne pourra alors être supprimée.
  • Une racine doit rester activée et en cours d’exécution. Seul l’arrêt d’urgence met une racine en pause ; la pause automatique ne le fait jamais. Voir Protections et messages en échec.

Flux qui ne sont pas des racines

Un flux qui n’est pas une racine n’entend pas les messages d’appareil ordinaires. Il est atteint par les moyens suivants :

MoyenFonctionnement
Depuis une racineRun flow (transmet le message) ou Link out / Link call
Changements d’alarme et mises à jour d’attributsUn déclencheur Device message avec le type alarm ou attributes_updated coché par nom : ceux-ci vont à chaque flux à l’écoute, racine ou non
Résultats de commandesLes messages rpc_response sont des messages d’appareil : ils atteignent la racine de l’appareil. Transmettez-les ensuite depuis celle-ci avec Run flow.
Temps, webhooks, événementsDéclencheurs Schedule, Inject, Webhook, Event et Named timer

Un message transmis avec Run flow conserve son appareil, donc des blocs comme Save telemetry fonctionnent toujours là-bas.

Ordre des messages

Les messages d’un même appareil s’exécutent les uns après les autres, dans l’ordre d’arrivée, jusqu’au premier appel externe (une requête HTTP, un e-mail, une attente ou un Detach). Au-delà de ce point, leur ordre n’est pas garanti. Les messages d’appareils différents s’exécutent en parallèle.

Messages tardifs

Un message d’appareil qui a attendu plus longtemps que son time-to-live (5 minutes par défaut, après une panne) traverse toujours son root et est stocké, marqué en retard. Les blocs qui agissent hors de la plateforme l’ignorent. Les autres flux à l’écoute le suppriment. Voir Timestamps, late and duplicate readings.

En ligne, mais rien n’est stocké

Un appareil peut apparaître en ligne (sa connexion est suivie par la plateforme) alors que ses relevés ne sont pas stockés. Vérifiez :

  1. Y a-t-il une racine en cours d’exécution ? Dans Automation, filtrez par l’hôte IoT. Un flux racine doit être Running. Une bannière « No worker is running the IoT host right now… » signifie que le traitement de la plateforme est arrêté ; contactez le support.
  2. L’arrêt d’urgence est-il activé ? Une bannière « Emergency stop: n flows are paused… » signifie que rien ne s’exécute tant que vous ne reprenez pas.
  3. Le profil de l’appareil a-t-il sa propre racine ? C’est sa racine, et non celle à l’échelle du locataire, qui traite l’appareil. Vérifiez son bloc Save telemetry.
  4. Le message atteint-il Save telemetry ? Ouvrez le panneau Activity de la racine : les onglets Debug et Errors, et les compteurs de messages sur les liaisons.
  5. Save telemetry signale-t-il des erreurs ? not_a_device, too_old, no_values, key_limit : voir IoT data blocks.
  6. L’automatisation IoT est-elle disponible pour votre organisation ? Sans elle, aucune donnée d’appareil n’est stockée. Contactez le support.

Voir aussi Data does not arrive.