Wie rufe ich Ladestationsprotokoll mit „Get Diagnostics" ab?

Was ist „Get Diagnostics"?

Get Diagnostics ist ein OCPP-Befehl, der eine Ladestation anweist, ihre internen Protokolldateien zu bündeln und an ein von dir gewähltes Ziel hochzuladen. Diese Protokolle werden von der firmware der Ladestation selbst geschrieben und enthalten daher oft weitaus mehr Details als die OCPP-Nachrichten, die du in Monta bereits einsehen kannst. Das macht sie besonders wertvoll, wenn du einen Hardwarefehler oder einen fehlgeschlagenen Ladevorgang untersuchst oder Belege für eine Garantieanfrage oder eine Supportanfrage beim Hersteller zusammenstellst.

Mit Monta Control kannst du diesen Befehl aus der Ferne senden, sodass du nicht vor Ort sein musst. Je nach OCPP-Version und den Fähigkeiten der Ladestation sendet Monta einen der folgenden Befehle:

• OCPP 1.6: GetDiagnostics (Standardprotokolle) oder GetLog (erweiterte Diagnose- und Sicherheitsprotokolle über die OCA-Sicherheitserweiterungen)
• OCPP 2.0.1: GetLog

Bevor du beginnst

1. Überprüfe, ob deine Ladestation „Get Diagnostics" unterstützt. Die Unterstützung ist hardwarespezifisch: Sie variiert je nach Marke, Modell und Firmware-Version, und einige Modelle unterstützen es überhaupt nicht. Viele Ladestationen geben über den OCPP-Konfigurationsschlüssel SupportedFileTransferProtocols an, welche Übertragungsprotokolle sie akzeptieren. Wenn dein Modell dies meldet, verwende eines der aufgeführten Protokolle. Wenn du dir nicht sicher bist, wende dich an den Hersteller.
2. Bereite ein Upload-Ziel vor: eine URL, die die Ladestation erreichen und beschreiben kann. Siehe Verwendung eines Drittanbieter-Servers oder Eigenen Server einrichten weiter unten.
3. Stelle sicher, dass die Ladestation online ist. „Diagnose abrufen" funktioniert nur, wenn die Station verbunden ist; die Anfrage wird für Offline-Stationen abgelehnt.

So verwendest du „Diagnose abrufen" in Monta Control

