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

Wiederverbindung und Backoff

Für Firmware-Entwickler: Wenn Hermetry eine Verbindung ablehnt oder beendet, was das Gerät empfängt und wie lange es vor dem nächsten Versuch warten sollte.

Diese Seite richtet sich an Personen, die Gerätefirmware oder Gateway-Software schreiben. Sie fasst an einer Stelle zusammen, was Hermetry tut, wenn es eine Verbindung ablehnt oder beendet, und wie ein Gerät danach wieder verbinden sollte. Verbindungseinstellungen, Anmeldedaten und die auf dem Log-Tab angezeigten Trennungsgründe finden sich unter MQTT; die allgemeinen Gerätregeln stehen unter Protocol versions and device rules.

Die CONNACK-Codes, die Hermetry sendet

CodeWann Hermetry ihn sendetZeitplan
0Die Anmeldung wird akzeptiertZurücksetzen nach 60 Sekunden Verbindungsdauer (siehe unten)
1Das CONNECT betrifft eine Protokollversion, die Hermetry nicht unterstützt, z. B. MQTT 5Anhalten. Client korrigieren.
3Der Dienst startet, stoppt oder ist ausgelastet; die Adresse des Geräts wird nach fehlgeschlagenen Anmeldungen kurzzeitig gesperrt; ein MQTT-Benutzername wird nach wiederholt falschen Passwörtern zurückgehalten; das Gerät wird nach einem Übernahmekonflikt zurückgehalten; die Plattform ist überlastet und hält Ihre Organisation zurückNormal
4Unbekanntes Zugriffstoken, falscher MQTT-Benutzername oder falsches Passwort oder ein CONNECT ohne BenutzernamenLang
5Nicht autorisiert: Das Gerät ist deaktiviert, sein Zertifikat ist widerrufen oder abgelaufen, die Organisation ist gesperrt oder hat ihr Geräte- oder Verbindungslimit erreicht, oder das Profil erlaubt den Anmeldetyp, das Netzwerk oder den Port nichtLang

Hermetry sendet CONNACK 2 über MQTT 3.1.1 nicht. Die Client-ID ist nie ein Grund, eine Anmeldung abzulehnen: Jede Client-ID wird akzeptiert, und die Sitzung wird unter der Seriennummer des Geräts erfasst (oder unter seiner Geräte-ID, falls es keine hat). Der Grund hinter einem Code wird nie an das Gerät gesendet; er wird im Log-Tab des Geräts geschrieben.

Verbindungen, die ohne CONNACK geschlossen werden

Einige Verbindungen werden geschlossen, bevor ein CONNACK gesendet werden kann. Das Gerät sieht nur einen geschlossenen Socket und hält sich an den normalen Zeitplan.

SituationStandard
Der TLS-Handshake und das CONNECT werden nicht rechtzeitig abgeschlossen5 Sekunden ab der TCP-Verbindung
Zu viele Verbindungen von derselben öffentlichen Adresse melden sich im selben Moment an64 pro Adresse auf jedem Broker-Knoten
Die Adresse wird nach fehlgeschlagenen Anmeldungen gesperrtMehr als 10 fehlgeschlagene Anmeldungen innerhalb von 5 Minuten sperren die Adresse für 60 Sekunden

Sitzungen, die Hermetry beendet

Hermetry sendet bei einer Trennung keinen Grundcode: Das Gerät sieht nur, dass die Verbindung geschlossen wird. Was es danach tun sollte:

Warum die Sitzung endeteWas zu tun ist
Seit dem 1,5-Fachen des Keepalive-Intervalls ist nichts eingegangenIm normalen Zeitplan neu verbinden. Prüfen, dass das Gerät im Leerlauf PINGREQ sendet.
Eine andere Verbindung desselben Geräts hat die Sitzung übernommenIm normalen Zeitplan neu verbinden. Wenn sich das wiederholt, teilen sich zwei Geräte eine Anmeldedaten.
Die Anmeldedaten wurden rotiert oder widerrufen, das Gerät wurde deaktiviert oder gelöscht, die Organisation wurde gesperrt (etwa alle 60 Sekunden erneut geprüft)Im normalen Zeitplan neu verbinden. Das nächste CONNACK (4 oder 5) setzt das Gerät auf den langen Zeitplan.
Das Gerät hat wiederholt sein Ratenlimit überschrittenIm normalen Zeitplan neu verbinden und danach weniger senden. Siehe Device profiles.
Ein Broker-Knoten wird neu gestartetSeine Verbindungen werden innerhalb von etwa 30 Sekunden in zufälliger Reihenfolge geschlossen. Im normalen Zeitplan neu verbinden; ein CONNECT, das einen gerade herunterfahrenden Knoten erreicht, erhält CONNACK 3.
Eine Nachricht konnte nicht in die Warteschlange gestellt werden (kein PUBACK erhalten)Die Sitzung wird etwa 5 Sekunden später geschlossen. Neu verbinden und danach die nicht bestätigten Nachrichten erneut senden.

Keepalive

  • Mit einem Keepalive von 60 Sekunden verbinden und PINGREQ senden, wenn nichts anderes zu senden ist.
  • Hermetry schließt eine Sitzung, wenn seit dem 1,5-Fachen des Keepalive-Intervalls nichts eingegangen ist: bei 60 also nach 90 Sekunden.
  • Ein Keepalive von 0 oder ein Wert über dem Maximum des Brokers (standardmäßig 300 Sekunden) wird mit dem Maximum bedient.
  • Eine Will-Nachricht wird akzeptiert und ignoriert. Hermetry bestimmt den Verbindungsstatus selbst.

