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ègle | En ligne | Hors ligne | Convient à |
|---|---|---|---|
| Connexion permanente | Lorsque 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écent | Lorsque 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é uniquement | Jamais 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/connectetv1/gw/disconnectde celle-ci, et passent hors ligne lorsque la passerelle passe hors ligne.
Ce que montrent les listes
| Affichage | 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 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é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 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énement | Envoyé lorsque |
|---|---|
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 | Valeur par défaut | Plage |
|---|---|---|
| Webhooks de connexion : durée de maintien (secondes) | 30 | De 5 à 3 600. Un appareil qui oscille n’envoie rien. |
| Webhooks d’appareils par espace de travail et par minute | 600 | De 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
| 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 passe sans cesse de en ligne à hors ligne | Deux 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ées | Intervalle attendu × Facteur est trop long. Réduisez-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 supprimées (appareil en quarantaine, limite de débit, charge utile incorrecte). Voir Data does not arrive. |

