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
Il vous faut une machine de type Linux sur laquelle vous vérifiez les pré-requis d’installation. Vous installez 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.
L’interface web vous permet d’utiliser la baguette magique pour voir si nous connaissons déjà votre type de format.
Si ce n’est pas concluant, il faudra le décrire. C’est assez facile avec l’assistant en ligne.
3 – traiter vos logs et automatiser le traitement
Le format de vos logs est reconnu, vous pouvez glisser/déplacer 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 – tester la disponibilité ou installer la commande ezmesure
Vous avez déjà un ou quelques fichiers résultats, et vous souhaitez visualiser des graphiques et explorer vos données. C’est le moment d’utiliser ezMESURE et d’y verser vos ECs.
Votre installation locale d’ezPaarse embarque la commande ezm dédiée à ezMESURE pour télécharger vos fichiers résultats sur l’instance nationale.
Vous pouvez tester sa disponibilité en lançant la commande ezm. Si vous n’avez pas accès à la ligne de commande, vous pourrez déposer vos fichiers après un traitement ezpaarse ou manuellement après l’étape 5).
Si vous êtes en mode docker, vous pouvez installer la commande ezm via npm.
Pour sécuriser le transfert, vous aurez besoin d’un token d’authentification que vous trouvez sur ezMESURE après vous être connecté.e une première fois.
5 – ouvrir un compte sur ezMESURE
Vous devez avoir un compte sur ezMESURE pour télécharger des résultats de traitement ezPAARSE.
Pour vous identifier sur la plateforme, choisissez l’onglet Tableau de bord et identifiez vous avec la fédération d’identité.
Un compte est créé automatiquement et vous recevez vos identifiants par mail.
6 -demander les droits d’accès sur votre index
Chaque matin, l’équipe est prévenue de la création des nouveaux compte créés la veille.
Nous vous contacterons pour vous affecter vos droits.
Si vous êtes pressé.e, contactez-nous après la création de votre compte. Si vous n’avez pas accès à la ligne de commande, vous pouvez déjà téléverser (par simple glisser-déposer) des fichiers résultats via votre page de profil ezmesure.
7 – paramétrer votre commande ezmesure avec votre token
Si vous avez accès à la ligne de commande évoquée à l’étape 4, vous pouvez télécharger les fichiers résultats en mode commande 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 token <votre token>
8 – tester la commande ezmesure
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écharger 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 traitera tous les fichiers et ne retraitera que les nouveaux fichiers à traiter si vous lancez la commande plusieurs fois.
10 – visualisez vos données d’usage dans votre espace par défaut
Retournez sur ezMESURE choisissez votre espace par défaut, et explorez vos données.
A tout moment, vous pouvez contacter l’équipe pour demander de l’aide.
Dominique pour l’ezTeam