Comment récupérer les journaux de la borne de recharge avec Get Diagnostics ?

Qu'est-ce que Get Diagnostics ?

Get Diagnostics est une commande OCPP qui demande à une borne de recharge d'empaqueter ses fichiers journaux internes et de les téléverser vers une destination de votre choix. Ces journaux sont générés par le micrologiciel de la borne de recharge elle-même, et contiennent souvent bien plus de détails que les messages OCPP déjà visibles dans Monta, ce qui les rend précieux lors de l'investigation d'une panne matérielle, d'une session échouée, ou pour constituer un dossier dans le cadre d'une réclamation sous garantie ou d'une demande d'assistance auprès du constructeur.

Monta Control vous permet d'envoyer cette commande à distance, sans avoir à vous déplacer sur site. Selon la version OCPP et les capacités de la borne de recharge, Monta envoie l'une des commandes suivantes :

• OCPP 1.6 : GetDiagnostics (journaux standard) ou GetLog (diagnostics étendus et journaux de sécurité, via les extensions de sécurité OCA)
• OCPP 2.0.1: GetLog

Avant de commencer

1. Vérifiez que votre borne de recharge prend en charge Get Diagnostics. La prise en charge est spécifique à l'équipement : elle varie selon la marque, le modèle et la version du micrologiciel, et certains modèles ne la prennent pas en charge du tout. De nombreuses bornes de recharge indiquent les protocoles de transfert qu'elles acceptent via la clé de configuration OCPP SupportedFileTransferProtocols ; si votre modèle la renseigne, utilisez l'un des protocoles listés. En cas de doute, contactez le constructeur.
2. Préparez une destination d'envoi : une URL accessible et accessible en écriture par la borne de recharge. Consultez Utilisation d'un serveur tiers ou Configuration de votre propre serveur ci-dessous.
3. Assurez-vous que la borne de recharge est en ligne. La fonction Get Diagnostics ne fonctionne que lorsque la borne est connectée ; la demande est rejetée pour les bornes hors ligne.

Comment utiliser Get Diagnostics dans Monta Control

1. Dans Monta Control, accédez à Bornes de recharge dans la barre latérale.
2. Recherchez la borne par son nom ou son identifiant, puis cliquez dessus pour ouvrir sa vue détaillée.
3. Ouvrez le menu Actions et sélectionnez Obtenir les diagnostics.
4. Dans la boîte de dialogue, renseignez :
   • Type de diagnostics définit ce qui doit être récupéré :
     • Standard : le journal de diagnostics standard (OCPP 1.6 GetDiagnostics). Commencez par là, sauf si vous avez une raison particulière de ne pas le faire.
     • Diagnostics : journal de diagnostics étendu (utilise GetLog ; nécessite l'extension de sécurité ou la prise en charge d'OCPP 2.0.1 sur la borne).
     • Journal de sécurité : le journal des événements de sécurité de la borne (utilise également GetLog).
   • URL de téléversement (obligatoire) : l'URL complète vers laquelle la borne doit téléverser le fichier (par exemple ftps://user:password@logs.example.com/diagnostics/ ou https://logs.example.com/upload). Monta vérifie que l'URL est bien formée. Voir Conseils pour l'URL de téléversement ci-dessous.
   • Date/heure de début (facultatif) : les journaux les plus anciens à inclure. Laissez vide pour inclure tous les journaux disponibles.
   • Date/heure de fin (facultatif) : les journaux les plus récents à inclure. Laissez vide pour inclure les journaux jusqu'à maintenant.
5. Cliquez sur Envoyer.

Et ensuite ?

