Bonjour,

Voici le rappel de la procédure pour voir vos lignes de logs transformées en événements de consultation (ECs), puis en graphiques de données d’usage sur ezMESURE :

1 – Installer ezPAARSE sur une machine

Dans un premier temps, il vous faut une machine de type Linux répondant aux pré-requis d’installation. Vous pouvez y installer une version locale d’ezPAARSE en suivant la procédure fournie.
Il est aussi possible de lancer ezPAARSE en mode docker.

2 – Paramétrer votre format de log pour ezPAARSE

Une fois votre serveur en place, vous disposez d’une URL d’accès à votre instance locale. L’interface web va vous permettre de soumettre votre premier fichier de log et de voir si votre format de log est reconnu par défaut.
Si ce n’est pas le cas, vous avez la possibilité d’utiliser la baguette magique pour voir s’il existe un paramétrage prédéfini compatible avec votre format de log.
Si ce n’est toujours pas concluant, il faudra décrire votre format. C’est assez facile avec l’assistant en ligne.

3 – Traiter vos logs et automatiser le traitement

Une fois le format de vos logs reconnu, vous pouvez glisser/déposer des fichiers de log dans l’interface et lancer un traitement.
Le bouton vous permet de voir comment va s’écrire la ligne de commande pour l’automatisation des traitements.

Vous pouvez utiliser la commande ezp bulk pour déclencher régulièrement vos traitements.
Si vous êtes en mode docker, vous pouvez installer la commande ezp via npm.

4 – Ouvrir un compte sur ezMESURE

Vous avez maintenant des fichiers résultats générés avec ezPAARSE, et vous souhaitez visualiser des graphiques et explorer vos données. C’est le moment de les téléverser dans l’entrepôt national ezMESURE.

Pour ce faire, vous devez avant tout avoir un compte sur ezMESURE. Si ce n’est pas encore le cas, il vous suffit de vous connecter une première fois via la fédération d’identité.

Pour vous identifier sur la plateforme, choisissez l’onglet Mon Compte et identifiez-vous avec la fédération d’identité.
Un compte est créé automatiquement, et vous recevez par mail un lien pour l’activer et créer votre mot de passe.

5 – Demander les droits d’accès sur votre index

Chaque matin, l’équipe est prévenue de la création de nouveaux comptes. Nous vous contacterons pour vous affecter un établissement, et définir les index auxquels vous aurez accès.

Si vous êtes pressé.e, contactez-nous directement après la création de votre compte.

6 – Installer la commande ezMESURE

Votre compte ezMESURE est maintenant créé, et vous avez accès à un ou plusieurs index. Il est maintenant temps de téléverser vos données !

Votre installation locale d’ezPAARSE embarque la commande ezm, qui est justement là pour vous faciliter la tâche. Si vous n’avez pas accès à la ligne de commande, vous pouvez déposer vos fichiers depuis l’interface ezPAARSE (après un traitement) ou depuis votre espace ezMESURE.

Vous pouvez tester la disponibilité de la commande en tapant ezm dans votre terminal.
Il est également possible d’installer la commande via NPM, ce qui peut être utile si votre ezPAARSE est installé via docker.

Pour sécuriser le transfert, vous aurez besoin d’un token d’authentification.

7 – Paramétrer la commande ezm avec votre token

Si vous avez accès à la commande évoquée à l’étape précédente, vous pouvez téléverser les fichiers résultats et automatiser vos traitements.

Pour cela, il faut paramétrer la commande ezm pour qu’elle utilise votre token lors des envois.

Lancez :

ezm config set -g token <votre_token>

8 – Tester la commande ezm

Testez la commande :

ezm indices list

Vous obtenez la liste des index auxquels vous avez accès (même s’ils sont encore vides).

9 – Téléverser vos données

Lancez :

ezm indices insert <votre_index> votre_repertoire_resultat/votre_fichier.csv

Pour l’automatisation, vous pouvez écrire :

ezm indices insert <votre_index> votre_repertoire_resultat/*.csv

Ce qui téléversera tous les fichiers. Si vous lancez la commande plusieurs fois, seuls les nouveaux fichiers seront téléversés.

 

10 – Visualisez vos données d’usage dans votre espace par défaut

Retournez sur ezMESURE, cliquez sur l’onglet Tableau de Bord et sélectionnez votre espace ezPAARSE. Vous pouvez à présent explorer vos données.

 

A tout moment, vous pouvez contacter l’équipe pour demander de l’aide.

 

Dominique et Yannick pour l’ezTeam