Consulter les logs

La page Logs est le journal technique de la plateforme : chaque ligne est un événement enregistré par l'un des services (échange avec une borne, appel de l'interface, traitement automatique, itinérance…). C'est l'écran à utiliser pour retracer ce qui s'est passé sur une borne, une session ou un compte à un moment précis. Vous la trouvez dans le menu, section Analyse, entrée Logs.

Qu'est-ce qu'un log ?

Un log est une trace horodatée écrite par la plateforme au moment où quelque chose se produit. Chaque log porte :

• un niveau de gravité ;
• une date et une heure ;
• le service qui l'a écrit (la Source) ;
• une Action, c'est-à-dire le nom technique de l'opération en cours ;
• un Message qui décrit ce qui s'est passé ;
• quand ils sont connus : la borne, la session, l'entreprise, le site, le badge et les utilisateurs concernés.

Les sources proposées dans le filtre Source sont les suivantes (les libellés sont affichés en anglais dans l'application) :

Que signifient les niveaux ?

La colonne Level et le filtre Levels utilisent quatre niveaux :

Les niveaux réellement enregistrés dépendent du réglage de la plateforme : selon ce réglage, les logs Debug, voire Info., peuvent ne pas être conservés du tout.

Quels filtres sont disponibles ?

Les filtres Entreprises et Zones ne sont affichés que si le composant Organisation est actif.

Le champ Rechercher cherche dans le message, dans l'action et dans l'identifiant de la borne.

Par défaut, la liste est triée du log le plus récent au plus ancien. Vous pouvez trier sur chaque colonne.

Si vous n'êtes pas administrateur, vous ne voyez que les logs rattachés aux entreprises et aux zones auxquelles vous avez accès.

Retrouver les logs d'une borne

Choisissez la borne dans le filtre Bornes, puis réglez la période dans Date. Vous pouvez aussi saisir l'identifiant de la borne dans Rechercher.

Retrouver les logs d'une session

Il n'existe pas de filtre « Session » sur la page Logs. Passez par la page Sessions :

1. Ouvrez Sessions, onglet En cours ou Historique.
2. Sur la ligne de la session, ouvrez le menu Actions supplémentaires.
3. Cliquez sur Voir les logs.

La page Logs s'ouvre, filtrée sur la borne de la session et sur sa période (du début à la fin de la session ; pour une session en cours, du début de la session à la fin de cette journée-là), triée dans l'ordre chronologique. Vous y voyez donc tous les logs de la borne sur cette période, y compris ceux qui ne concernent pas la session. La colonne Session indique le numéro de session quand le log en porte un.

Retrouver les logs d'un utilisateur

Choisissez la personne dans le filtre Utilisateurs. Vous obtenez à la fois ce qu'elle a fait et ce qui a été fait sur son compte.

Retrouver les logs d'une action

Choisissez l'action dans le filtre Actions. Si vous ne connaissez pas son nom technique, ouvrez un log de même nature : son action est affichée dans le détail et peut être copiée.

Que montre le détail d'un log ?

Cliquez sur une ligne : le panneau Détails du Log s'ouvre, avec le niveau en en-tête.

Les boutons Précédent et Suivant passent au log voisin dans la liste déjà chargée, sans fermer le panneau.

Comment suivre la trace d'une erreur sur une borne ?

1. Ouvrez Logs.
2. Dans Bornes, choisissez la borne.
3. Dans Date, réglez la période où le problème s'est produit (par défaut, la journée en cours).
4. Dans Levels, choisissez Erreur (ajoutez Avert. si rien ne ressort).
5. Cliquez sur l'erreur qui vous intéresse et lisez le message, puis le bloc Données.
6. Notez l'heure de l'erreur, puis retirez le filtre Levels et resserrez Date sur quelques minutes avant et après : vous voyez alors tout ce que la borne et la plateforme ont échangé autour de l'erreur.
7. Parcourez la séquence avec Précédent et Suivant. Pour ne garder que les échanges avec la borne, filtrez Source sur OCPP Server (Json) (ou OCPP Server (Soap) selon la borne).
8. Si le log porte une session ou un badge, ouvrez-les depuis Objets concernés pour poursuivre l'analyse.

Combien de temps les logs sont-ils conservés ?

La durée de conservation n'est pas un réglage de cet écran. Si vous devez retrouver des logs anciens, contactez le support Chargekeeper.

À savoir : une recherche sur une très longue période ne couvre pas forcément toute la période. Au-delà d'un certain nombre de jours, de semaines ou de mois (selon la configuration de la plateforme), seuls le début de la période et sa partie la plus récente sont parcourus, et rien ne l'indique à l'écran. Pour une recherche fiable, travaillez sur des périodes courtes.

Peut-on exporter les logs ?

Oui, si votre profil en a le droit : le bouton Exporter est alors affiché au-dessus de la liste.

1. Réglez les filtres et la recherche : l'export reprend exactement ce qui est filtré à l'écran.
2. Cliquez sur Exporter, puis confirmez (« Voulez-vous vraiment exporter les logs correspondant aux filtres ? »).
3. Le fichier exported-logs.csv est téléchargé.

Le fichier est au format CSV (séparateur virgule) et contient une ligne par log avec les colonnes : niveau, date, heure, service, source, action, identifiant de la zone, identifiant de la borne, module, méthode, message. Il ne contient ni les données détaillées, ni l'utilisateur, ni le numéro de session.

L'export est limité à 100 000 lignes.

Données personnelles

Un log peut contenir des données personnelles des utilisateurs concernés (identité de la personne qui a exécuté l'action ou du compte modifié, badge). Certaines informations sensibles, comme les mots de passe, sont masquées dans les données détaillées avant l'enregistrement. Ne partagez un export ou une copie de log qu'avec les personnes qui en ont besoin.

Logs ou alertes : lequel utiliser ?

Utilisez les Alertes pour savoir qu'un problème existe et lequel traiter en priorité. Utilisez les Logs pour comprendre ce qui s'est passé, étape par étape, sur une borne, une session ou un compte — y compris quand aucune alerte n'a été levée.