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

Statut de connexion et activité

Comment Hermetry détermine en ligne et hors ligne, dernière activité et inactivité, le journal de l'appareil avec 30 jours d'historique, et les webhooks de connexion.

Chaque appareil dispose d’un état de connexion que lisent les listes, les tableaux de bord, les règles et les alarmes : est-il en ligne, quand a-t-on eu de ses nouvelles pour la dernière fois, et a-t-il cessé de donner signe de vie. Hermetry déduit cet état de ce que fait l’appareil (se connecte, se déconnecte, envoie des messages) selon la règle de statut en ligne du profil de l’appareil. Cette page explique les règles, les horodatages, l’onglet Log de l’appareil et les webhooks.

La règle de statut en ligne

La règle se définit dans l’onglet Online status du profil et n’est jamais déduite du transport. Voir Profils d’appareils.

RègleEn ligneHors ligneConvient à
Connexion permanenteLorsque l’appareil se connecte en MQTT.Lorsque sa session MQTT se termine (déconnexion, expiration du keepalive, reprise de session sans nouvelle session, refus).Appareils qui maintiennent une session MQTT ouverte.
Message récentLorsque l’appareil se connecte ou envoie un élément quelconque.Lorsqu’aucune donnée n’est arrivée pendant Intervalle attendu × Facteur (par exemple 3 600 s × 3 = 3 heures). Une simple déconnexion ne met pas l’appareil hors ligne tant que son dernier message est récent.Appareils qui transmettent puis se déconnectent, appareils HTTP, capteurs LoRaWAN.
Dernière activité uniquementJamais affiché comme en ligne ou hors ligne.—Appareils interrogés (polling), appareils dont le rythme est inconnu.

Détails :

  • Une requête HTTP est une activité, pas une connexion. Avec un profil en Connexion permanente, un appareil HTTP n’est jamais en ligne.
  • Les événements reçus dans le désordre ne font jamais revenir l’état en arrière : une ancienne connexion ne met jamais un appareil en ligne après une déconnexion plus récente.
  • Une vérification effectuée chaque minute met les appareils hors ligne lorsque leur fenêtre s’est terminée ou que leur bail de session a expiré, et applique une règle de statut en ligne modifiée.
  • Les enfants d’une passerelle suivent les messages v1/gw/connect et v1/gw/disconnect de celle-ci, et passent hors ligne lorsque la passerelle passe hors ligne.

Ce que montrent les listes

AffichageSignification
En ligneSelon la règle du profil, l’appareil est en ligne maintenant.
Hors ligneIl était en ligne et ne l’est plus. La vue rapide ajoute Dernière déconnexion : motif.
Vu pour la dernière fois heureLe profil utilise Dernière activité uniquement.
Jamais connectéAucune donnée n’a encore été reçue de l’appareil.
Inactif : aucune donnée depuis duréeSur une carte de tableau d’appareils dont Inactif après (secondes) est défini : en ligne, mais aucune donnée depuis plus longtemps que cette durée.

La vue Overview de l’appareil affiche Last activity, Last connected et Last disconnected. IP address est l’adresse de la connexion la plus récente ; pour un appareil qui ne se connecte jamais (HTTP, interrogé par polling), il s’agit de l’adresse de son activité la plus récente.

Inactivité : en ligne mais silencieux

Un appareil peut garder sa connexion tout en n’envoyant rien. Le délai Délai d’inactivité (secondes) du profil (600 par défaut, de 10 à 604 800) marque un appareil comme inactif lorsqu’il n’a rien envoyé pendant cette durée. Inactif ne signifie pas hors ligne.

Utilisez-le dans le déclencheur de la carte Règles Un appareil se connecte ou se déconnecte > devient silencieux. Les alarmes pour un appareil qui cesse de transmettre se définissent avec une Règle de hors ligne dans les règles d’alarme du profil, qui a sa propre durée (Ouvrir après (secondes hors ligne)). Voir Alarmes hors ligne.

L’onglet Log

L’onglet Log de l’appareil affiche son historique de connexion et les modifications qui lui ont été apportées dans une même chronologie, du plus récent au plus ancien. Afficher filtre sur Tous, Connexions ou Modifications ; Charger plus remonte plus loin dans le temps.

Événements de connexion

