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

Fehlermeldungen

Häufige Hermetry-Fehlermeldungen und Codes – Planlimits, API, Geräteanmeldungen, gespeicherte Daten, Befehle, Flows, Alarme, Anmeldung – und was zu tun ist.

Diese Seite listet die Fehlermeldungen und Codes auf, denen Nutzer und Integrationen am häufigsten begegnen, gruppiert nach ihrem Auftreten, mit Bedeutung und Abhilfe. Meldungen werden so zitiert, wie Hermetry sie anzeigt. Codes in code font sind stabil und können sicher in Ihrer eigenen Fehlerbehandlung verwendet werden; Sätze können sich ändern. Für einen hier nicht aufgeführten Fehler suchen Sie im Abschnitt der jeweiligen Funktion oder lesen Sie Hilfe erhalten.

Plan-Limits

Ein Plan-Limit beantwortet 403 mit details.key, das das Limit benennt, details.limit mit seinem Wert und details.current mit Ihrer Anzahl.

details.key oder MeldungLimitAbhilfe
max_devices, „Das Gerätelimit dieses Kontos ist erreicht.“Geräte (43, 77 oder 403 je nach Tarif)Ungenutzte Geräte löschen (Beispielgeräte, in Quarantäne befindliche) oder den Plan ändern
„Ihr Plan erlaubt n Flows: m sind in Verwendung, und diese Bereitstellung fügt k hinzu.“Flows oder SkriptblöckeFlows löschen oder zusammenführen; siehe Flow-Limits
„Ihr Plan erlaubt 12 Kameras mit Live-Ansicht, und 12 von 12 sind belegt.“Kameras mit Live-Ansicht (12)Live-Ansicht bei einer Kamera ausschalten, die Sie nicht beobachten
Kameraminuten aufgebrauchtMonatliche Kameraminuten (10.000)Auf den nächsten Monat warten oder ein Nutzungspaket buchen
„Das Datenkontingent des Routers für diesen Monat ist aufgebraucht.“Mobilfunkdaten des Routers (10 GiB im Monat)Auf den nächsten Monat warten
key_limit (im Lauf eines Flows)Telemetrieschlüssel (250, 400 oder 2.050)Nicht benötigte Schlüssel entfernen, bevor Sie Telemetrie speichern wählen
FEATURE_NOT_AVAILABLEIhr Plan enthält die Funktion nichtMeine Module ansehen

Das monatliche IoT-Nachrichtenkontingent erzeugt nie einen Fehler: Geräte senden auch darüber hinaus weiter. Siehe Limits und Kontingente.

REST-API

Status und codeBedeutungAbhilfe
400 VALIDATION_ERROR, „Validation error“ mit issuesEin Feld verletzt eine Regelissues[].path und message lesen
400 „Fehlerhafter Anfrage-Body“Der Text ist kein gültiges JSONJSON korrigieren
401 UNAUTHORIZED, „Ungültiger oder abgelaufener API-Schlüssel.“Ein Tippfehler, ein abgelaufener oder widerrufener Schlüssel oder der Schlüssel einer anderen OrganisationSchlüssel und die tenantId im Pfad prüfen
403 „Der API-Schlüssel hat nicht die erforderliche Berechtigung.“Dem Schlüssel fehlt die Berechtigung der RouteDie Modulberechtigungen des Schlüssels bearbeiten
403 „Sie sind nicht berechtigt, diese Aktion auszuführen.“Der Inhaber des Schlüssels hat die Berechtigung nicht mehrRolle, Gruppen und Zugriffsrichtlinien des Inhabers prüfen
403 „Dieser API-Schlüssel darf von der aktuellen IP-Adresse nicht verwendet werden.“Die IP-Erlaubnisliste des Schlüssels oder der OrganisationAus einem erlaubten Netz aufrufen
403 TENANT_IP_NOT_ALLOWEDDie IP-Zugriffslisten der Organisation lehnen die Adresse abEin erlaubtes Netz verwenden
403 TENANT_SUSPENDED, TENANT_INACTIVEDie Organisation ist nicht aktivEinen Inhaber fragen
404 NOT_FOUNDNicht gefunden oder für Sie nicht sichtbarID und Berechtigungen prüfen
409 CONFLICTEin Duplikat, ein verwendeter Datensatz, ein Zustand, der die Aktion verbietet, oder eine gleichzeitige ÄnderungErneut lesen, dann entscheiden
412, 428If-Match ist veraltet oder fehltErneut lesen und mit der neuen Version senden
413Text oder Datei zu großWeniger senden
429 RATE_LIMIT_EXCEEDED, „Zu viele Anfragen. Bitte versuchen Sie es später erneut.“Das Limit pro Adresse (120 pro Minute)Retry-After abwarten
429 „Ratenlimit des API-Schlüssels überschritten. Bitte reduzieren Sie die Anfragefrequenz.“Das Limit pro Schlüssel (standardmäßig 1.000 pro Minute)Aufrufe verteilen
429 „Das API-Ratenlimit Ihres Tarifs wurde erreicht…“Das Plan-Limit der OrganisationAufrufe verteilen oder den Plan ändern
503 TENANT_READ_ONLY, „Dieser Workspace ist während der Verschiebung schreibgeschützt. Bitte versuchen Sie es später erneut.“Die Organisation wird gerade umgezogenNach Retry-After (300 s) erneut versuchen; Lesezugriffe funktionieren

