Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Warning

En cours de rédaction

eZAgimus ezAgimus est une intégration des indicateurs produit par eZPaarse 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. Ces Les fichiers de trace sont issu de l'outil eZProxy 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.).

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

...

EZproxy

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

  • dans le fichier de config, pour les logs, voici les instructions :

Code Block
titleconfigurration configuration pour les logs
Option LogUser
LogFormat %h "%{ezproxy-groups}i" %u %t "%r" %s %b "%{Referer}i" "%{user-agent}i" "%{Cookie}i" %{ezproxy-session}i
LogFile -strftime /var/log/ezproxy/ezp%Y%m%d.log

...

Un fichier quotidien est créé avec l'ensemble d’informationdes informations nécessaires.

Info

Ce fichier est a à envoyer toutes les nuits sur le serveur Agimus selon le même principe que les autres fichiers de logs : [...]/YYYY/MM/DD/ezp.log


Dans le traitement journalier (daily_batch) d'Agimus, il faut ajouté ajouter deux instructions :

  • le traitement du fichier de log par eZPaarseezPAARSE
  • le traitement du résultat par agimusAgimus.


Pour le traitement ezpaarseezPAARSE, il faut faire en curl avec cette instruction :

Code Block
title/opt/agimus-ng/build/scripts/daily_batch.sh
[...]

echo "$LINE_SEPARATOR"
echo "#### EzpaarseezPAARSE - EzProxyEZproxy logs : "`date +'%F %R'`
if [ -f "$LOG_DIR/$DATE/ezp.log" ]; then
    curl -X POST --proxy "" --no-buffer -H 'Log-Format-ezproxy: %h "%{ezproxy-groups}<.*>" %u %t "%r" %s %b "%{Referer}<[^ ]+>" "%{user-agent}<.*>" 
"%{Cookie}<.*>" %{ezproxy-session}<[a-zA-Z0 -9\)-]+>' \
        -H 'Accept: text/csv' \
        -H 'Traces-Level: error' \
        -H 'Output-Fields: +year,+institution,+datetime' \
        -H 'Relative-Domain: docproxy.univ.fr' \
        -H 'Double-Click-Removal: true' \
        --data-binary @$LOG_DIR/$DATE/ezp.log  http://127.0.0.1:59599 -v \
        -o $LOG_DIR/$DATE/ezp.csv
else
        echo "ERR : NO file logs EZP" >&2
fi
echo ""

[...]

...

Code Block
title/opt/agimus-ng/build/scripts/daily_batch.sh
[...]

echo "$LINE_SEPARATOR"
echo "#### Import EzPaarseezPAARSE CSV logs : "`date +'%F %R'`
if [ -f "$LOG_DIR/$DATE/ezp.csv" ]; then
    echo "#### Number of lines in file "`cat $LOG_DIR/$DATE/ezp.csv | wc -l`
    cat $LOG_DIR/$DATE/ezp.csv | $LOGSTASH_DIR/bin/logstash --quiet -f $BUILD_HOME/logstash/logstash-ezpaarseezPAARSE.conf >&2
else
        echo "ERR : NO file logs EZP csv" >&2
fi
echo ""

[...]



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



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