Die beiden Backoff-Zeitpläne

Normaler ZeitplanLanger Zeitplan
Verwendet nachVerlorenem Netzwerk, geschlossenem Socket, CONNACK 3Dem ersten CONNACK 4 oder 5
Erste Wartezeit1 Sekunde (ein Gerät kann bis zu 5 Sekunden später starten)5 Minuten (ein Gerät kann bis zu 15 Minuten später starten)
Weitere WartezeitenBei jedem Mal verdoppeltBei jedem Mal verdoppelt
Längste Wartezeit5 Minuten (bis zu 30 Minuten, solange die aktive Uplink-Verbindung des Geräts volumenabhängig abgerechnet wird)1 Stunde
JitterJede Wartezeit wird mit einem Zufallsfaktor zwischen 0,5 und 1,5 multipliziertGleich

Regeln zu den Zeitplänen:

  • Der Zeitplan wird zurückgesetzt nach einer Verbindung, die mindestens 60 Sekunden gedauert hat. Eine Verbindung, die früher abbricht, setzt ihn nicht zurück, damit ein Gerät, das der Server immer wieder schließt, nicht in einer engen Schleife neu verbindet.
  • Der normale Zeitplan beginnt außerdem neu, wenn das Gerät seinen aktiven Uplink wechselt, zum Beispiel von Ethernet auf Mobilfunk.
  • Nach einem Neustart oder einem Firmware-Update ein zufälliges Intervall von 0 bis 30 Sekunden abwarten, bevor der erste Versuch erfolgt. So verbindet sich eine Welle aktualisierter Geräte nicht in einer einzigen Spitze.
  • Bei CONNACK 1 anhalten, bis der Client korrigiert ist.

Der lange Zeitplan bringt ein Gerät innerhalb von etwa 90 Minuten nach Behebung des Problems zurück, zum Beispiel nachdem das Gerät wieder aktiviert oder der Tarif erhöht wurde.

/* Wait before reconnect attempt n (n = 0, 1, 2 ...), in seconds. */
double backoff_s(int n, int long_schedule)
{
    double first = long_schedule ? 300.0 : 1.0;
    double cap   = long_schedule ? 3600.0 : 300.0;
    double wait  = first * pow(2.0, n);
    if (wait > cap)
        wait = cap;
    return wait * (0.5 + (double)rand() / RAND_MAX);   /* factor 0.5 to 1.5 */
}

Tipp

Den Zufallsgenerator auf jedem Gerät unterschiedlich initialisieren, zum Beispiel aus der Seriennummer und einer Hardware-Zufallsquelle. Geräte mit demselben Startwert wählen dieselben Wartezeiten und kommen trotzdem gleichzeitig an.

Wiederholt falsche Passwörter

Nach mehr als 5 fehlgeschlagenen Anmeldungen (CONNACK 4) für einen MQTT-Benutzernamen aus demselben Netzwerk innerhalb von 15 Minuten wird dieser Benutzername 15 Sekunden lang mit CONNACK 3 beantwortet; bei jeder weiteren Fehlanmeldung verdoppelt sich die Zeit bis zu 5 Minuten. Ein Gerät, das ein CONNACK 4 erhalten hat und danach CONNACK 3 bekommt, verwendet meist weiterhin das falsche Passwort: Es bleibt im langen Zeitplan, bis eine Verbindung gelingt.

Über die HTTP-API des Geräts

StatusBedeutungWas zu tun ist
429 rate_limitedÜber dem Limit des Geräts oder der Organisation oder über der Anfragerate der Client-Adresse (standardmäßig 50 pro Sekunde, Bursts von 200)Die Anfrage wurde nicht gespeichert. Retry-After Sekunden warten und sie dann erneut senden.
429 blockedDie Adresse wird nach fehlgeschlagenen Anmeldungen gesperrtRetry-After Sekunden warten (der Rest der Sperre). Token korrigieren.
503Der Dienst ist ausgelastet, nicht bereit oder fährt herunter, oder hält Ihre Organisation zurückRetry-After Sekunden (30) warten und dann dem normalen Zeitplan folgen.
401Kein Token oder ein unbekanntes TokenLanger Zeitplan. Token prüfen.
403Nicht autorisiert: Gerät deaktiviert, Organisation gesperrt, außerhalb der erlaubten Netzwerke des Profils oder eine Profilregel (tls_required, quarantined)Langer Zeitplan oder Konfiguration korrigieren.
400, 413Die Nachricht selbst ist fehlerhaft oder zu großDieselbe Nachricht nicht erneut senden.

Nachdem das Gerät wieder verbunden ist

Die Verbindungsreihenfolge in MQTT einhalten: abonnieren, hello senden, die gemeinsamen Attribute anfordern, dann gepufferte Messwerte vor den Live-Werten senden. Nach einem langen Ausfall sind zwei Punkte wichtig:

  • Gepufferte Messwerte müssen zur Wiedergaberate passen, die das Gerät im gemeinsamen Attribut session_limits findet. Nicht den gesamten Puffer so schnell senden, wie die Verbindung es erlaubt.
  • Nach einem Ausfall fragen viele Geräte gleichzeitig ihre Einstellungen ab, und Hermetry verteilt diese Anfragen zeitlich. Einstellungsabschnitte, die in der Antwort fehlen, können kurz darauf in derselben Form über v1/attributes/set eintreffen. Sie sind anzuwenden, sobald sie eintreffen.