Siehe Fehler und Rate-Limits.

Geräteanmeldungen und Nachrichten

CodeBedeutungAbhilfe
CONNACK 1MQTT-Version nicht unterstütztMQTT 3.1.1 verwenden
CONNACK 2Client-ID abgelehnt1 bis 64 Zeichen aus A–Z a–z 0–9 . _ : -
CONNACK 3Server nicht verfügbar oder die Adresse ist nach fehlgeschlagenen Anmeldungen kurz gesperrtMit Jitter zurückhaltend wiederholen; Gerät mit falschen Zugangsdaten korrigieren
CONNACK 4Benutzername oder Passwort falschZugangsdaten prüfen oder rotieren
CONNACK 5Nicht autorisiert; der Grund steht auf der Registerkarte Log des GerätsSiehe Ein Gerät verbindet sich nicht
unknown_reserved_topicAn ein unbekanntes Topic unter v1/ gesendetEin dokumentiertes Topic verwenden
forbidden_topicEin Downlink-Topic, ein Gateway-Topic von einem Nicht-Gateway oder Provisionierung außerhalb einer ProvisionierungssitzungDas richtige Topic für das Gerät verwenden
tls_required (HTTP 403)Eine Befehlsabfrage per einfachem HTTP, die das Profil nicht erlaubtHTTPS verwenden
child_limit, device_limitEin Gateway-Kind über dem Kind-Limit des Gateways oder dem Geräte-Limit des PlansDen Wert Max. Kinder eines Gateways des Profils erhöhen oder Geräte freigeben
child_rate_limitedEin Gateway-Kind über seinen eigenen Rate-LimitsDie Rate des Kindes senken

Gespeicherte Daten

CodeBedeutung
key_invalid, key_too_long, key_reservedDer Schlüssel verletzt eine Schlüsselregel: Zeichen, 64 Zeichen oder ein reserviertes Präfix (_, fw_, current_fw_, cfg.)
string_too_long, value_too_largeText über 1.024 Zeichen; JSON über 4 KiB; eine Zahl, die nicht endlich ist
bad_formKein Format, das der Speicher lesen kann, oder mehr als 1.000 Messpunkte in einer Nachricht
bad_tsEin Zeitstempel, der nicht in Epoch-Millisekunden angegeben ist, zu weit in der Zukunft liegt (standardmäßig 10 Minuten) oder älter ist als die Einstellungen erlauben
too_oldÄlter als Ihre Aufbewahrungsklasse für Rohdaten
no_valuesIm Datensatz konnte nichts gespeichert werden
not_a_deviceEin Telemetrie speichern in einem Flow, der durch einen Zeitplan, einen Inject, ein Ereignis oder einen Webhook gestartet wurde und sich nicht auf ein Gerät bezieht
range_too_large (History-API, 400)Mehr als 10.000 Intervalle im Zeitfenster

Siehe Daten kommen nicht an.

Befehle

GrundBedeutung
bad_paramsDie Parameter passen nicht zum Befehl
wait_too_longEin synchroner Aufruf wartet höchstens 30 s; wait: false verwenden
confirm_required, confirm_text_mismatchEin Befehl mit hoher Auswirkung braucht confirm: true, oder der eingegebene Text ist falsch
method_refusedWerkseinstellungen, Kopplung, Vergessen des WLANs und Vergessen der Cloud werden nie gesendet
rpc_method_reservedDie Methode gehört zu einem anderen Modul
rpc_not_supported_by_profileDas Profil verwendet nur die Legacy-Topics
device_not_activeDas Gerät ist deaktiviert oder in Quarantäne
not_cancellableNur ein eingereihter oder gesendeter Befehl kann abgebrochen werden
device_rate_limited, „Zu viele Befehle an dieses Gerät; versuchen Sie es in einer Minute erneut.“Mehr als 10 Befehle pro Minute an ein Gerät

