API-Diagnose
Eine Funktionsprüfung des Datenaustauschs zwischen AI Analytics und der Plattform der Messgeräte, die jede Anfrage testet, auf die sich die übrigen Berichte stützen.
Eine Funktionsprüfung des Datenaustauschs zwischen AI Analytics und der Plattform der Messgeräte. Der Bericht ruft nacheinander alle Plattformanfragen ab, die von den übrigen Berichten verwendet werden, und zeigt, welche davon normal antworten und welche einen Fehler zurückgeben. Zielgruppe sind Administrator und technischer Support: Führen Sie ihn aus, wenn Sie eine Integrationsstörung vermuten, und sehen Sie sofort, wo die Verbindung zum Gerät oder zum Server unterbrochen ist.
Was er zeigt
Für jede Art von Plattformanfrage — eine Zeile mit dem Ergebnis: welcher Endpunkt aufgerufen wurde, ob der Server erfolgreich geantwortet hat, wie viele Datenzeilen er zurückgegeben hat und welche Felder in der ersten Zeile enthalten waren (zur Bestätigung, dass sich das Datenformat nicht geändert hat).
| Zeilenelement | Bedeutung |
|---|---|
| Anfrage-Endpunkt | welche Art von Daten geprüft wurde (Login, Geräteflotten-Liste, Verzeichnisse, Verbindungssitzungen, Messarchive, Geräte-Datenblatt) |
| Status | ob der Server erfolgreich geantwortet oder einen Fehler zurückgegeben hat |
| Zeilenanzahl | wie viele Datensätze in der Antwort eingetroffen sind |
| Feldproben | Feldnamen aus dem ersten Datensatz — ein Indiz dafür, dass sich das Format nicht geändert hat |
Die Zeilenfarbe ergibt sich aus dem Antwortcode des Servers:
| Farbe | Bedeutung |
|---|---|
| Grün («200») | die Anfrage funktioniert normal |
| Gelb (Berechtigungsfehler, außer «nicht gefunden») | Zugriffsrechte müssen geprüft werden |
| Rot (Serverfehler oder keine rechtzeitige Antwort) | ein Problem auf der Serverseite |
| Grau («404» — nicht gefunden) | diese Anfrage existiert in dieser Plattformversion nicht |
Wie er berechnet wird
Der Bericht ruft nacheinander alle Plattformanfragen ab, die von den übrigen Berichten verwendet werden: Login, Geräteflotten-Liste, Verzeichnisse (Gerätetypen, Versorgungsunternehmen, Kunden), Verbindungssitzungen (in vier Parametervarianten), Messarchive (stündlich, täglich, monatlich, Einstellungen), Archive von Störsituationen und Ereignisprotokolle sowie das Geräte-Datenblatt. Für jeden Aufruf werden der Endpunkt, die Serverantwort, die Zeilenanzahl und eine Feldprobe erfasst. Ist ein bestimmter Knoten festgelegt, werden zusätzlich die Archive der Störsituationen für diesen Knoten geprüft.
Ausführungsparameter
| Parameter | Standard | Bedeutung |
|---|---|---|
| Knoten-ID für die Prüfung des Störarchivs (optional) | wird aus dem Kontext übernommen | wenn gesetzt — läuft die Prüfung auf diesem Knoten; wenn leer — wird der erste Knoten aus der Geräteflotten-Liste herangezogen |
Wie man ihn liest
Achten Sie auf die Zeilenfarben. Alles grün — der Datenaustausch ist gesund. Gelbe Zeilen bedeuten, dass der Server vorhanden ist, aber ohne die erforderlichen Rechte keine Daten zurückgibt — ein Grund, die Zugriffsrechte zu prüfen. Rote Zeilen sind ein Ausfall auf der Serverseite und werden zuerst behandelt. Graue Zeilen («nicht gefunden») sind oft normal: Nicht alle Geräte unterstützen alle Archivarten, daher ist das Fehlen von Störarchiven auf einem bestimmten Gerät kein Fehler.
Beachten Sie eine Besonderheit beim Login: Die Plattform verwendet ein zuvor erhaltenes Ticket etwa zwei Wochen lang weiter, daher ist die Login-Prüfung in der Regel erfolgreich, auch ohne eine tatsächliche erneute Anmeldung am Server.
Verwandte Berichte
Dieser Bericht ist eigenständig und hängt von nichts ab. Alle übrigen Geräteflotten-Berichte verwenden dieselben Plattformanfragen, die er prüft — wenn sie also fehlschlagen, beginnt hier die Diagnose.
War diese Seite hilfreich?
Danke für dein Feedback!