ÉvénementDétail
Connectévia le transport (par exemple mqtts), depuis l’adresse du client
DéconnectéMotif : motif
Repris par une nouvelle sessionUne seconde connexion du même appareil a pris le relais.
Passé en dernière activité uniquementLa règle du profil est passée à Dernière activité uniquement.

Motifs de déconnexion : client_disconnect, keepalive_timeout, takeover, auth_revoked, rate_limit, server_shutdown, uplink_window_expired (la fenêtre Message récent s’est terminée) et online_rule_changed. Une connexion refusée (CONNACK 5) est aussi journalisée avec son motif, qui n’est jamais envoyé à l’appareil.

Les Modifications sont les changements audités : Appareil créé, Appareil modifié (avec les champs modifiés), Appareil activé, Appareil mis en quarantaine, Appareil désactivé, Identifiant remplacé, Identifiant renouvelé, Identifiant révoqué, Attributs enregistrés, Attributs supprimés, commandes envoyées, annulées, refusées et terminées, ainsi que alarmes acquittées et effacées, chacune par une personne ou par le système.

L’historique de connexion est conservé pendant 30 jours. Les appareils en Dernière activité uniquement n’écrivent aucune ligne de connexion et de déconnexion.

Webhooks

Deux événements de webhook informent les autres systèmes des changements de connexion :

ÉvénementEnvoyé lorsque
device.connectedL’appareil est passé en ligne et y est resté pendant la durée de maintien.
device.disconnectedL’appareil est passé hors ligne et y est resté pendant la durée de maintien.
{ "deviceId": "…", "name": "router-17", "profileId": "…", "transport": "mqtts", "connectedAt": "2026-11-03T10:00:00.000Z", "remoteIpPrefix": "203.0.113.0/24" }
{ "deviceId": "…", "name": "router-17", "profileId": "…", "reason": "timeout", "disconnectedAt": "2026-11-03T12:00:00.000Z", "lastSeenAt": "2026-11-03T11:59:40.000Z", "onlineSeconds": 7200 }

Deux paramètres dans Appareils > ⋯ > Paramètres (groupe Webhooks) les contrôlent :

ParamètreValeur par défautPlage
Webhooks de connexion : durée de maintien (secondes)30De 5 à 3 600. Un appareil qui oscille n’envoie rien.
Webhooks d’appareils par espace de travail et par minute600De 1 à 100 000. Le reste de la minute est supprimé et vos administrateurs en sont informés une seule fois. Les webhooks du cycle de vie des appareils ont leur propre compteur, avec la même limite.

L’adresse dans device.connected n’est qu’un préfixe réseau. Chaque événement porte une clé d’idempotence, afin que votre récepteur puisse ignorer les répétitions. Voir Webhooks.

Compter les appareils

Les tableaux de bord peuvent afficher Appareils, Appareils en ligne, Appareils hors ligne et Appareils jamais connectés sous forme de compteurs, et la carte de tableau d’appareils affiche l’état de connexion en direct pour chaque ligne. Voir Tableaux et listes.

API

AppelRenvoie
GET /tenant/{tenantId}/api/iot/devices/{deviceId}/connections?page=1&pageSize=50Le journal de connexion, du plus récent au plus ancien (jusqu’à 100 par page).
GET …/devices/{deviceId}/log?source=connectionLe journal de l’onglet Log ; source vaut connection ou audit, sur 1 000 entrées au maximum.
GET …/devices/{deviceId}/connectionOù l’appareil se connecte : broker, base HTTPS, topics et clés. Aucune donnée secrète.

Dépannage

SymptômeCause
Un appareil HTTP n’est jamais en ligneSon profil utilise Connexion permanente. Utilisez Message récent.
Un appareil passe sans cesse de en ligne à hors ligneDeux appareils partagent un même identifiant (recherchez Repris par une nouvelle session), ou le keepalive est trop court pour le réseau.
Hors ligne longtemps après l’arrêt des donnéesIntervalle attendu × Facteur est trop long. Réduisez-le, ou ajoutez une alarme hors ligne avec sa propre durée.
En ligne mais sans valeursL’appareil n’envoie rien, ou ses données sont supprimées (appareil en quarantaine, limite de débit, charge utile incorrecte). Voir Data does not arrive.