Hvordan henter jeg ladestanderlogfiler med Get Diagnostics?

Hvad er Get Diagnostics?

Get Diagnostics er en OCPP-kommando, der instruerer en ladestander om at pakke sine interne logfiler og uploade dem til en destination, du vælger. Disse logfiler er skrevet af ladestanderens egen firmware, så de indeholder ofte langt flere detaljer end de OCPP-beskeder, du allerede kan se i Monta. Det gør dem værdifulde, når du undersøger en hardwarefejl, en mislykket ladesession eller opbygger dokumentation til et garantikrav eller en supportanmodning til producenten.

Monta Control giver dig mulighed for at sende denne kommando eksternt, så du ikke behøver at være på stedet. Afhængigt af ladestanderens OCPP-version og funktioner sender Monta én af følgende:

• OCPP 1.6: GetDiagnostics (standardlogfiler) eller GetLog (udvidede diagnostik- og sikkerhedslogfiler via OCA-sikkerhedsudvidelserne)
• OCPP 2.0.1: GetLog

Inden du starter

1. Kontrollér, at din ladestation understøtter Get Diagnostics. Understøttelse er hardwarespecifik: den varierer efter mærke, model og firmwareversion, og nogle modeller understøtter det slet ikke. Mange ladestationer angiver, hvilke overførselsprotokol de accepterer, via OCPP-konfigurationsnøglen SupportedFileTransferProtocols. Hvis din model rapporterer dette, skal du bruge en af de angivne protokoller. Er du i tvivl, så kontakt producenten.
2. Hav en upload-destination klar: en URL, som ladestationen kan nå og skrive til. Se Brug af en tredjeparts-server eller Opsætning af din egen server nedenfor.
3. Sørg for, at ladestationen er online. Get Diagnostics virker kun, mens stationen er tilsluttet; anmodningen afvises for offline-stationer.

Sådan bruger du Get Diagnostics i Monta Control

