Versions Compared

Key

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

...

Exchange usage statistics with IRUS

Introduction

IRUS (Institutional Repository Usage Statistics) enables Institutional Repositories to share and expose statistics based on the COUNTER standard.
It offers opportunities for benchmarking and acts as an intermediary between repositories and other agencies.

...

Prerequisite

The DSpace server should be able to access the tracker’s base production and test URL's.
The tracker's base production URL will depend on the area/country where your repository is located:

...

https://irus.jisc.ac.uk/counter/test/

Access to the tracker's base URLs can easily be verified using a wget command with the applicable URL, e.g.:

Code Block
wget https://irus.jisc.ac.uk/counter/test/

The above command should return a HTTP 200.

Configuration

The IRUS statistics tracker can be configured in the irus-statistics.cfg file which can be found [dspace-src]/dspace/config/modules.

PropertyDescriptionDefault

irus.statistics.tracker.enabled

Configuration used to enable the IRUS statistics tracker. Set to true to enable.false
irus.statistics.tracker.type-fieldMetadata field to check if certain items should be excluded from tracking. If empty or commented out, all items are tracked.
irus.statistics.tracker.type-valueThe values in the above metadata field that will be considered to be tracked.
irus.statistics.tracker.entity-types The entity types to be included in the tracking. If left empty, only publication hits will be tracked. Publication
irus.statistics.tracker.environmentThe tracker environment determines to which url the statistics are exported (test or prod).test
irus.statistics.tracker.testurlThe url to which the trackings are exported when testing. (In theory, this should be https://irus.jisc.ac.uk/counter/test/)
irus.statistics.tracker.produrlThe url to which the trackings are exported in production. (this will depend on your area/country, refer to the Prerequisite section)
irus.statistics.tracker.urlversionTracker version
irus.statistics.spider.agentregex.urlExternal URL to the COUNTER user agents file (e.g. https://github.com/atmire/COUNTER-Robots/blob/master/generated/COUNTER_Robots_list.txt)
irus.statistics.spider.agentregex.regexfileLocation where the user agents file should be downloaded to.

...