Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Verbindungsstatus und Aktivität

Wie Hermetry über Online und Offline, Last seen und Inaktivität entscheidet, das Geräte-Log mit 30 Tagen Historie und Verbindungs-Webhooks.

Jedes Gerät hat einen Verbindungsstatus, den Listen, Boards, Regeln und Alarme auslesen: Ist es online, wann hat man zuletzt von ihm gehört, ist es still geworden? 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 auf dem Tab Online status des Profils festgelegt und nie aus dem Transportweg abgeleitet. Siehe Device profiles.

RegelOnlineOfflinePasst
Live-VerbindungWenn sich das Gerät über MQTT verbindet.Wenn seine MQTT-Sitzung endet (Trennung, Keepalive-Timeout, Übernahme ohne neue Sitzung, Ablehnung).Geräte, die MQTT offen halten.
Letzte NachrichtWenn sich das Gerät verbindet oder irgendetwas sendet.Wenn für Expected interval × Factor nichts eingegangen ist (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.
Nur zuletzt gesehenWird nie als online oder offline angezeigt.—Abgefragte Geräte, Geräte, deren Rhythmus 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 einem neueren Disconnect nicht online.
  • Eine minütliche Prüfung setzt Geräte auf offline, wenn ihr Zeitfenster abgelaufen ist oder ihre Sitzungsfreigabe (Session Lease) abgelaufen ist, und übernimmt eine geänderte Online-Regel.
  • Untergeordnete Geräte eines Gateways folgen den Nachrichten v1/gw/connect und v1/gw/disconnect ihres Gateways und gehen offline, wenn das Gateway offline geht.

Was die Listen anzeigen

AnzeigeBedeutung
OnlineNach der Regel des Profils ist das Gerät jetzt online.
OfflineEs war online und ist es jetzt nicht mehr. Die Kurzansicht ergänzt Last disconnect: reason.
Zuletzt gesehen timeDas Profil verwendet Last seen only.
Nie verbundenVon dem Gerät ist bisher nichts eingegangen.
Veraltet: keine Daten seit timeAuf einer Gerätetabellen-Karte mit gesetztem Stale after (seconds): online, aber seit länger als diesem Wert ohne Daten.

Die Overview des Geräts zeigt Last activity, Last connected und Last disconnected. IP address ist die Adresse des neuesten Connect; bei einem Gerät, das sich nie verbindet (HTTP, abgefragt), ist es die Adresse seiner neuesten Aktivität.

Inaktivität: online, aber ruhig

Ein Gerät kann seine Verbindung halten und trotzdem nichts senden. Das 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 bedeutet nicht offline.

Verwenden Sie es im Regel-Trigger der Karte Rules A device connects or disconnects > goes quiet. Alarme für ein Gerät, das nicht mehr berichtet, werden mit einer Device offline rule in den Alarmregeln des Profils eingerichtet, die ihre 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 gemeinsamen Zeitleiste, neueste zuerst. Show filtert nach All, Connections oder Changes; Load more lädt weiter zurückliegende Einträge.

Verbindungsereignisse

EreignisDetail
Verbundenüber den Transportweg (zum Beispiel mqtts), von der Adresse des Clients
GetrenntGrund: reason
Von einer neuen Sitzung übernommenEine zweite Verbindung desselben Geräts hat die Sitzung übernommen.
Auf „Zuletzt gesehen“ umgestelltDie Regel des Profils wurde auf Last seen only geändert.

Trennungsgründe: client_disconnect, keepalive_timeout, takeover, auth_revoked, rate_limit, server_shutdown, uplink_window_expired (das Zeitfenster 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 lang aufbewahrt. Geräte mit Last seen only schreiben keine Connect- und Disconnect-Einträge.

Webhooks

Zwei Webhook-Ereignisse informieren andere Systeme über Verbindungsänderungen:

EreignisGesendet, wenn
device.connectedDas Gerät ist online gekommen und war für die Haltezeit durchgehend online.
device.disconnectedDas Gerät ist offline gegangen und war für die Haltezeit durchgehend 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:

EinstellungStandardBereich
Verbindungs-Webhooks: Haltezeit (Sekunden)305 bis 3.600. Ein flatterndes Gerät sendet nichts.
Geräte-Webhooks pro Workspace und Minute6001 bis 100.000. Der Rest der Minute wird verworfen, und Ihre Administratoren werden einmal benachrichtigt. Die Webhooks für den 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ätetabellen-Karte zeigt den Live-Verbindungsstatus je Zeile. Siehe Tables and lists.

API

AufrufLiefert
GET /tenant/{tenantId}/api/iot/devices/{deviceId}/connections?page=1&pageSize=50Das Verbindungsprotokoll, neueste zuerst (bis zu 100 pro Seite).
GET …/devices/{deviceId}/log?source=connectionDas Protokoll des Tabs Log; source ist connection oder audit, höchstens 1.000 Einträge tief.
GET …/devices/{deviceId}/connectionWohin das Gerät sich verbindet: Broker, HTTPS-Basis, Topics und Schlüssel. Nichts Geheimes.

Fehlerbehebung

SymptomUrsache
Ein HTTP-Gerät ist nie onlineSein Profil verwendet Live connection. Verwenden Sie Recent message.
Ein Gerät wechselt ständig zwischen online und offlineZwei Geräte teilen sich eine Zugangsdaten-Sitzung (achten Sie auf Taken over by a new session), oder das Keepalive ist für das Netzwerk zu kurz.
Offline lange nach dem VerstummenExpected interval × Factor ist zu lang. Verkürzen Sie es oder fügen Sie einen Offline-Alarm mit eigener Zeit hinzu.
Online, aber keine WerteDas Gerät sendet nichts, oder seine Daten werden verworfen (Gerät in Quarantäne, Ratenlimit, fehlerhafte Nutzlast). Siehe Data does not arrive.