1. Gehe in Monta Control zu Ladestationen in der Seitenleiste.
2. Suche nach der Station anhand des Namens oder der Kennung und klicke darauf, um die Detailansicht zu öffnen.
3. Öffne das Menü Aktionen und wähle Diagnose abrufen.
4. Fülle im Dialogfeld Folgendes aus:
   • Diagnosetyp legt fest, was abgerufen werden soll:
     • Standard: das Standard-Diagnoseprotokoll (OCPP 1.6 GetDiagnostics). Beginne hier, sofern kein spezifischer Grund dagegen spricht.
     • Diagnose: erweitertes Diagnoseprotokoll (verwendet GetLog; erfordert Security-Extension oder OCPP 2.0.1-Unterstützung an der Ladestation).
     • Sicherheitsprotokoll: das Sicherheitsereignisprotokoll der Station (verwendet ebenfalls GetLog).
   • Upload-Speicherort (erforderlich): die vollständige URL, an die die Station die Datei hochladen soll (zum Beispiel ftps://user:password@logs.example.com/diagnostics/ oder https://logs.example.com/upload). Monta prüft, ob es sich um eine gültige URL handelt. Siehe Tipps zur Upload-Speicherort-URL weiter unten.
   • Startdatum/-uhrzeit (optional): die ältesten einzuschließenden Protokolle. Leer lassen, um alle verfügbaren Protokolle einzuschließen.
   • Enddatum/-uhrzeit (optional): die neuesten einzuschließenden Protokolle. Leer lassen, um Protokolle bis zum aktuellen Zeitpunkt einzuschließen.
5. Klicke auf Senden.

Wie geht es weiter

• Die Ladestation bestätigt die Anfrage. Wenn sie diese akzeptiert, zeigt Monta eine Bestätigung an, die in der Regel den Dateinamen enthält, den die Station hochladen wird (zum Beispiel diag-20260311T100000.zip).
• Die Ladestation sammelt und verpackt ihre Protokolle und lädt die Datei dann an deinen Upload-Speicherort hoch.
• Während des Vorgangs meldet die Station den Fortschritt über DiagnosticsStatusNotification-Nachrichten: Idle → Uploading → Uploaded (oder UploadFailed). Du kannst diese im Tab OCPP Logs in Monta Control überwachen.
• Sobald der Upload erfolgreich abgeschlossen ist, rufe die Datei von deinem eigenen Server ab und öffne sie, da sie auf dem von dir angegebenen Ziel landet und nicht in Monta. Siehe Datei mit einem FTP-Client abrufen weiter unten.

Verwendung eines Drittanbieter-Servers

Wenn du keinen eigenen Server betreiben möchtest, können verschiedene gehostete Dateiübertragungsdienste als Upload-Ziel dienen. Diese lassen sich schnell einrichten, und ein Server, der bereits im öffentlichen Internet verfügbar ist, umgeht die im nächsten Abschnitt beschriebenen Probleme mit Heim- oder Büronetzwerken. Du übernimmst jedoch die Verantwortung für Sicherheit und Datenverarbeitung bei allem, worauf du eine Ladestation verweist.

Kostenlos / temporär (gut für einen einmaligen Test)

• SFTPCloud Free FTP Server (sftpcloud.io/tools/free-ftp-server) richtet für einen kurzen Zeitraum (ca. 60 Minuten) einen temporären FTPS/SFTP-Server ein. Nützlich für einen schnellen Test über den FTPS-Endpunkt. Behandle alles, was du auf einen kostenlosen, nicht authentifizierten temporären Server hochlädst, als potenziell öffentlich zugänglich, und verwende ihn ausschließlich für Wegwerf-Tests – niemals für echte Diagnosedaten.

Verwaltet / kostenpflichtig (für den laufenden Betrieb)

Beispiele für verwaltete Dateiübertragungsdienste, die FTPS- und/oder HTTPS-Endpunkte anbieten, sind SFTPCloud (kostenpflichtige Tarife, derselbe Anbieter wie das kostenlose Tool oben), SFTP To Go, Files.com, DriveHQ, Couchdrop sowie die eigenen verwalteten Angebote der Cloud-Anbieter (zum Beispiel AWS Transfer Family und die FTPS-Unterstützung von Azure Blob Storage).

Eigenen Server einrichten

Den Zielserver selbst zu betreiben ist die sicherste Option, da du genau kontrollierst, wer darauf zugreifen kann und was mit den Daten geschieht. Unter Linux ist vsftpd gut geeignet; unter Windows ist FileZilla Server eine gängige Wahl. Anstatt einer schrittweisen Anleitung (die je nach Distribution und Version variiert) sind hier die zu befolgenden Grundsätze aufgeführt. Die genaue Konfiguration entnimmst du der offiziellen vsftpd-Dokumentation oder der Dokumentation deines gewählten Servers.

Sicherheitsprinzipien

• Verwende ein dediziertes Konto mit einem starken, einzigartigen Passwort, das auf ein einziges Upload-Verzeichnis beschränkt (chrooted/jailed) ist und nichts anderes. Verwende niemals einen echten Admin-Login.
• Bevorzuge FTPS (FTP über TLS) oder HTTPS, damit Anmeldedaten und Daten während der Übertragung verschlüsselt sind. Vermeide einfaches FTP/HTTP, es sei denn, der Server ist nur über ein privates Netzwerk erreichbar.
• Schränke den eingehenden Zugriff mit einer Firewall ein und erlaube idealerweise nur die IP-Bereiche, die deine Ladestationen verwenden.
• Denke daran, dass die Datei sensible Betriebsdaten enthalten kann: Speichere sie sicher und lösche sie, sobald du deine Untersuchung abgeschlossen hast.

Erreichbarkeit des Servers von der Ladestation aus

• In der Regel benötigst du Port-Weiterleitung. Ladestationen befinden sich typischerweise in einem Mobilfunk-/4G-Netz oder einem separaten Netzwerk und erreichen deinen Server über das öffentliche Internet. Daher muss dein Router/deine Firewall die relevanten Ports an den Rechner weiterleiten, auf dem der Server läuft: bei FTP/FTPS sowohl den Steuerport als auch den Portbereich für passive Datenübertragung; bei HTTP/HTTPS den Web-Port.
• FTP hinter NAT ist knifflig. Die passiven Datenports von FTP passieren Home- oder Office-NAT-Router oft nicht sauber, was ein häufiger Grund dafür ist, dass Uploads stillschweigend fehlschlagen. Wenn du keinen selbst gehosteten FTP-Server zum Laufen bringst, ist ein gehosteter Dienst (vorheriger Abschnitt) oft der Weg des geringsten Widerstands.
• Die beste Option von allen: Halte den Server aus dem öffentlichen Internet heraus. Wenn sich dein Server im selben VPN oder privaten Netzwerk wie deine Ladestationen befindet, kann die Station ihn ohne öffentliche Exposition erreichen, und du kannst die Portweiterleitung vollständig überspringen. Dies ist mit Abstand das sicherste Setup. Richte den Upload Location auf die private Adresse des Servers.

Abrufen der Datei mit einem FTP-Client

Die Diagnosedatei landet auf deinem Server, nicht in Monta. Daher benötigst du eine Möglichkeit, eine Verbindung zu diesem Server herzustellen, den Ordner zu erstellen, auf den du die Station verweist, und die Datei herunterzuladen, sobald sie eintrifft. FileZilla ist ein kostenloser Dateiübertragungsclient, der hierfür geeignet ist. Monta hat keine Verbindung zu FileZilla und empfiehlt es nicht offiziell, aber wir haben festgestellt, dass es für diesen Zweck gut funktioniert; andere Tools sind ebenfalls verfügbar. Dies ist besonders wichtig beim oben genannten kostenlosen temporären Server, wo du nur ein kurzes Zeitfenster hast, um die Datei abzurufen.

1. Installiere FileZilla. Lade den kostenlosen FileZilla Client von filezilla-project.org herunter und installiere ihn.
2. Öffne den Site Manager (File > Site Manager > New site) und gib deine Serverdetails ein:
   • Protokoll: Wähle FTP - File Transfer Protocol, dann setze Verschlüsselung auf Explizites FTP über TLS erforderlich für FTPS. (Alternativ kannst du SFTP nur zum Abrufen wählen. Beachte, dass Monta selbst keine Dateien per SFTP hochladen kann – diese Option ist daher nur zum Herunterladen geeignet.)
   • Host: die Adresse deines Servers (beim kostenlosen SFTPCloud-Server die auf der Seite angezeigte Adresse, zum Beispiel eu-central-1.sftpcloud.io).
   • Port: wie angegeben (FTP/FTPS verwendet üblicherweise 21).
   • Anmeldetyp: Normal, dann Benutzername und Passwort eingeben.
3. Verbinden. Klicke auf Verbinden und akzeptiere das TLS-Zertifikat des Servers, wenn du dazu aufgefordert wirst. Im rechten Bereich (Remote) werden nun die Dateien des Servers angezeigt.
4. Erstelle den Upload-Ordner (empfohlen). Klicke im rechten Bereich mit der rechten Maustaste und wähle Verzeichnis erstellen, dann benenne ihn passend zu deinem Upload-Speicherort, zum Beispiel diagnostics. Das vorherige Erstellen des Ordners verhindert Fehler bei Ladestationen, die ein fehlendes Verzeichnis nicht selbst anlegen. Die URL deines Upload-Speicherorts endet dann mit diesem Ordner, zum Beispiel ftps://user:password@host/diagnostics/.
5. Rufe die Datei ab. Nachdem du „Get Diagnostics" ausgeführt hast und die Ladestation Uploaded meldet, klicke auf die Schaltfläche „Aktualisieren" in deinem FTP-Client. Die hochgeladene Datei erscheint im Ordner. Ziehe sie in einen lokalen Ordner, um sie herunterzuladen.

Tipps zur Upload-Speicherort-URL

Der Upload-Speicherort ist der Teil, bei dem die meisten Fehler gemacht werden. Einige wichtige Hinweise:

• Verwende eine vollständige, gültige URL. Monta prüft, ob der Wert eine wohlgeformte URL ist. Gib das Schema (ftp://, ftps://, http://, https://), den Host und den Pfad an, in den die Datei geschrieben werden soll.
• Nur unterstützte Schemata: ftp, ftps, http, https. Alles andere (insbesondere sftp oder scp) wird von Monta abgelehnt, auch wenn die Firmware deiner Ladestation technisch gesehen einen Upload über dieses Protokoll unterstützt.
• FTP vs. FTPS: ftp:// ist unverschlüsselt, sodass Zugangsdaten und Daten im Klartext übertragen werden. ftps:// kapselt dasselbe Protokoll in TLS und ist daher verschlüsselt. Bevorzuge FTPS, wenn Ladestation und Server dies unterstützen.
• Zugangsdaten in der URL einbetten: Bei FTP/FTPS kannst du Benutzername und Passwort direkt in die URL einfügen: ftps://username:password@host/path/. Beachte, dass diese Zugangsdaten in Protokolldateien im Klartext erscheinen können (sowohl auf der Monta-Seite als auch auf der Ladestation). Verwende daher ein dediziertes Konto mit eingeschränkten Rechten und kein echtes Admin-Konto, und erneuere die Zugangsdaten bei Bedarf.
• Gib gegebenenfalls einen abschließenden Pfad/ein Verzeichnis an (zum Beispiel .../diagnostics/), damit die Station weiß, wohin sie schreiben soll, und damit die hochgeladene Datei leicht auffindbar ist. Erstelle diesen Ordner zuerst auf deinem Server (siehe Datei mit einem FTP-Client abrufen oben); einige Stationen erstellen ein fehlendes Verzeichnis nicht automatisch.
• Die Unterstützung von Zeitbereichen variiert. Das Leer­lassen von Startdatum/-uhrzeit und Enddatum/-uhrzeit ist die einfachste und kompatibelste Wahl. Nicht alle Ladestationen berücksichtigen den Zeitfilter, und einige können keine langen Zeitbereiche hochladen, da die Datei zu groß wird. Wenn eine Anfrage mit einem großen Zeitbereich fehlschlägt, versuche es mit einem kleineren.
• Einige Stationen erfordern HTTP/HTTPS, nicht FTP. Die akzeptierten Upload-Protokolle sind hardwarespezifisch: Einige Modelle akzeptieren nur HTTP/HTTPS, andere FTP/FTPS. Wenn ein Protokoll abgelehnt wird oder fehlschlägt, versuche ein anderes, das der Hersteller als unterstützt dokumentiert.
• HTTP-Server können ein PUT oder ein POST empfangen. Wenn du einen HTTP/HTTPS-Endpunkt einrichtest, beachte, dass verschiedene Modelle unterschiedlich hochladen (einige verwenden PUT, andere POST, gelegentlich als Octet-Stream). Dein Server muss daher möglicherweise beide Methoden akzeptieren.
• Verschlüsselte oder archivierte Nutzdaten: Einige Hersteller komprimieren die Protokolle in ein herstellerspezifisches Archiv (zum Beispiel ein .tar.gz, das mehrere Dateien enthält), und einige verschlüsseln den Inhalt. Wenn die Datei nicht lesbar ist, benötigst du möglicherweise ein Tool oder einen Schlüssel vom Hersteller, um sie zu öffnen. Dies liegt außerhalb von Montas Kontrolle.

Wichtige Hinweise

• Nicht alle Marken und Modelle unterstützen „Get Diagnostics". Die Unterstützung für GetDiagnostics/GetLog, den Zeitraumfilter, das Protokollformat und die akzeptierten Upload-Protokolle variiert je nach Hersteller und sogar je nach Firmware-Version. Einige Modelle unterstützen die Funktion überhaupt nicht. Der OCPP-Standard legt nicht strikt fest, wie Diagnose-Uploads funktionieren müssen, weshalb das Verhalten zwischen den Herstellern so stark abweicht. Wenn die Ladestation den Befehl ablehnt oder der Upload nie abgeschlossen wird, unterstützt das Modell diese Funktion möglicherweise schlicht nicht.
• Die Protokolle stammen von der Ladestation, nicht von Monta. Ihr Inhalt, Format, ihre Größenbeschränkungen und wie weit sie zurückreichen werden alle durch die Firmware des Herstellers bestimmt. Große Zeiträume können große Dateien und langsame Uploads erzeugen.
• Monta bietet keinen Support für das Protokollverhalten bestimmter Marken oder Modelle. Wir stellen den Mechanismus zum Senden des Befehls und das Feld zur Eingabe des Ziels bereit. Wir können herstellerspezifische Protokollformate nicht interpretieren, nicht erklären, warum ein bestimmtes Modell die Anfrage abgelehnt hat, oder vom Hersteller verschlüsselte Dateien entschlüsseln.
• Wende dich bei hardwarespezifischen Fragen an den Hersteller. Wenn eine Ladestation „Get Diagnostics" ablehnt, eine unleserliche Datei hochlädt oder sich inkonsistent verhält, ist das Support-Team des Herstellers die richtige Anlaufstelle, um herauszufinden, was das jeweilige Modell unterstützt und wie dessen Protokolle ausgelesen werden können.

Fehlerbehebung