Equinox p2 download stats
p2 includes a rudimentary mechanism for obtaining download statistics to track transfers from an artifact repository. This page describes how to enable statistics gathering for artifacts in your p2 repositories.
The p2 download statistics mechanism has the following characteristics:
- Statistics collection is "best effort": transfers do not fail if stats could not be collected
- Each artifact repository controls how and where statistics are collected for transfers from
that repository. If artifact repository A is gathering statistics, and an artifact is transferred from repository A to B, and then from repository B to C, repository A will only obtain statistics for the transfer from A to B.
- No personal information is collected. Essentially the statistics just summarize the transfers that have occurred from that repository.
- The repository maintainer can control the granularity of statistics gathered. For example they can record every single artifact transfer, or only transfers of particular artifacts. In general it is best to minimize the set of artifacts that are tracked, since each artifact transfer that is recorded incurs an extra round trip from the client to the repository.
Enabling stats in your repository
There are two steps to enable p2 download statistics gathering for your repository:
1) In the artifact repository that you want to track downloads from, add a p2.statsURI property specifying the statistics URL (in artifacts.jar):
<repository name='Update Site' type='org.eclipse.equinox.p2.artifact.repository.simpleRepository' version='1'> <properties size='3'> <property name='p2.timestamp' value='1269575706171'/> <property name='p2.compressed' value='true'/> <property name='p2.statsURI' value='http://your.stats.server/stats'/>
2) In the same repository, add a download.stats property for each IU that you want to gather stats for. You can pick one plugin in your feature for example:
<artifact classifier='osgi.bundle' id='test.plugin1' version='220.127.116.11003261255'> <properties size='3'> <property name='artifact.size' value='0'/> <property name='download.size' value='1757'/> <property name='download.stats' value='test.plugin1.bundle'/> </properties> </artifact>
In this example, after a successful download a HEAD request will be issued to:
(value of the downloads.stats property appended to the value of the p2.statsURI).
You can either install software on the server at that location to count the requests, or simply gather the statistics from your web server log files.