Hoe haal ik laadpaal-logs op met Get Diagnostics?

Wat is Get Diagnostics?

Get Diagnostics is een OCPP-opdracht die een laadpaal instrueert om de interne logbestanden te bundelen en te uploaden naar een door jou gekozen bestemming. Deze logboeken worden geschreven door de eigen firmware van de laadpaal en bevatten daardoor vaak veel meer detail dan de OCPP-berichten die je al in Monta kunt zien. Dat maakt ze waardevol bij het onderzoeken van een hardwarefout, een mislukte laadsessie, of bij het verzamelen van bewijs voor een garantieclaim of een ondersteuningsverzoek bij de fabrikant.

Met Monta Control kun je deze opdracht op afstand versturen, zodat je niet ter plaatse hoeft te zijn. Afhankelijk van de OCPP-versie en de mogelijkheden van de laadpaal stuurt Monta een van de volgende opdrachten:

• OCPP 1.6: GetDiagnostics (standaardlogboeken) of GetLog (uitgebreide diagnostiek en beveiligingslogboeken, via de OCA-beveiligingsextensies)
• OCPP 2.0.1: GetLog

Voordat je begint

1. Controleer of je laadpaal Get Diagnostics ondersteunt. Ondersteuning is hardwarespecifiek: het verschilt per merk, model en firmwareversie, en sommige modellen ondersteunen het helemaal niet. Veel laadpalen geven aan welke overdrachtsprotocollen ze accepteren via de OCPP-configuratiesleutel SupportedFileTransferProtocols. Als jouw model dit rapporteert, gebruik dan een van de vermelde protocollen. Raadpleeg bij twijfel de fabrikant.
2. Zorg dat je een uploadbestemming klaar hebt: een URL die de laadpaal kan bereiken en waarnaar hij kan schrijven. Zie Een externe server gebruiken of Je eigen server instellen hieronder.
3. Zorg dat de laadpaal online is. Diagnostics ophalen werkt alleen wanneer de laadpaal verbonden is; het verzoek wordt afgewezen voor offline laadpalen.

Diagnostics ophalen gebruiken in Monta Control