• La borne de recharge accuse réception de la demande. Si elle l'accepte, Monta affiche une confirmation, incluant généralement le nom de fichier que la station va téléverser (par exemple diag-20260311T100000.zip).
• La borne de recharge collecte et compresse ses journaux, puis téléverse le fichier vers votre emplacement de téléversement.
• Pendant l'opération, la station signale sa progression via des messages DiagnosticsStatusNotification : Idle → Uploading → Uploaded (ou UploadFailed). Vous pouvez les surveiller dans l'onglet OCPP Logs de Monta Control.
• Une fois le téléversement réussi, récupérez et ouvrez le fichier depuis votre propre serveur, car il est déposé à la destination que vous avez indiquée, et non dans Monta. Consultez Récupération du fichier avec un client FTP ci-dessous.

Utilisation d'un serveur tiers

Si vous ne souhaitez pas gérer votre propre serveur, plusieurs services hébergés de transfert de fichiers peuvent servir de destination de téléversement. Ils sont rapides à configurer, et un serveur déjà accessible sur l'internet public contourne les problèmes de réseau domestique ou professionnel décrits dans la section suivante. En revanche, vous assumez la responsabilité en matière de sécurité et de gestion des données pour tout service vers lequel vous pointez une borne de recharge.

Gratuit / temporaire (idéal pour un test ponctuel)

• SFTPCloud free FTP server (sftpcloud.io/tools/free-ftp-server) crée un serveur FTPS/SFTP temporaire pour une courte durée (environ 60 minutes). Utile pour un test rapide via son point de terminaison FTPS. Considérez tout ce que vous téléversez sur un serveur temporaire gratuit et non authentifié comme potentiellement public, et utilisez-le uniquement pour un test jetable, jamais pour de vraies données de diagnostic.

Géré / payant (pour une utilisation continue)

Parmi les exemples de services de transfert de fichiers gérés proposant des points de terminaison FTPS et/ou HTTPS, on trouve SFTPCloud (forfaits payants, le même fournisseur que l'outil gratuit mentionné ci-dessus), SFTP To Go, Files.com, DriveHQ, Couchdrop, ainsi que les offres gérées des fournisseurs cloud (par exemple AWS Transfer Family et la prise en charge FTPS de Azure Blob Storage).

Configuration de votre propre serveur

Gérer vous-même le serveur de destination est l'option la plus sécurisée, car vous contrôlez exactement qui peut y accéder et ce qui advient des données. Sous Linux, vsftpd est particulièrement adapté à cet usage ; sous Windows, FileZilla Server est un choix courant. Plutôt qu'un guide étape par étape (qui varie selon la distribution et la version), voici les principes à suivre. Consultez la documentation officielle de vsftpd ou la documentation du serveur de votre choix pour la configuration exacte.

Principes de sécurité

• Utilisez un compte dédié avec un mot de passe fort et unique, verrouillé (chroot/jail) sur un seul répertoire de téléversement et rien d'autre. N'utilisez jamais un identifiant administrateur réel.
• Privilégiez FTPS (FTP over TLS) ou HTTPS afin que les identifiants et les données soient chiffrés lors du transit. Évitez le FTP/HTTP non sécurisé, sauf si le serveur n'est accessible que via un réseau privé.
• Limitez les accès entrants avec un pare-feu, en n'autorisant idéalement que les plages d'adresses IP utilisées par vos bornes de recharge.
• N'oubliez pas que le fichier peut contenir des données opérationnelles sensibles : stockez-le de manière sécurisée et supprimez-le une fois votre investigation terminée.

Accès au serveur depuis la borne de recharge

• Vous aurez généralement besoin d'une redirection de port. Les bornes de recharge se trouvent généralement sur un réseau mobile/4G ou un réseau distinct et accèdent à votre serveur via l'internet public. Votre routeur/pare-feu doit donc rediriger les ports concernés vers la machine exécutant le serveur : pour FTP/FTPS, à la fois le port de contrôle et la plage de ports de données en mode passif ; pour HTTP/HTTPS, le port web.
• FTP derrière un NAT est délicat. Les ports de données passifs de FTP ne transitent souvent pas correctement à travers les routeurs NAT domestiques ou de bureau, ce qui est une cause fréquente d'échecs silencieux lors des transferts. Si vous ne parvenez pas à faire fonctionner un serveur FTP auto-hébergé, un service hébergé (section précédente) est souvent la solution de moindre résistance.
• La meilleure option de toutes : garder le serveur hors d'Internet public. Si votre serveur se trouve dans le même VPN ou réseau privé que vos bornes de recharge, la borne peut l'atteindre sans aucune exposition publique, et vous pouvez ignorer entièrement la redirection de port. C'est de loin la configuration la plus sûre. Pointez le Upload Location vers l'adresse privée du serveur.

Récupération du fichier avec un client FTP

Le fichier de diagnostic arrive sur votre serveur, et non dans Monta, vous avez donc besoin d'un moyen de vous connecter à ce serveur, de créer le dossier vers lequel vous pointez la borne et de télécharger le fichier une fois qu'il est arrivé. FileZilla est un client de transfert de fichiers gratuit qui convient à cet usage. Monta n'a aucune affiliation avec FileZilla et ne le recommande pas officiellement, mais nous avons constaté qu'il fonctionne bien à cette fin ; d'autres outils sont disponibles. Cela est particulièrement important avec le serveur temporaire gratuit mentionné ci-dessus, où vous ne disposez que d'une courte fenêtre pour récupérer le fichier.

1. Installez FileZilla. Téléchargez le client FileZilla gratuit depuis filezilla-project.org et installez-le.
2. Ouvrez le Site Manager (File > Site Manager > New site) et saisissez les informations de votre serveur :
   • Protocole : choisissez FTP - File Transfer Protocol, puis définissez Chiffrement sur Require explicit FTP over TLS pour FTPS. (Vous pouvez également choisir SFTP pour la récupération uniquement. Notez que Monta ne peut pas envoyer de fichiers via SFTP, cette option est donc réservée au téléchargement.)
   • Hôte : l'adresse de votre serveur (pour le serveur SFTPCloud gratuit, l'hôte affiché sur sa page, par exemple eu-central-1.sftpcloud.io).
   • Port : tel qu'indiqué (FTP/FTPS utilise généralement le port 21).
   • Type de connexion : Normal, puis saisissez le nom d'utilisateur et le mot de passe.
