ipacc's reporting module takes as input a series of charge records
taken from each source listed in the source statement for the period
of the report (from the
frequency
statement). Data is then selected, processed and sorted.
Note that the ipacc supervisor process schedules summary runs so that
reports are generated for fixed periods as per the frequency
statement; if ipacc is behind, separate runs will be performed for
each outstanding period.
The sources source ... statement lists all the collector data
sources from which charge records should be summarised. If the
sources statement is omitted, all sources which are defined as
collectors will be included.
The key key ... statement controls the level of summarisation
done by the report. Output lines (and their associated counters) are
summarised down so that each set of keys is unique.
By default, summarisation is done to the network and charge
keys. This is also the default level of detail collected at the
data processing stage; if more detail is required, it must be specified
in the charge statements as well as in key statements.
The include key value ... selects data to be reported.
key is the key field to select on. Each value field contains a
value patterns which must the key field if the record is to be
processed. Value patterns are in the form:
| value |
Key must equal value |
| !value |
Key must not equal value |
| *value |
Key must end in value |
| !*value |
Key must not end in value |
| value* |
Key must start with value |
| !value* |
Key must not start with value |