1. Ga in Monta Control naar Laadpalen in de zijbalk.
2. Zoek de laadpaal op naam of ID en klik erop om de detailweergave te openen.
3. Open het menu Acties en selecteer Diagnostics ophalen.
4. Vul in het dialoogvenster het volgende in:
   • Diagnosticstype bepaalt wat er wordt opgehaald:
     • Standaard: het standaard diagnosticslogboek (OCPP 1.6 GetDiagnostics). Begin hier, tenzij je een specifieke reden hebt om dat niet te doen.
     • Diagnostics: uitgebreid diagnosticslogboek (gebruikt GetLog; vereist ondersteuning voor de beveiligingsextensie of OCPP 2.0.1 op de laadpaal).
     • Beveiligingslogboek: het beveiligingsgebeurtenislogboek van het station (gebruikt ook GetLog).
   • Uploadlocatie (vereist): de volledige URL waarnaar het station het bestand moet uploaden (bijvoorbeeld ftps://user:password@logs.example.com/diagnostics/ of https://logs.example.com/upload). Monta controleert of dit een geldige URL is. Zie Tips voor de uploadlocatie-URL hieronder.
   • Startdatum/-tijd (optioneel): de oudste logboeken die moeten worden opgenomen. Laat leeg om alle beschikbare logboeken op te nemen.
   • Einddatum/-tijd (optioneel): de meest recente logboeken die moeten worden opgenomen. Laat leeg om logboeken tot nu toe op te nemen.
5. Klik op Verzenden.

Wat gebeurt er nu

• De laadpaal bevestigt het verzoek. Als deze het accepteert, toont Monta een bevestiging, inclusief de bestandsnaam die de laadpaal zal uploaden (bijvoorbeeld diag-20260311T100000.zip).
• De laadpaal verzamelt en verpakt de logbestanden en uploadt het bestand vervolgens naar je uploadlocatie.
• Terwijl dit bezig is, rapporteert de laadpaal de voortgang via DiagnosticsStatusNotification-berichten: Idle → Uploading → Uploaded (of UploadFailed). Je kunt deze volgen in het tabblad OCPP Logs in Monta Control.
• Zodra het uploaden is geslaagd, haal je het bestand op en open je het vanaf je eigen server, omdat het terechtkomt op de bestemming die je hebt opgegeven en niet in Monta. Zie Het bestand ophalen met een FTP-client hieronder.

Een externe server gebruiken

Als je geen eigen server wilt beheren, kunnen verschillende gehoste bestandsoverdrachtsservices als uploadbestemming fungeren. Deze zijn snel in te stellen, en een server die al op het openbare internet staat, omzeilt de thuis- of kantoornetwerkproblemen die in de volgende sectie worden beschreven. Je neemt echter zelf de verantwoordelijkheid voor beveiliging en gegevensverwerking voor alles waar je een laadpaal op richt.

Gratis / tijdelijk (geschikt voor een eenmalige test)

• SFTPCloud gratis FTP-server (sftpcloud.io/tools/free-ftp-server) start een tijdelijke FTPS/SFTP-server op voor een korte periode (ongeveer 60 minuten). Handig voor een snelle test via het FTPS-eindpunt. Behandel alles wat je uploadt naar een gratis, niet-geverifieerde tijdelijke server als potentieel openbaar, en gebruik het alleen voor een wegwerptest — nooit voor echte diagnostische gegevens.

Beheerd / betaald (voor doorlopend gebruik)

Voorbeelden van beheerde bestandsoverdrachtsservices die FTPS- en/of HTTPS-eindpunten aanbieden, zijn onder andere SFTPCloud (betaalde abonnementen, dezelfde aanbieder als de gratis tool hierboven), SFTP To Go, Files.com, DriveHQ, Couchdrop, en de eigen beheerde oplossingen van cloudproviders (bijvoorbeeld AWS Transfer Family en de FTPS-ondersteuning van Azure Blob Storage).

Je eigen server instellen

De bestemming zelf beheren is de veiligste optie, omdat je precies bepaalt wie er toegang toe heeft en wat er met de gegevens gebeurt. Op Linux is vsftpd hiervoor goed geschikt; op Windows is FileZilla Server een veelgebruikte keuze. In plaats van een stapsgewijze handleiding (die per distributie en versie verschilt), volgen hier de principes om te volgen. Raadpleeg de officiële vsftpd-documentatie of de documentatie van je gekozen server voor de exacte configuratie.

Beveiligingsprincipes

• Gebruik een speciaal account met een sterk, uniek wachtwoord, vergrendeld (chrooted/jailed) op één uploadmap en niets anders. Gebruik nooit een echte beheerderslogin.
• Geef de voorkeur aan FTPS (FTP over TLS) of HTTPS, zodat inloggegevens en gegevens versleuteld worden verzonden. Vermijd gewone FTP/HTTP, tenzij de server alleen bereikbaar is via een privénetwerk.
• Beperk inkomende toegang met een firewall, bij voorkeur door alleen de IP-bereiken toe te staan die je laadpalen gebruiken.
• Houd er rekening mee dat het bestand gevoelige operationele gegevens kan bevatten: sla het veilig op en verwijder het zodra je onderzoek is afgerond.

De server bereiken vanuit de laadpaal

• Doorgaans heb je port forwarding nodig. Laadpalen bevinden zich meestal op een mobiel/4G-netwerk of een afzonderlijk netwerk en bereiken je server via het openbare internet. Daarom moet je router/firewall de relevante poorten doorsturen naar de machine waarop de server draait: voor FTP/FTPS zowel de besturingspoort als het poortbereik voor passieve gegevensoverdracht; voor HTTP/HTTPS de webpoort.
• FTP achter NAT is lastig. De passieve gegevenspoorten van FTP passeren thuis- of kantoor-NAT-routers vaak niet probleemloos, wat een veelvoorkomende reden is waarom uploads stilzwijgend mislukken. Als je er niet in slaagt een zelf-gehoste FTP-server werkend te krijgen, is een gehoste dienst (zie vorige sectie) vaak de weg van de minste weerstand.
• De beste optie van allemaal: houd de server buiten het openbare internet. Als je server zich in hetzelfde VPN of privénetwerk bevindt als je laadpalen, kan de laadpaal hem bereiken zonder enige publieke blootstelling en kun je port forwarding volledig overslaan. Dit is verreweg de veiligste configuratie. Wijs de Upload Location naar het privéadres van de server.

Het bestand ophalen met een FTP-client

Het diagnostische bestand komt op je server terecht, niet in Monta, dus je hebt een manier nodig om verbinding te maken met die server, de map aan te maken waarnaar je de laadpaal verwijst en het bestand te downloaden zodra het binnenkomt. FileZilla is een gratis bestandsoverdracht-client die hiervoor geschikt is. Monta heeft geen banden met FileZilla en onderschrijft het niet, maar we hebben gemerkt dat het goed werkt voor dit doel; andere tools zijn beschikbaar. Dit is het belangrijkst bij de gratis tijdelijke server hierboven, waarbij je slechts een kort tijdvenster hebt om het bestand op te halen.

1. Installeer FileZilla. Download de gratis FileZilla Client van filezilla-project.org en installeer deze.
2. Open de Site Manager (File > Site Manager > New site) en voer je servergegevens in:
   • Protocol: kies FTP - File Transfer Protocol en stel vervolgens Encryption in op Require explicit FTP over TLS voor FTPS. (Je kunt in plaats daarvan SFTP kiezen, maar uitsluitend voor het ophalen van bestanden. Houd er rekening mee dat Monta zelf niet kan uploaden via SFTP, dus dit is alleen voor het downloaden.)
   • Host: het adres van je server (voor de gratis SFTPCloud-server is dit de host die op de pagina wordt weergegeven, bijvoorbeeld eu-central-1.sftpcloud.io).
   • Port: zoals opgegeven (FTP/FTPS gebruikt doorgaans 21).
   • Logon Type: Normal, voer vervolgens de User en het Password in.
3. Verbinden. Klik op Connect en accepteer het TLS-certificaat van de server als daarom wordt gevraagd. In het rechterdeelvenster (extern) worden nu de bestanden van de server weergegeven.
4. Maak de uploadmap aan (aanbevolen). Klik in het rechterdeelvenster met de rechtermuisknop en kies Create directory, geef de map vervolgens dezelfde naam als je uploadlocatie, bijvoorbeeld diagnostics. Door de map vooraf aan te maken, voorkom je fouten op laadpalen die een ontbrekende map niet automatisch aanmaken. De URL van je uploadlocatie eindigt dan met die map, bijvoorbeeld ftps://user:password@host/diagnostics/.
5. Haal het bestand op. Nadat je Get Diagnostics hebt uitgevoerd en de laadpaal de status Uploaded meldt, klik je op de vernieuwknop in je FTP-client. Het geüploade bestand verschijnt in de map. Sleep het naar een lokale map om het te downloaden.

Tips voor de URL van de uploadlocatie

De uploadlocatie is het onderdeel waar mensen het vaakst fouten maken. Een paar dingen om te weten:

• Gebruik een volledige, geldige URL. Monta controleert of de waarde een goed gevormde URL is. Voeg het schema toe (ftp://, ftps://, http://, https://), de host en het pad waar het bestand naartoe geschreven moet worden.
• Alleen ondersteunde schema's: ftp, ftps, http, https. Al het andere (met name sftp of scp) wordt door Monta afgewezen, ook als de firmware van je laadpaal technisch gezien bestanden via dat protocol kan uploaden.
• FTP versus FTPS: ftp:// is niet versleuteld, waardoor inloggegevens en gegevens als leesbare tekst worden verzonden. ftps:// omhult hetzelfde protocol met TLS, zodat het versleuteld is. Gebruik bij voorkeur FTPS wanneer de laadpaal en de server dit ondersteunen.
• Inloggegevens in de URL opnemen: voor FTP/FTPS kun je de gebruikersnaam en het wachtwoord rechtstreeks in de URL plaatsen: ftps://username:password@host/path/. Houd er rekening mee dat deze inloggegevens als leesbare tekst in logbestanden kunnen verschijnen (zowel aan de kant van Monta als op de laadpaal). Gebruik daarom een speciaal account met beperkte rechten in plaats van een echte beheerderslogin, en vernieuw de inloggegevens indien nodig.
• Voeg waar van toepassing een afsluitend pad/map toe (bijvoorbeeld .../diagnostics/), zodat de laadpaal weet waar het bestand naartoe geschreven moet worden en het geüploade bestand gemakkelijk terug te vinden is. Maak die map eerst aan op je server (zie Het bestand ophalen met een FTP-client hierboven); sommige laadpalen maken een ontbrekende map niet automatisch aan.
• Ondersteuning van tijdsbereik varieert. Het leeg laten van Startdatum/-tijd en Stopdatum/-tijd is de eenvoudigste en meest compatibele keuze. Niet alle laadpalen respecteren het tijdfilter, en sommige kunnen geen lange bereiken uploaden omdat het bestand te groot wordt. Als een verzoek met een breed bereik mislukt, probeer dan een smaller bereik.
• Sommige laadpalen vereisen HTTP/HTTPS, niet FTP. Geaccepteerde uploadprotocollen zijn hardwarespecifiek: sommige modellen accepteren alleen HTTP/HTTPS, andere FTP/FTPS. Als één protocol wordt geweigerd of mislukt, probeer dan een ander protocol dat de fabrikant als ondersteund documenteert.
• HTTP-servers kunnen een PUT of een POST ontvangen. Als je een HTTP/HTTPS-eindpunt bouwt, houd er dan rekening mee dat verschillende modellen op verschillende manieren uploaden (sommige gebruiken PUT, sommige POST, soms als een octet-stream), waardoor je server mogelijk beide moet accepteren.
• Versleutelde of gearchiveerde bestanden: sommige fabrikanten comprimeren de logbestanden in een leveranciersspecifiek archief (bijvoorbeeld een .tar.gz met meerdere bestanden) en sommige versleutelen de inhoud. Als het bestand onleesbaar is, heb je mogelijk een tool of sleutel van de fabrikant nodig om het te openen. Dit valt buiten de controle van Monta.

Belangrijke informatie

• Niet alle merken en modellen ondersteunen Get Diagnostics. Ondersteuning voor GetDiagnostics/GetLog, het tijdsbereikfilter, het logformaat en welke uploadprotocollen worden geaccepteerd, verschilt per fabrikant en zelfs per firmwareversie. Sommige modellen ondersteunen de functie helemaal niet. De OCPP-standaard definieert niet strikt hoe het uploaden van diagnostische gegevens moet werken, wat de reden is waarom het gedrag zo sterk verschilt tussen leveranciers. Als de laadpaal het commando afwijst of de upload nooit wordt voltooid, ondersteunt het model dit mogelijk gewoon niet.
• De logs zijn afkomstig van de laadpaal, niet van Monta. De inhoud, het formaat, de maximale bestandsgrootte en hoe ver ze teruggaan, worden allemaal bepaald door de firmware van de fabrikant. Grote tijdsbereiken kunnen grote bestanden en trage uploads opleveren.
• Monta biedt geen ondersteuning voor het loggedrag van specifieke merken/modellen. Wij bieden het mechanisme om het commando te verzenden en het veld om je bestemming in te voeren. We kunnen fabrikantspecifieke logformaten niet interpreteren, je niet vertellen waarom een bepaald model het verzoek heeft afgewezen, of door leveranciers versleutelde bestanden ontsleutelen.
• Neem voor hardwarespecifieke vragen contact op met de fabrikant. Als een laadpaal Get Diagnostics afwijst, een onleesbaar bestand uploadt of inconsistent gedrag vertoont, is het ondersteuningsteam van de fabrikant de juiste plek om te achterhalen wat dat model ondersteunt en hoe je de logs kunt lezen.

Probleemoplossing