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
| Code | Wann Hermetry ihn sendet | Zeitplan |
|---|---|---|
| 0 | Die Anmeldung wird akzeptiert | Zurücksetzen nach 60 Sekunden Verbindungsdauer (siehe unten) |
| 1 | Das CONNECT betrifft eine Protokollversion, die Hermetry nicht unterstützt, z. B. MQTT 5 | Anhalten. Client korrigieren. |
| 3 | Der 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ück | Normal |
| 4 | Unbekanntes Zugriffstoken, falscher MQTT-Benutzername oder falsches Passwort oder ein CONNECT ohne Benutzernamen | Lang |
| 5 | Nicht 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 nicht | Lang |
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.
| Situation | Standard |
|---|---|
| Der TLS-Handshake und das CONNECT werden nicht rechtzeitig abgeschlossen | 5 Sekunden ab der TCP-Verbindung |
| Zu viele Verbindungen von derselben öffentlichen Adresse melden sich im selben Moment an | 64 pro Adresse auf jedem Broker-Knoten |
| Die Adresse wird nach fehlgeschlagenen Anmeldungen gesperrt | Mehr 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 endete | Was zu tun ist |
|---|---|
| Seit dem 1,5-Fachen des Keepalive-Intervalls ist nichts eingegangen | Im normalen Zeitplan neu verbinden. Prüfen, dass das Gerät im Leerlauf PINGREQ sendet. |
| Eine andere Verbindung desselben Geräts hat die Sitzung übernommen | Im 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 überschritten | Im normalen Zeitplan neu verbinden und danach weniger senden. Siehe Device profiles. |
| Ein Broker-Knoten wird neu gestartet | Seine 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 Zeitplan | Langer Zeitplan | |
|---|---|---|
| Verwendet nach | Verlorenem Netzwerk, geschlossenem Socket, CONNACK 3 | Dem ersten CONNACK 4 oder 5 |
| Erste Wartezeit | 1 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 Wartezeiten | Bei jedem Mal verdoppelt | Bei jedem Mal verdoppelt |
| Längste Wartezeit | 5 Minuten (bis zu 30 Minuten, solange die aktive Uplink-Verbindung des Geräts volumenabhängig abgerechnet wird) | 1 Stunde |
| Jitter | Jede Wartezeit wird mit einem Zufallsfaktor zwischen 0,5 und 1,5 multipliziert | Gleich |
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
| Status | Bedeutung | Was 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 blocked | Die Adresse wird nach fehlgeschlagenen Anmeldungen gesperrt | Retry-After Sekunden warten (der Rest der Sperre). Token korrigieren. |
503 | Der Dienst ist ausgelastet, nicht bereit oder fährt herunter, oder hält Ihre Organisation zurück | Retry-After Sekunden (30) warten und dann dem normalen Zeitplan folgen. |
401 | Kein Token oder ein unbekanntes Token | Langer Zeitplan. Token prüfen. |
403 | Nicht 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, 413 | Die 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_limitsfindet. 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/seteintreffen. Sie sind anzuwenden, sobald sie eintreffen.

