État de connexion et activité

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, 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 connexion 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 connexion

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

Règle	En ligne	Hors ligne	Convient
Connexion permanente	Quand l’appareil se connecte en MQTT.	Quand sa session MQTT se termine (déconnexion, expiration du keepalive, reprise de session sans nouvelle session, refus).	Appareils qui gardent MQTT ouvert.
Message récent	Quand l’appareil se connecte ou envoie quoi que ce soit.	Quand rien n’est reçu pendant Intervalle attendu × Facteur (par exemple 3 600 s × 3 = 3 heures). Une déconnexion seule ne rend 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é uniquement	Jamais affiché comme en ligne ou hors ligne.	—	Appareils interrogés, appareils dont vous ne connaissez pas la cadence.

Détails :

Une requête HTTP est une activité, pas une connexion. Sur un profil Connexion permanente, un appareil HTTP n’est jamais en ligne.
Les événements arrivés 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 toutes les minutes met hors ligne les appareils dont la fenêtre est terminée ou dont le bail de session a expiré, et applique une règle de connexion modifiée.
Les enfants d’une passerelle suivent les messages v1/gw/connect et v1/gw/disconnect de leur passerelle et passent hors ligne lorsque celle-ci le fait.

Ce qu’affichent les listes

Affiché	Signification
En ligne	Selon la règle du profil, l’appareil est en ligne maintenant.
Hors ligne	Il était en ligne et ne l’est plus. La vue rapide ajoute Dernière déconnexion : motif.
Vu pour la dernière fois heure	Le 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ée	Sur 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 valeur.

The device’s Overview shows Last activity, Last connected and Last disconnected. IP address is the address of the newest connect; for a device that never connects (HTTP, polled) it is the address of its newest activity.

Inactivité : en ligne mais silencieux

Un appareil peut garder sa connexion tout en n’envoyant rien. Le 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 n’est 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 seule chronologie, du plus récent au plus ancien. Afficher filtre sur Tout, Connexions ou Modifications ; Charger plus remonte plus loin dans le temps.

Événements de connexion

Événement	Détail
Connecté	via le transport (par exemple `mqtts`), depuis l’adresse du client
Déconnecté	Motif : motif
Repris par une nouvelle session	Une seconde connexion du même appareil a pris le relais.
Passé en dernière activité uniquement	La 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 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, et alarmes acquittées et effacées, chacune par une personne ou par le système.

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

Webhooks

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

Événement	Envoyé quand
`device.connected`	L’appareil est passé en ligne et y est resté pendant la durée de maintien.
`device.disconnected`	L’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ètre	Par défaut	Plage
Webhooks de connexion : durée de maintien (secondes)	30	De 5 à 3 600. Un appareil instable n’envoie rien.
Webhooks d’appareils par espace de travail et par minute	600	De 1 à 100 000. Le reste de la minute est abandonné et vos administrateurs sont informés une 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, pour 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 de chaque ligne. Voir Tableaux et listes.

API

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

Dépannage

Symptôme	Cause
Un appareil HTTP n’est jamais en ligne	Son profil utilise Connexion permanente. Utilisez Message récent.
Un appareil alterne entre en ligne et hors ligne	Deux appareils partagent un même identifiant (cherchez Repris par une nouvelle session), ou le keepalive est trop court pour le réseau.
Hors ligne longtemps après l’arrêt	Intervalle attendu × Facteur est trop long. Raccourcissez-le, ou ajoutez une alarme hors ligne avec sa propre durée.
En ligne mais sans valeurs	L’appareil n’envoie rien, ou ses données sont écartées (appareil en quarantaine, limite de débit, charge utile invalide). Voir Les données n’arrivent pas.