1. I Monta Control skal du gå til Ladestationer i sidebjælken.
2. Søg efter stationen ved navn eller identitet, og klik på den for at åbne dens detaljerede visning.
3. Åbn menuen Handlinger og vælg Hent diagnostik.
4. Udfyld følgende i dialogboksen:
   • Diagnostiktype angiver, hvad der skal hentes:
     • Standard: standarddiagnostikloggen (OCPP 1.6 GetDiagnostics). Begynd her, medmindre du har en specifik grund til ikke at gøre det.
     • Diagnostik: udvidet diagnostiklog (bruger GetLog; kræver sikkerhedsudvidelse eller OCPP 2.0.1-understøttelse på ladestanderen).
     • Sikkerhedslog: stationens sikkerhedshændelseslog (bruger også GetLog).
   • Upload-lokation (påkrævet): den fulde URL, som stationen skal uploade filen til (f.eks. ftps://user:password@logs.example.com/diagnostics/ eller https://logs.example.com/upload). Monta validerer, at dette er en korrekt udformet URL. Se Tips til upload-lokationens URL nedenfor.
   • Startdato/-tidspunkt (valgfrit): de ældste logfiler, der skal inkluderes. Lad feltet stå tomt for at inkludere alle tilgængelige logfiler.
   • Slutdato/-tidspunkt (valgfrit): de nyeste logfiler, der skal inkluderes. Lad feltet stå tomt for at inkludere logfiler frem til nu.
5. Klik på Send.

Hvad sker der nu

• Ladestanderen bekræfter anmodningen. Hvis den accepterer, viser Monta en bekræftelse, som normalt inkluderer filnavnet, som stationen vil uploade (f.eks. diag-20260311T100000.zip).
• Ladestanderen indsamler og pakker sine logfiler og uploader derefter filen til din uploadlokation.
• Mens den arbejder, rapporterer stationen fremskridt via DiagnosticsStatusNotification-beskeder: Idle → Uploading → Uploaded (eller UploadFailed). Du kan overvåge disse under fanen OCPP Logs i Monta Control.
• Når uploaden er gennemført, skal du hente og åbne filen fra din egen server, da den lander på den destination, du har angivet, og ikke i Monta. Se Hentning af filen med en FTP-klient nedenfor.

Brug af en tredjeparts-server

Hvis du ikke ønsker at køre din egen server, kan flere hostede filoverførselstjenester fungere som uploadmål. De er hurtige at konfigurere, og en server, der allerede er på det offentlige internet, omgår de hjemme- eller kontornetværksproblemer, der beskrives i næste afsnit. Men du påtager dig selv ansvaret for sikkerhed og datahåndtering for det, du peger en ladestander mod.

Gratis / midlertidig (god til en engangtest)

• SFTPCloud free FTP server (sftpcloud.io/tools/free-ftp-server) opretter en midlertidig FTPS/SFTP-server i en kort periode (ca. 60 minutter). Nyttig til en hurtig test via dens FTPS-endpoint. Behandl alt, hvad du uploader til en gratis, ikke-godkendt midlertidig server, som potentielt offentligt tilgængeligt, og brug den kun til en engangtest – aldrig til rigtige diagnostiske data.

Administreret / betalt (til løbende brug)

Eksempler på administrerede filoverførselstjenester, der tilbyder FTPS- og/eller HTTPS-endpoints, inkluderer SFTPCloud (betalte planer, samme udbyder som det gratis værktøj ovenfor), SFTP To Go, Files.com, DriveHQ, Couchdrop samt cloud-udbydernes egne administrerede løsninger (f.eks. AWS Transfer Family og Azure Blob Storage's FTPS-understøttelse).

Opsætning af din egen server

At køre destinationen selv er den mest sikre mulighed, fordi du har fuld kontrol over, hvem der kan tilgå den, og hvad der sker med dataene. På Linux er vsftpd velegnet til dette; på Windows er FileZilla Server et almindeligt valg. Frem for en trin-for-trin-vejledning (som varierer afhængigt af distribution og version) er her de principper, du bør følge. Se den officielle vsftpd-dokumentation eller dokumentationen for din valgte server for den præcise konfiguration.

Sikkerhedsprincipper

• Brug en dedikeret konto med en stærk, unik adgangskode, låst (chrooted/jailed) til én enkelt uploadmappe og intet andet. Brug aldrig et rigtigt administratorlogin.
• Foretruk FTPS (FTP over TLS) eller HTTPS, så legitimationsoplysninger og data er krypteret under overførslen. Undgå almindelig FTP/HTTP, medmindre serveren kun er tilgængelig via et privat netværk.
• Begræns indgående adgang med en firewall, og tillad ideelt set kun de IP-intervaller, som dine ladestandere bruger.
• Husk, at filen kan indeholde følsomme driftsdata: opbevar den sikkert, og slet den, når du er færdig med din undersøgelse.

Adgang til serveren fra ladestanderen

• Du skal normalt bruge port forwarding. Ladestandere befinder sig typisk på et mobil-/4G-netværk eller et separat netværk og kommunikerer med din server via det offentlige internet, så din router/firewall skal videresende de relevante porte til den maskine, der kører serveren: for FTP/FTPS gælder det både kontrolporten og portintervallet for passiv datatilstand; for HTTP/HTTPS gælder det webporten.
• FTP bag NAT er besværligt. FTPs passive dataporte passerer ofte ikke rent igennem hjemme- eller kontorbaserede NAT-routere, hvilket er en almindelig årsag til, at uploads fejler uden varsel. Hvis du ikke kan få en selvhostet FTP-server til at fungere, er en hostet tjeneste (forrige afsnit) ofte den nemmeste løsning.
• Den bedste løsning af alle: hold serveren væk fra det offentlige internet. Hvis din server befinder sig i det samme VPN eller private netværk som dine ladestandere, kan standeren nå den uden nogen offentlig eksponering, og du kan helt undlade port forwarding. Dette er langt den sikreste opsætning. Peg Upload Location på serverens private adresse.

Hentning af filen med en FTP-klient

Diagnostikfilen lander på din server, ikke i Monta, så du skal have en måde at oprette forbindelse til den server på, oprette den mappe du peger standeren på, og downloade filen, når den ankommer. FileZilla er en gratis filoverførselsklient, der fungerer til dette formål. Monta har ingen tilknytning til FileZilla og anbefaler det ikke, men vi har erfaret, at det fungerer godt til dette formål; andre værktøjer er tilgængelige. Dette er især vigtigt med den gratis midlertidige server ovenfor, hvor du kun har et kort tidsvindue til at hente filen.

1. Installer FileZilla. Download den gratis FileZilla Client fra filezilla-project.org og installer den.
2. Åbn Site Manager (File > Site Manager > New site), og indtast dine serveroplysninger:
   • Protokol: vælg FTP - File Transfer Protocol, og sæt derefter Kryptering til Require explicit FTP over TLS for FTPS. (Du kan i stedet vælge SFTP kun til hentning. Bemærk, at Monta ikke selv kan uploade via SFTP, så dette er kun til download.)
   • Host: din servers adresse (for den gratis SFTPCloud-server er det den host, der vises på dens side, f.eks. eu-central-1.sftpcloud.io).
   • Port: som angivet (FTP/FTPS bruger typisk 21).
   • Logontype: Normal, og indtast derefter Bruger og Adgangskode.
3. Forbind. Klik på Forbind, og accepter serverens TLS-certifikat, hvis du bliver bedt om det. Den højre (fjernbetjente) rude viser nu serverens filer.
4. Opret upload-mappen (anbefalet). I højre rude skal du højreklikke og vælge Opret mappe, og derefter navngive den, så den matcher din upload-lokation, f.eks. diagnostics. Ved at oprette mappen på forhånd undgår du fejl på ladestandere, der ikke selv opretter en manglende mappe. URL'en til din upload-lokation slutter derefter med den pågældende mappe, f.eks. ftps://user:password@host/diagnostics/.
5. Hent filen. Når du har kørt Get Diagnostics, og ladestanderen rapporterer Uploaded, skal du klikke på opdateringsknappen i din FTP-klient. Den uploadede fil vises i mappen. Træk den til en lokal mappe for at downloade den.

Tips til URL'en til upload-lokationen

Upload-lokationen er den del, folk oftest laver fejl med. Her er et par ting, du bør vide:

• Brug en fuldstændig, gyldig URL. Monta kontrollerer, at værdien er en korrekt udformet URL. Inkluder skemaet (ftp://, ftps://, http://, https://), værten og stien, hvor filen skal skrives.
• Kun understøttede skemaer: ftp, ftps, http, https. Alt andet (navnlig sftp eller scp) afvises af Monta, selv hvis din ladestanders firmware teknisk set kan uploade via den pågældende protokol.
• FTP vs. FTPS: ftp:// er ukrypteret, så legitimationsoplysninger og data sendes i klartekst. ftps:// pakker den samme protokol ind i TLS, så den er krypteret. Foretræk FTPS, når ladestanden og serveren understøtter det.
• Indlejring af legitimationsoplysninger i URL'en: til FTP/FTPS kan du angive brugernavn og adgangskode direkte i URL'en: ftps://username:password@host/path/. Vær opmærksom på, at disse legitimationsoplysninger kan fremgå i klartekst i logfiler (både på Montas side og på ladestanden), så brug en dedikeret konto med begrænsede rettigheder – ikke et rigtigt administratorlogin – og udskift den efter behov.
• Inkluder en afsluttende sti/mappe, hvor det er relevant (f.eks. .../diagnostics/), så ladestanden ved, hvor den skal skrive, og så den uploadede fil er nem at finde. Opret mappen på din server først (se Hentning af filen med en FTP-klient ovenfor); nogle ladestander opretter ikke en manglende mappe.
• Understøttelse af tidsinterval varierer. Det er det enkleste og mest kompatible valg at lade Startdato/-tidspunkt og Slutdato/-tidspunkt stå tomme. Ikke alle ladestandere overholder tidsfilteret, og nogle kan ikke uploade lange intervaller, fordi filen bliver for stor. Hvis en anmodning med et bredt interval mislykkes, kan du prøve et smallere.
• Nogle stationer kræver HTTP/HTTPS, ikke FTP. Understøttede uploadprotokoller er hardwarespecifikke: nogle modeller accepterer kun HTTP/HTTPS, andre FTP/FTPS. Hvis én protokol afvises eller fejler, kan du prøve en anden, som producenten dokumenterer som understøttet.
• HTTP-servere kan modtage en PUT- eller en POST-anmodning. Hvis du bygger et HTTP/HTTPS-endpoint, skal du være opmærksom på, at forskellige modeller uploader forskelligt (nogle bruger PUT, andre POST, lejlighedsvis som en octet-stream), så din server skal muligvis acceptere begge.
• Krypterede eller arkiverede filer: nogle producenter komprimerer logfilerne i et leverandørspecifikt arkiv (f.eks. en .tar.gz med flere filer), og nogle krypterer indholdet. Hvis filen ikke kan læses, kan du have brug for et værktøj eller en nøgle fra producenten for at åbne den. Dette er uden for Montas kontrol.

Vigtige ting at vide

• Ikke alle mærker og modeller understøtter Get Diagnostics. Understøttelse af GetDiagnostics/GetLog, tidsintervalfilter, logformat og hvilke uploadprotokoller der accepteres, varierer alt efter producent og endda firmwareversion. Nogle modeller understøtter slet ikke funktionen. OCPP-standarden definerer ikke strengt, hvordan diagnostikupload skal fungere, hvilket er grunden til, at adfærden varierer så meget mellem leverandører. Hvis ladestanderen afviser kommandoen, eller uploaden aldrig fuldføres, understøtter modellen muligvis simpelthen ikke funktionen.
• Loggene kommer fra ladestanderen, ikke fra Monta. Deres indhold, format, størrelsesgrænser og, hvor langt tilbage de går, bestemmes alle af producentens firmware. Store tidsintervaller kan producere store filer og langsomme uploads.
• Monta yder ikke support til specifikke mærke-/modellogfunktioner. Vi stiller mekanismen til rådighed for at sende kommandoen og feltet til at angive din destination. Vi kan ikke fortolke producentspecifikke logformater, fortælle dig, hvorfor en bestemt model afviste anmodningen, eller dekryptere leverandørkrypterede filer.
• Kontakt producenten ved hardwarespecifikke spørgsmål. Hvis en ladestander afviser Get Diagnostics, uploader en ulæselig fil eller opfører sig inkonsekvent, er producentens supportteam det rette sted at finde ud af, hvad den pågældende model understøtter, og hvordan man læser dens logs.

Fejlfinding