HP UX Caliper Software manual Example Command Lines for Text Report, CPU Event Sets

◦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 into one user-reported sample. The result is saved in the text file cpu.txt in the current directory.

$ caliper cpu -m cpi:user,cpi:kernel my_app

This command gets separate CPI data at user and kernel privilege levels.

$ caliper cpu -o cpu.txt -w -e 120

This command collects system-wide overview metrics for two minutes and saves the result in the text file cpu.txt in the current directory.

Example Command Line for CSV Report

$ caliper cpu --csv csvout ./wordplay thequickbrownfox

CPU Event Sets

For the cpu measurement report, you specify one or more comma-separated lists of predefined event sets.

The available event sets are:

brpath	Provides information on the dynamic mix of branch types, branch path
	distribution, branches per instruction, and so forth.
brpred	Provides metrics that are useful in assessing the effectiveness of branch
	prediction.
c2c	Provides “cache-to-cache” metrics related to cache coherence activity.
cpi	Provides metrics related to cycles per instruction (CPI).
cpubus	Provides information on the demand that a specific CPU presents to the central
	electronics complex (CEC), the chip set surrounding the CPU, and the demand
	the CPU experiences due to the CEC traffic initiated by other CPUs or I/O
	components in the system.
cspec	Provides metrics on the effectiveness of control speculation.
dispersal	Provides a qualitative view of the parallelism that is available as seen at
	instruction dispersal.

cpu Measurement Report Description 179