Siehe Befehle erreichen das Gerät nicht.

Flows

Code oder MeldungBedeutung
circuit_openDie ausgehenden Aufrufe eines Blocks sind fehlgeschlagen und werden pausiert; er erholt sich von selbst
ssrf_blockedDie Adresse ist privat, nicht in den erlaubten Hosts des Endpunkts oder verlässt den Basispfad
timeout, memory, blocked (Skript)Das Skript hat mehr als seine CPU-Zeit (standardmäßig 50 ms) oder 32 MiB verbraucht; nach drei Abbrüchen in Folge ist es 60 Sekunden gesperrt
script_unavailable, host_busyDer Skriptdienst ist nicht erreichbar oder ausgelastet; später erneut versuchen
queue_fullEin Block hält zu viele Nachrichten oder Schlüssel
flow_cycleFlows lösen sich gegenseitig in einem Zyklus aus
„Diese Blöcke senden Nachrichten im Kreis in einer Schleife, die nie wartet“Ein Zyklus ohne wartenden Block in einem Flow
no_recipients, too_many_recipients, members_unavailable, invalid_attachment, notify_failed, limitNotify-Fehler: niemand zum Benachrichtigen, nach den Rollen mehr als 20 Empfänger, Mitglieder konnten nicht gelesen werden, ein fehlerhafter Anhang, alle Zustellungen fehlgeschlagen, jeder Kanal hat sein Kontingent ausgeschöpft

Siehe Fehlerbehebung bei Flows.

Alarme und Regeln

MeldungAbhilfe
„Ein Schlüssel benennt einen Telemetrieschlüssel: keine Leerzeichen und keine Zahl.“Den Wert in Value eintragen, nicht in Key
„Eine andere Regel dieses Profils hat diesen Typ.“Pro Profil einen eindeutigen Typ verwenden
„Zwischen 10 Sekunden und 7 Tagen.“Die Offline-Verzögerung liegt außerhalb des zulässigen Bereichs
„Eine Stummschaltung darf höchstens 90 Tage dauern.“Ein früheres Ende wählen
„Sonnenaufgang und Sonnenuntergang benötigen den Standort des Orts: Setzen Sie ihn zuerst am Ort.“Breiten- und Längengrad am Asset festlegen
„Höchstens 20 Aktionen, einschließlich der innerhalb von choices.“Die Regel der Rules-Karte aufteilen
„Dieser Gerätetyp hat keinen solchen Befehl.“Den Befehl zum Katalog des Profils hinzufügen

Profile, Assets und Boards

MeldungAbhilfe
„Noch in Verwendung durch …: zuerst verschieben oder entfernen.“Ein Profil, das noch von Geräten, Alarmregeln oder Befehlen verwendet wird, kann nicht gelöscht werden
„Zuerst ein anderes Profil als Standard festlegen.“Das Standardprofil kann nicht gelöscht werden
„Ein Asset mit untergeordneten Assets kann nicht gelöscht werden.“Zuerst die untergeordneten Assets löschen oder verschieben
„Diese Datei ist kein Dashboard-Paket, das diese Version versteht.“Eine Board-Datei importieren, die aus einem Dashboard exportiert wurde
„Nichts in diesem Paket kann hier importiert werden.“Zuerst die Module oder Widgets installieren, die das Board benötigt

Anmeldung

MeldungAbhilfe
„Dieses Konto wurde nach zu vielen fehlgeschlagenen Anmeldversuchen gesperrt. Versuchen Sie es später erneut oder setzen Sie Ihr Passwort zurück.“Warten oder das Passwort zurücksetzen
„Zu viele falsche Codes. Bitte warten Sie einige Minuten und versuchen Sie es erneut.“Warten
„Diese Organisation verlangt eine Zweistufenverifizierung. Melden Sie sich erneut an und schließen Sie sie ab.“Einen Passkey hinzufügen und damit anmelden
„Dieses Konto ist aus Sicherheitsgründen gesperrt…“Support kontaktieren

Siehe Probleme bei der Anmeldung.

Kameras und Router-Panels

Meldung oder CodeAbhilfe
„Das Bild wurde zu oft angefordert. Warten Sie einen Moment und versuchen Sie es erneut.“Mehr als 24 Live-Link-Anfragen pro Minute für eine Kamera
„Auf dieser Installation werden gerade zu viele Kameras beobachtet. Versuchen Sie es in einem Moment erneut.“Die Kapazität der Installation; erneut versuchen
ttl_idle, ttl_hard, lte_cap, no_dial … (Panel-Sitzung Ended because)Siehe Grenzen und Protokollierung des Fernzugriffs

Verwandt