HP Caliper User's Guide

The overview measurement multiplexes fprof, dcache, and cstackmeasurements
at a time interval of 1 second. The default switch interval of 1 second can be changed
using the --switch-interval=SECONDS option. After each switch interval, Caliper
will switch from one measurement to the next.
On system-wide runs, Caliper will multiplex fprof and dcache measurements. The
following command line will collect system-wide fprof and dcache data for a duration
of 300 seconds:
$ caliper overview -w -e 300 -o rpt
The sampling period of fprof, dcache and cstackmeasurements can be controlled
using the following new options:
--fprof-sampling-spec evt_period[,variation[,cpu_event]]
--dcache-sampling-spec evt_period[,variation[,cpu_event]]
--cstack-sampling-spec time_period
The syntax of these options is similar to the --sampling-spec option:
evt_period
Specifies how many sampling events should occur between samples.
variation
Specifies how much to vary the number of events between samples
(can be specified as either an exact count or as a percentage of the
sampling rate if followed by %).
cpu_eventt
specifies the CPU event to use for sampling.
time_period
Is a sampling period in seconds, milliseconds, or microseconds
(specified as Ns, Nms, orNus, respectively, where N is an integer).
Here is a complete example:
$ caliper overview -o rpt --switch-interval 3 \
--fprof-sampling-spec 1000000 \
--dcache-sampling-spec 20000,5%,DATA_EAR_EVENTS \
--cstack-sampling-spec 250ms my_app
In the above example, the overview measurement will run the fprof measurement
for 3 seconds, dcachemeasurement for 3 seconds, and cstack measurement for 3
seconds continuously until the program terminates. The fprof measurement will use
a sampling interval of 1 million CPU_CYCLES (or CPU_OP_CYCLES on dual-core
Itanium 2 and Itanium 9300 quad-core processors). The dcachemeasurement will
take one sample for every 20000 DATA_EAR_EVENTs and it will use 5% as the sampling
period variation. The cstack measurement will take one sample for every 250
milliseconds.
On HP-UX, the per-process overview measurement requires a 11i v3 system with the
kernel patch PHKL_38072 installed.
60 HP Caliper Measurement Configuration Files