release notes | Book: 1.9.5, 1.9.12 (opt, FHS), 2.2 (FHS), 2.6 (FHS), | Wiki | Q&A black_bg
Web: Multi-page, Single page | PDF: A4-size, Letter-size | eBook: epub black_bg
Generating and Displaying Billing Plots
Prev Chapter 15. The billing Service Next
The dCache Book > Configuration of dCache > The billing Service > Generating and Displaying Billing Plots

Generating and Displaying Billing Plots

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 in dcache.conf or in the layout file for the domain where the poolmanager runs: 

    poolmanager.cache-hit-messages.enabled=true

[return to top]

Customizing the plots

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
Prev Up Next
The billing database Home Migrating from 1.9.12+ to 2.2