A feature new to dCache 2.2+ is the capability of displaying the billing data as a set of histograms. These are generated automatically from the data in the billing database tables (hence it is necessary to install and configure the database option if such plots are desired).
The plots are linked off of the static web page created by the
httpd
(default port 2288
) under the
Statistics
rubric as
History
("Daily, Weekly, Monthly and Yearly
transfer histograms"). They provide aggregate views of the data
for 24-hour, 7-day, 30-day and 365-day periods. The plot types
are:
(Giga)bytes read and written for both dCache and HSM backend (if any)
Number of transactions/transfers for both dCache and HSM backend (if any)
Maximum, minimum and average connection time
Cache hits and misses
Note
The data for this last histogram is not automatically sent, since it contributes significantly to message traffic between the pool manager and the billing service. To store this data (and thus generate the relevant plots), the
poolmanager.cache-hit-messages.enabled
property must be set either indcache.conf
or in the layout file for the domain where thepoolmanager
runs:poolmanager.cache-hit-messages.enabled=true
As with the database itself, it is expected that the
standard/default set-up for plotting will usually be sufficient.
In the case where alteration of the look and feel of the plotting
is desired, a new plot.properties
file needs
to be provided. The path to this file, which will override the
internal settings, should be indicated using the property
billingPlotPropertiesFile
.
This configuration file contains settings relevant to the JAIDA/Freehep libraries
used to create the graphics. The meaning of most of these
properties is rather straightforward. For possible alternatives,
it is suggested you consult the Freehep
reference pages (note that the
histogram.factory
property must be included in
any custom file but will normally have the same value).
To view the internal plot.properties
settings
extract the
dcache-core-<version>.jar
to some temporary directory.
[root] #
ls /usr/share/dcache/classes/dcache-core*
/usr/share/dcache/classes/dcache-core-<version>[root] #
cd /tmp
[root] #
jar xf /usr/share/dcache/classes/dcache-core-<version>.jar org/dcache/services/billing/plot/plot.properties
[root] #
less org/dcache/services/billing/plot/plot.properties