HP Caliper User's Guide

cpu Measurement Report Description
Available only on HP-UX.
With the cpu measurement, produced by the cpu measurement configuration file,
HP Caliper measures and reports per-process or system-wide metrics based on sampled
CPU events.
Specify the events and sampling period with the -m event_set and -s period
options, respectively. You can measure multiple metrics in the same run.
The --cpu-aggregation option specifies how many low-level samples will be
aggregated into one user-reported sample.
The default value used with the cpu measurement is overview.
The report shows this information:
• Summary statistics for all of the samples in the measured application:
— MEAN — Mean value of all samples.
— STDEV — Standard deviation of the samples.
— 90%CI — 90 percentage confidence interval. This indicates that, statistically,
90% of the time, the mean value will lie within this distance from the present
mean value.
— MINIMUM — Minimum value across all samples.
— LOW90 — Lowest value in the 90% confidence interval. This indicates that,
statistically, 90% of the time, the mean value will be higher than or equal to
this value.
— HIGH90 — Highest value in the 90% confidence interval. This indicates that,
statistically, 90% of the time, the mean value will be lower than or equal to this
value.
— MAXIMUM — Maximum value across all samples.
If you set the --cpu-details means option, only the MEAN and STDEV
statistics are reported. This is the default.
• A list of samples, with each sample showing both sampled values and statistics
derived from those values. To report samples (not shown by default), specify
--cpu-details means:samples or --cpu-details statistics:samples.
Example Command Lines for Text Report
$ caliper cpu -o cpu.txt program
This command runs program, measuring and reporting the overview metrics by
taking one sample every 8 milliseconds. By default, 125 low-level samples will be
aggregated into one user-reported sample, resulting in one aggregated sample collected
per second. The text report is saved in the text file cpu.txt.
$ caliper cpu -o cpu.txt -s 100ms
--cpu-aggregation 10 ./wordplay thequickbrownfox
This command runs the program wordplay , measuring and reporting the overview
metrics by taking a sample every 100 milliseconds and aggregating 10 low-level samples
236 Descriptions of Measurement Reports