ezAgimus est l'intégration dans un tableau de bord Agimus des données produites par une instance locale d'ezPAARSE (http://ezpaarse.couperin.org) qui filtre et enrichit sur les traces de passage vers la documentation électronique payante. Les fichiers de traces analysés proviennent d'un reverse-proxy comme EZproxy (https://www.oclc.org/ezproxy.en.html), Biblio-PAM (http://www.alixen.fr/partage_documentaire_securise.html) ou autre (squid, apache, etc.).

Vous pouvez utiliser 2 traitements différents suivant la récupération ou non du login dans les logs ezproxy. Nous vous conseillons la première méthode qui permet de conserver les possibilités de retraitement ultérieurs fournis par ezPaarse.

Récupération du login

Le traitement présenté ici peut être adapté avec le cookie en ajoutant simplement un lien symbolique vers le fichier permettant la correspondance trace <-> uid et en modifiant l'analyse grok de ce traitement.

Cette version est conseillée car elle permet un traitement indépendant des traitements ezPaarse. En effet, lorsque de nouveaux parseurs sont créés dans ezPaarse, il est nécessaire de retraiter les anciens logs.

Le SI de l'établissement évoluant en permanence, il faut faire les enrichissements agimus-ng sur les logs bruts ezproxy afin que le fichier résultat soit enregistré pour pouvoir servir de base aux retraitements ultérieurs.

Ce traitement diverge donc des autres dans le sens où l'enrichissement et l'enregistrement sont décorrélés.

L'enrichissement se fait grâce au traitemement ezproxy. La génération du fichier quotidien et son envoi vers le serveur ezpaarse se fait avec le script traitement-ezproxy.sh. Ces fichiers sont enrichis puis anonymisés et doivent être stocké sur le serveur ezPaarse.

L'envoi des résultats elasticsearch est quant à lui réalisé avec la configuration ezpaarse. Lorsqu'il y a un retraitement ezPaarse quelle que soit la date des fichiers traités, ceux-ci sont renvoyés vers le serveur agimus. Pour détecter et retraiter ces nouveaux fichiers, il faut utiliser le script traitement-ezpaarse.sh. Ce script est indépendant du script quotidien et peut être lancé aussi souvent que souhaité.

Récupération du cookie de trace uniquement

Voici l'ensemble des outils/paramétrages pour la mise en place d'ezAgimus (basé sur l'intégration de l’université de Lille, Sciences et technologies).

EZproxy

Dans la configuration d'EZproxy, il faut mettre en place de l'authentification Shibboleth et la configuration des logs :

...

Vous trouverez le fichier de conf logstash pour ezPAARSE sur le github : https://githubraw.githubusercontent.com/EsupPortail/agimus-ng/blob/masterv2.0/logstash/logstash-ezPAARSEezpaarse.conf
ainsi que les deux dashboards générés https://github.com/EsupPortail/agimus-ng/tree/masterv2.0/kibana/visualization.

Vous trouverez des exemples de rendu des dashboards sur la page :  5 - Les tableaux de bord disponibles