If you installed dCache following the instructions in the
Chapter Installing dCache you
enabled the billing in the domain where the httpd
service is running (see the extract of the layout file).
... [httpdDomain] [httpdDomain/httpd] [httpdDomain/billing] [httpdDomain/srm-loginbroker] ...
Use the property billingLogsDir to set the
location of the log files and the property
billingDisableTxt to control whether the
plain-text log files are generated.
By default the log files are located in the directory /var/lib/dcache/billing. Under this
directory the log files are organized in a tree data structure
based on date (YYYY/MM). A separate file is generated for
errors. The log file and the error file are tagged with the
date.
Example:
log file:
/var/lib/dcache/billing/2012/09/billing-2012.09.25
error file:
/var/lib/dcache/billing/2012/09/billing-error-2012.09.25
The log files may contain information about the time, the pool, the pnfsID and size of the transferred file, the storage class, the actual number of bytes transferred, the number of milliseconds the transfer took, the protocol, the subject (identity of the user given as a collection of principals), the data transfer listen port, the return status and a possible error message. The logged information depends on the protocol.
A log entry for a write operation has the default format:
<MM.dd> <HH:mm:ss> [pool:<pool-name>:transfer]
[<pnfsId>,<filesize>] [<path>]
<StoreName>:<StorageGroup>@<type-of-storage-system>
<transferred-bytes> <connectionTime> <true/false> {<protocol>}
<initiator> {<return-status>:"<error-message>"}Example:
A typical logging entry would look like this for writing. In the log file each entry is in one line. For readability we split it into separate lines in this documentation.:
12.10 14:19:42 [pool:pool2@poolDomain-1:transfer]
[0000062774D07847475BA78AC99C60F2C2FC,10475] [Unknown]
<Unknown>:<Unknown>@osm 10475 40 true {GFtp-1.0 131.169.72.103 37850}
[door:WebDAV-example.org@webdavDomain:1355145582248-1355145582485] {0:""}
The formatting of the log messages can be customized by
redefining the
<billing.format.someInfoMessage>
properties in the layout configuration, where
<billing.format.someInfoMessage> can be
replaced by
billing.format.MoverInfoMessagebilling.format.RemoveFileInfoMessagebilling.format.DoorRequestInfoMessagebilling.format.StorageInfoMessage
A full explanation of the formatting is given in the
/usr/share/dcache/defaults/billing.properties
file. For syntax questions please consult StringTemplate
v3 documentation or the cheat
sheet.
On the web page generated by the httpd service, there is
a link to Action Log. The table which appears
there gives a summary overview extracted from the data contained
in the billing log files.