Support-Referenzen
Wo Sie nachsehen, wenn etwas nicht funktioniert, und wie Sie uns erreichen, wenn Nachsehen nicht gereicht hat.
Das meiste, was schiefgeht, ist schon einmal vorgekommen und irgendwo in dieser Dokumentation festgehalten. Diese Seite ist die Landkarte: eine kurze Checkliste zum Durcharbeiten und danach ein Index sämtlicher Abschnitte zur Fehlerbehebung, denn diese stehen bei der jeweiligen Funktion statt an einem einzigen Ort.
Bevor Sie uns kontaktieren
Vier Schritte, der Reihe nach. Jeder davon löst einen guten Teil dessen, was sonst ein Ticket geworden wäre, und die übrigen lassen sich deutlich schneller beantworten, wenn Sie sie bereits durchlaufen haben.
1. Die Dokumentation durchsuchen
Nutzen Sie das Suchfeld oben auf jeder Seite. Es umfasst alle Seiten, nicht nur den Abschnitt, in dem Sie sich befinden, und durchsucht den Volltext statt nur die Titel.
Suchen Sie nach der Fehlermeldung oder dem Feldnamen statt nach einer Beschreibung des Symptoms. Die exakte Zeichenfolge aus einer Logzeile oder einer API-Antwort findet die gesuchte Seite weit eher als "Gerät meldet nicht".
2. Den KI-Assistenten fragen
Der KI-Assistent kann Fragen zur Plattform auf Basis der Dokumentation beantworten, was oft schneller geht, als selbst die richtige Seite zu suchen, besonders wenn Sie nicht sicher sind, wie das Gesuchte heißt.
Er ist gut bei "wie mache ich", "was bedeutet dieses Feld" und "welche Seite behandelt das". Er kann Ihre Geräte und Daten nicht sehen und wird Ihnen daher nicht sagen, warum ein bestimmter Sensor aufgehört hat zu melden.
3. In die Logs sehen
Logs erfassen Geräteaktualisierungen, Alarme, Änderungen der Zugriffsrechte, Bearbeitungen und Downlinks und lassen sich nach Ressource, Typ, Priorität und Kategorie filtern. Ein Gerät, das sich auffällig verhält, hat hier meist etwas zu sagen.
Für ein einzelnes Gerät zeigt der Reiter Logs auf der Geräteseite nur dessen Historie, und dort beginnt man normalerweise.
4. Feststellen, auf welcher Seite die Daten stehen bleiben
Das ist das mit Abstand Nützlichste, was Sie vor einem Ticket tun können, denn es entscheidet, ob das Problem überhaupt eines ist, bei dem wir etwas ausrichten können.
Für alles, was über MQTT meldet: Verbinden Sie MQTT Explorer mit dem Yggio-Broker und abonnieren Sie das Topic. Kommt die Nachricht nie beim Broker an, haben die Daten uns nicht erreicht, und der Fehler liegt vor Yggio: beim Gerät, im Netz, bei den Zugangsdaten oder beim Topic. Kommt sie beim Broker an, erscheint aber nichts in Yggio, liegt der Fehler bei uns.
Für andere Integrationen lautet dieselbe Frage nur anders gestellt: Kommen die Daten überhaupt bei Yggio an, oder scheitern sie schon vorher?
Support kontaktieren
Wenn Sie die vier Schritte durchlaufen haben und das Problem bestehen bleibt, oder wenn die Daten Yggio erreichen und dann stehen bleiben, legen Sie eine Anfrage an:
Nehmen Sie so viel davon auf, wie zutrifft. Das erspart in der Regel eine komplette Rückfragerunde:
- Was Sie erwartet haben und was stattdessen geschah.
- Welches Gerät, welcher Connector oder welcher Bericht betroffen ist, mit Name und ID.
- Wann es zuletzt funktioniert hat, falls überhaupt.
- Die genaue Fehlermeldung oder der Logeintrag, kopiert statt beschrieben.
- Wo die Daten stehen bleiben, nach Schritt 4 oben.
- Was Sie bereits versucht haben.
Fehlerbehebung nach Bereich
Fehlerbehebung steht bei der Funktion, zu der sie gehört. Dies ist der Index.
Geräte und Konnektivität
| Thema | Wo |
|---|---|
| NB-IoT-Geräte, von der SIM-Karte bis zum ersten Paket | NB-IoT-Fehlerbehebung |
| Welche Seite die Daten verliert, über MQTT | MQTT Explorer |
| Geräte jedes Protokolls hinzufügen | IoT-Knoten und Netzwerkprotokolle |
Connectors
Jede Connector-Seite endet mit einem Abschnitt zur Fehlerbehebung, der die für diese Integration spezifischen Fehler behandelt.
| Connector | Wo |
|---|---|
| Actility / Netmore ThingPark | Fehlerbehebung |
| ChirpStack V3 | Fehlerbehebung |
| ChirpStack V4 | Fehlerbehebung |
| Hubitat, und darüber Z-Wave, ZigBee und Matter | Fehlerbehebung |
| Netmore | Fehlerbehebung |
| Road Maintenance | Fehlerbehebung |
| RSMP-Lichtsignalsteuergeräte | Fehlerbehebung |
Beginnen Sie mit dem Abschnitt zur Überprüfung des jeweiligen Connectors, sofern vorhanden. Zu bestätigen, dass ein Connector durchgängig funktioniert, geht meist schneller, als sich zu überlegen, warum er es vielleicht nicht tut.
Sensoren
| Produkt | Wo |
|---|---|
| Strips, LoRaWAN | Anleitung zur Fehlerbehebung und FAQ |
| Square und Puck, LoRaWAN | FAQ |
| Z-Wave-Sensoren | Anleitung zur Fehlerbehebung und FAQ |
| Batterielaufzeit und Verbindungsqualität | Batterie in LoRaWAN-Sensoren |
Integrationen und Entwicklung
| Thema | Wo |
|---|---|
| Grafana-Installation | Fehlerbehebung |
| Node-RED | Debugging |
| Translatoren, und warum das Datenmodell zählt | Translator-Entwicklung |
| Eine Integration bauen | Eine Integration bauen |
Wenn es nicht an uns liegt
Manche Fehler liegen tatsächlich außerhalb von Yggio, und das früh zu wissen spart Tage. In diesen Fällen können folgende Stellen am schnellsten helfen:
- Der SIM-Anbieter, für Aktivierung, APN und Roaming-Berechtigungen bei Mobilfunkgeräten. Sein Portal zeigt außerdem, ob sich eine SIM-Karte im Netz angemeldet hat und wie viele Daten sie gesendet hat.
- Der Mobilfunkbetreiber, für die örtliche Abdeckung und die genutzten Frequenzbänder.
- Der Gerätehersteller, für den Befehlssatz, das Firmware-Verhalten und das Payload-Format.
- Der Betreiber des Netzwerkservers, bei einem LoRaWAN-Netz, das Sie nicht selbst betreiben.
Uns ist es dennoch lieber, von Ihnen zu hören, als dass Sie feststecken. Wenn Sie nicht sicher sind, auf welcher Seite ein Problem liegt, fragen Sie uns, und wir klären es gemeinsam.