Package: dspace-stats-collector
============================
DSpace Usage Stats Collector.. image::https://img.shields.io/pypi/v/dspace-stats-collector.svg:target:https://pypi.python.org/pypi/dspace-stats-collector.. image::https://img.shields.io/travis/lareferencia/dspace-stats-collector.svg:target:https://travis-ci.org/lareferencia/dspace-stats-collector.. image::https://readthedocs.org/projects/dspace-stats-collector/badge/?version=latest:target:https://dspace-stats-collector.readthedocs.io/en/latest/?badge=latest:alt: Documentation Status.. image::https://img.shields.io/pypi/l/dspace-stats-collector.svg:target:https://pypi.python.org/pypi/dspace-stats-collector:alt: LicenseA python agent for sending DSpace usage statistics events to Matomo/OpenAIRE.Free software: GNU General Public License v3Documentation:http://doc.lareferencia.info/es/public/estadisticas/dspace-stats-collectorImplementation of a lightweight, easy-to-deploy, read-only alternative for a DSpace usage data collector compatible with Matomo and OpenAire usage statistics infrastructure. It sends usage data from individual repositories to an external regional aggregator by issuing read-only queries to the out-of-the-box DSpace Solr statistics subsystem.A regional usage statistics service allows the sharing of data on item access across repositories, e-journals and CRIS systems in order to support evaluation, management and reporting. The success of this kind of service depends on installing a collector component in  every repository, so one of the main requirements was to provide a user-friendly, non-invasive and reliable deploying process for repository managers.This development is part of LA Referencia´s tasks in OpenAIRE Advance project,  aimed to build a pilot on usage data exchange between Latin America and Europe open science infrastructures.The design and the development of this usage data collector agent have been based on the following fundamental principles:open-source, collaborative developmentstraightforward installation procedure for non-expert Linux users without root or superuser privilegescapable of running in a sandbox without the need for installing system-wide packages in the host systemlight-weight and preserving system stability and performancefully compatible with OpenAIRE Usage Statistics Service [1]adaptable to other software platforms and aggregator servicesImplementation highlightsThe solution is based on a “pipe and filter” architecture with input, filter and output stages for events. This approach aims to factorize the problem in independent components, so more stages can be added/connected in the future, allowing to cover other software platforms.In this first version of the agent, the following  stages have been implemented for DSpace versions 4, 5 and 6, sending events to a Matomo instance, which is analysis platform used by the OpenAIRE [1]:DSpace Solr Statistics Input: an initial input component queries the internal DSpace Solr statistics core for new (later than a given/stored timestamp) usage events (item views/ item downloads).  This initial event contains fields for timestamp, item id, user agent, IP address, among othersCOUNTER Robots Filter: this filter excludes events generated by internet robots and crawlers based on a list of user agent values provided by project COUNTER [3]DSpace Database Filter: this stage queries the internal DSpace relational database (currently only Postgres supported) for complementary item information which is not stored in the Solr core but is required by OpenAire specifications. This filter adds item title, bitstream filename and oai_identifier as event fieldsMatomo API Filter: this filter transforms previously gathered data into the set of parameters required by  Matomo Tracking API [4]Matomo Sender Output: this filter buffers and sends batches of events into the regional tracker using the bulk tracking feature of Matomo HTTP Tracking API [4].. image::https://raw.githubusercontent.com/lareferencia/dspace-stats-collector/master/docs/pipeline-diagram.pngThe resulting pipeline runs from the main collector script that stores the last successfully sent timestamp as a state for future calls.CreditsThis component is part of an alternative DSpace Usage Statistics collector strategy developed by LA Referencia / CONCYTEC (Perú) / IBICT (Brasil) / OpenAIRE as part of OpenAIRE Advance project - WP5 - Subtask 5.2.2. "Pilot common methods for usage statistics across Europe & Latin America"References[1] Schirrwagen, Jochen, Pierrakos, Dimitris, MacIntyre, Ross, Needham, Paul, Simeonov, Georgi, Príncipe, Pedro, & Dazy, André. (2017).[2] OpenAIRE2020 - Usage Statistics Services - D8.5. doi:https://doi.org/10.5281/zenodo.1034164[3] Python generatorshttps://wiki.python.org/moin/Generators[4] Project COUNTERhttps://www.projectcounter.org/[5] Matomo tracking API,https://developer.matomo.org/api-reference/tracking-api[6] DSpace Statisticshttps://wiki.lyrasis.org/display/DSDOC3x/DSpace+Statistics