HP Caliper 5.3 User Guide (5900-1558, February 2011)

Table 1 Available Measurements in Each Measurement Type
Precise (HP-UX only)SampledGlobal
cgprof
fcount
fcover
alat
branch
cgprof
cpu
cstack
cycles
dcache
dtlb
fprof
icache
itlb
pmu_trace
scgprof
traps
ecount
NOTE: The cgprof measurement performs both sampled and precise measurements.
The measurements in the sampled category, with the exception of cpu and pmu_trace, show
results grouped by function. A report produced by any of these measurements is referred to as a
PMU histogram report.
The measurements in the precise category use dynamic instrumentation to perform their
measurements.
Overview Measurement
The overview measurement enables collecting fprof, dcache, and cstack data in one single
collection run. To run overview on an application enter:
$ caliper overview -o rpt my_app
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:
44 HP Caliper Measurement Configuration Files