Jedes Gerät hat einen Verbindungsstatus, den Listen, Boards, Regeln und Alarme auslesen: Ist es online, wann wurde zuletzt etwas von ihm empfangen, hat es sich still verhalten? Hermetry leitet dies aus dem Verhalten des Geräts ab (verbindet, trennt, sendet Nachrichten) nach der Online-Regel des Geräteprofils. Diese Seite erklärt die Regeln, die Zeitstempel, den Log-Tab des Geräts und die Webhooks.
Die Online-Regel
Die Regel wird im Tab Online status des Profils festgelegt und nie aus dem Transportweg abgeleitet. Siehe Device profiles.
| Regel | Online | Offline | Geeignet für |
|---|---|---|---|
| Live connection | Wenn sich das Gerät über MQTT verbindet. | Wenn seine MQTT-Sitzung endet (Trennung, Keepalive-Timeout, Übernahme ohne neue Sitzung, Ablehnung). | Geräte, die MQTT geöffnet halten. |
| Recent message | Wenn sich das Gerät verbindet oder irgendetwas sendet. | Wenn Expected interval × Factor verstrichen sind ohne eingehende Daten (zum Beispiel 3.600 s × 3 = 3 Stunden). Eine Trennung allein macht das Gerät nicht offline, solange seine letzte Nachricht noch aktuell ist. | Geräte, die berichten und sich danach trennen, HTTP-Geräte, LoRaWAN-Sensoren. |
| Last seen only | Wird nie als online oder offline angezeigt. | — | Abgefragte Geräte, Geräte, deren Takt unbekannt ist. |
Details:
- Eine HTTP-Anfrage ist Aktivität, keine Verbindung. Bei einem Profil mit Live connection ist ein HTTP-Gerät nie online.
- Ereignisse, die außer der Reihenfolge eintreffen, setzen den Status nie zurück: Ein alter Connect macht ein Gerät nach einer neueren Trennung nicht online.
- Eine minütliche Prüfung setzt Geräte offline, wenn ihr Fenster abgelaufen ist oder ihre Sitzungsfrist (session lease) verfallen ist, und wendet eine geänderte Online-Regel an.
- Untergeordnete Gateway-Geräte folgen den Nachrichten
v1/gw/connectundv1/gw/disconnectihres Gateways und gehen offline, wenn das Gateway offline geht.
Was die Listen anzeigen
| Anzeige | Bedeutung |
|---|---|
| Online | Nach der Regel des Profils ist das Gerät jetzt online. |
| Offline | Es war online und ist jetzt nicht mehr. Die Kurzansicht zeigt zusätzlich Last disconnect: Grund. |
| Last seen Zeit | Das Profil verwendet Last seen only. |
| Never connected | Von dem Gerät wurde noch nichts empfangen. |
| Stale: no data for Zeit | Auf einer Gerätetabellenkarte mit gesetztem Stale after (seconds): online, aber seit länger als diesem Wert keine Daten. |
Die Overview des Geräts zeigt Last activity, Last connected und Last disconnected. IP address ist die Adresse des neuesten Connects; bei einem Gerät, das sich nie verbindet (HTTP, abgefragt), ist es die Adresse seiner neuesten Aktivität.
Inaktivität: online, aber still
Ein Gerät kann seine Verbindung halten und dennoch nichts senden. Der Inactivity timeout (seconds) des Profils (standardmäßig 600, 10 bis 604.800) markiert ein Gerät als inaktiv, wenn es so lange nichts gesendet hat. Inaktiv ist nicht offline.
Verwenden Sie dies im Auslöser der Rules-Karte A device connects or disconnects > goes quiet. Alarme für ein Gerät, das nicht mehr meldet, werden mit einer Device offline rule in den Alarmregeln des Profils eingerichtet, die eine eigene Zeit hat (Open after (seconds offline)). Siehe Offline alarms.
Der Log-Tab
Der Tab Log des Geräts zeigt seine Verbindungshistorie und die daran vorgenommenen Änderungen in einer Zeitleiste, neueste zuerst. Show filtert nach All, Connections oder Changes; Load more lädt weiter zurückliegende Einträge.
Connection events
| Ereignis | Detail |
|---|---|
| Connected | über den Transportweg (zum Beispiel mqtts), von der Adresse des Clients |
| Disconnected | Reason: Grund |
| Taken over by a new session | Eine zweite Verbindung desselben Geräts hat übernommen. |
| Switched to last seen only | Die Regel des Profils wurde auf Last seen only geändert. |
Trenngründe: client_disconnect, keepalive_timeout, takeover, auth_revoked, rate_limit, server_shutdown, uplink_window_expired (das Fenster Recent message ist abgelaufen) und online_rule_changed. Eine abgelehnte Anmeldung (CONNACK 5) wird ebenfalls mit ihrem Grund protokolliert; dieser wird nie an das Gerät gesendet.
Changes sind die protokollierten Änderungen: Device created, Device edited (mit den geänderten Feldern), Device activated, Device quarantined, Device disabled, Credential replaced, Credential rotated, Credential revoked, Attributes saved, Attributes deleted, gesendete, abgebrochene, abgelehnte und abgeschlossene Befehle sowie bestätigte und gelöschte Alarme, jeweils by eine Person oder by the system.
Die Verbindungshistorie wird 30 Tage aufbewahrt. Geräte mit Last seen only schreiben keine Connect- und Disconnect-Einträge.
Webhooks
Zwei Webhook-Ereignisse informieren andere Systeme über Verbindungsänderungen:
| Ereignis | Gesendet, wenn |
|---|---|
device.connected | Das Gerät ist online gegangen und blieb für die Haltezeit online. |
device.disconnected | Das Gerät ist offline gegangen und blieb für die Haltezeit offline. |
{ "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 }Zwei Einstellungen unter Devices > ⋯ > Settings (Gruppe Webhooks) steuern sie:
| Einstellung | Standard | Bereich |
|---|---|---|
| Connection webhooks: hold time (seconds) | 30 | 5 bis 3.600. Ein flatterndes Gerät sendet nichts. |
| Device webhooks per workspace and minute | 600 | 1 bis 100.000. Der Rest der Minute wird verworfen und Ihre Administratoren werden einmalig benachrichtigt. Die Webhooks zum Gerätelebenszyklus haben einen eigenen Zähler mit demselben Limit. |
Die Adresse in device.connected ist nur ein Netzwerkpräfix. Jedes Ereignis trägt einen Idempotenzschlüssel, sodass Ihr Empfänger Wiederholungen ignorieren kann. Siehe Webhooks.
Geräte zählen
Dashboards können Devices, Devices online, Devices offline und Devices never connected als Zähler anzeigen; die Gerätetabellenkarte zeigt den aktuellen Verbindungsstatus pro Zeile. Siehe Tables and lists.
API
| Aufruf | Liefert |
|---|---|
GET /tenant/{tenantId}/api/iot/devices/{deviceId}/connections?page=1&pageSize=50 | Das Verbindungsprotokoll, neueste zuerst (bis zu 100 pro Seite). |
GET …/devices/{deviceId}/log?source=connection | Das Protokoll des Tabs Log; source ist connection oder audit, höchstens 1.000 Einträge tief. |
GET …/devices/{deviceId}/connection | Wohin sich das Gerät verbindet: Broker, HTTPS-Basis, Topics und Schlüssel. Nichts Geheimes. |
Fehlerbehebung
| Symptom | Ursache |
|---|---|
| Ein HTTP-Gerät ist nie online | Sein Profil verwendet Live connection. Verwenden Sie Recent message. |
| Ein Gerät wechselt ständig zwischen online und offline | Zwei Geräte teilen sich eine Anmeldeinformation (achten Sie auf Taken over by a new session), oder das Keepalive ist für das Netz zu kurz. |
| Offline lange nachdem es aufgehört hat zu senden | Expected interval × Factor ist groß. Verkürzen Sie es oder fügen Sie einen Offline-Alarm mit eigener Zeit hinzu. |
| Online, aber keine Werte | Das Gerät sendet nichts, oder seine Daten werden verworfen (Gerät in Quarantäne, Ratenbegrenzung, fehlerhafte Nutzlast). Siehe Data does not arrive. |