3. Connexion. Cliquez sur Connexion et acceptez le certificat TLS du serveur si vous y êtes invité. Le volet de droite (distant) affiche désormais les fichiers du serveur.
4. Créez le dossier d'envoi (recommandé). Dans le volet de droite, faites un clic droit et choisissez Créer un répertoire, puis nommez-le de façon à correspondre à votre emplacement d'envoi, par exemple diagnostics. La création préalable du dossier évite les échecs sur les bornes qui ne créent pas automatiquement un répertoire manquant. L'URL de votre emplacement d'envoi se termine alors par ce dossier, par exemple ftps://user:password@host/diagnostics/.
5. Récupérez le fichier. Après avoir exécuté Get Diagnostics et une fois que la borne indique Uploaded, cliquez sur le bouton d'actualisation de votre client FTP. Le fichier envoyé apparaît dans le dossier. Faites-le glisser vers un dossier local pour le télécharger.

Conseils pour l'URL de l'emplacement d'envoi

L'emplacement d'envoi est la partie que les utilisateurs renseignent le plus souvent incorrectement. Voici quelques points à connaître :

• Utilisez une URL complète et valide. Monta vérifie que la valeur est une URL bien formée. Incluez le schéma (ftp://, ftps://, http://, https://), l'hôte et le chemin où le fichier doit être écrit.
• Schémas pris en charge uniquement : ftp, ftps, http, https. Tout autre schéma (notamment sftp ou scp) est rejeté par Monta, même si le micrologiciel de votre borne de recharge peut techniquement envoyer des fichiers via ce protocole.
• FTP vs FTPS : ftp:// n'est pas chiffré, les identifiants et les données transitent donc en clair. ftps:// encapsule le même protocole dans TLS, ce qui le rend chiffré. Préférez FTPS dès que la borne de recharge et le serveur le prennent en charge.
• Intégration des identifiants dans l'URL : pour FTP/FTPS, vous pouvez insérer le nom d'utilisateur et le mot de passe directement dans l'URL : ftps://username:password@host/path/. Notez que ces identifiants peuvent apparaître en clair dans les journaux (aussi bien du côté de Monta que de la borne de recharge) ; utilisez donc un compte dédié avec des privilèges limités, et non un vrai compte administrateur, et renouvelez-le si nécessaire.
• Incluez un chemin/répertoire de destination le cas échéant (par exemple .../diagnostics/), afin que la borne sache où écrire le fichier et que celui-ci soit facile à retrouver. Créez ce dossier sur votre serveur au préalable (voir Récupération du fichier avec un client FTP ci-dessus) ; certaines bornes ne créent pas un répertoire manquant.
• La prise en charge des plages horaires varie. Laisser Date/heure de début et Date/heure de fin vides est le choix le plus simple et le plus compatible. Toutes les bornes de recharge ne respectent pas le filtre horaire, et certaines ne peuvent pas télécharger de longues plages car le fichier devient trop volumineux. Si une requête avec une plage étendue échoue, essayez une plage plus étroite.
• Certaines bornes requièrent HTTP/HTTPS, et non FTP. Les protocoles de téléchargement acceptés sont spécifiques au matériel : certains modèles n'acceptent que HTTP/HTTPS, d'autres FTP/FTPS. Si un protocole est rejeté ou échoue, essayez-en un autre documenté comme pris en charge par le constructeur.
• Les serveurs HTTP peuvent recevoir un PUT ou un POST. Si vous créez un point de terminaison HTTP/HTTPS, sachez que différents modèles téléchargent différemment (certains utilisent PUT, d'autres POST, parfois sous forme d'octet-stream), votre serveur devra donc peut-être accepter les deux.
• Charges utiles chiffrées ou archivées : certains constructeurs compressent les journaux dans une archive propriétaire (par exemple un .tar.gz contenant plusieurs fichiers) et certains chiffrent le contenu. Si le fichier est illisible, vous aurez peut-être besoin d'un outil ou d'une clé fournis par le constructeur pour l'ouvrir. Cela échappe au contrôle de Monta.

Points importants à connaître

• Les marques et modèles ne prennent pas tous en charge la fonction Get Diagnostics. La prise en charge de GetDiagnostics/GetLog, du filtre par plage horaire, du format des journaux et des protocoles de téléchargement acceptés varie selon le constructeur et même selon la version du micrologiciel. Certains modèles ne prennent pas du tout en charge cette fonctionnalité. La norme OCPP ne définit pas strictement le fonctionnement des téléchargements de diagnostics, ce qui explique pourquoi le comportement diffère autant d'un fabricant à l'autre. Si la borne rejette la commande ou si le téléchargement ne se termine jamais, il est possible que le modèle ne prenne tout simplement pas en charge cette fonctionnalité.
• Les journaux proviennent de la borne de recharge, et non de Monta. Leur contenu, leur format, les limites de taille et la période couverte sont tous déterminés par le micrologiciel du constructeur. Des plages horaires importantes peuvent générer des fichiers volumineux et ralentir les téléchargements.
• Monta ne fournit pas d'assistance concernant le comportement des journaux propre à chaque marque ou modèle. Nous fournissons le mécanisme permettant d'envoyer la commande et le champ pour saisir votre destination. Nous ne sommes pas en mesure d'interpréter les formats de journaux spécifiques aux constructeurs, d'expliquer pourquoi un modèle particulier a rejeté la demande, ni de déchiffrer les fichiers chiffrés par les fabricants.
• Pour toute question spécifique à l'équipement, contactez le constructeur. Si une borne de recharge rejette la fonction Get Diagnostics, télécharge un fichier illisible ou se comporte de manière incohérente, l'équipe d'assistance du constructeur est la bonne interlocutrice pour savoir ce que ce modèle prend en charge et comment lire ses journaux.

Dépannage