HP Caliper 5.7 User Guide (769153-001, March 2014)

--threads................................................................................................................................75
--traps-reported.......................................................................................................................75
--user-regions (HP-UX only) .................................................................................................76
--version.................................................................................................................................76
6 Using the HP Caliper Advisor.....................................................................77
What Is the HP Caliper Advisor?..............................................................................................77
Example of an HP Caliper Advisor Report..................................................................................77
Steps in Using the Advisor.......................................................................................................78
Command Line to Invoke the Advisor.........................................................................................79
Getting Started with the Advisor: Examples................................................................................81
Simplest Example...............................................................................................................81
More Typical Examples.......................................................................................................81
Explanation of Report Output..............................................................................................82
How to Read an Advisor Report................................................................................................83
Suggestions for Using the HP Caliper Advisor.............................................................................84
How the HP Caliper Advisor Works..........................................................................................85
7 Using the HP Caliper Advisor in the GUI.....................................................86
Basic Steps in Using the HP Caliper Advisor in the GUI...............................................................86
Making Performance Measurement Runs....................................................................................86
Selecting Performance Data to Analyze [Optional] .....................................................................87
Generating Advice.................................................................................................................89
Reviewing and Acting on the Advice.........................................................................................90
8 Configuring HP Caliper ............................................................................92
Specifying Option Values with a .caliperinit Initialization File........................................................92
Example of a .caliperinit File...............................................................................................92
Setting Constants in the .caliperinit File.................................................................................93
Configuring Data Collection.....................................................................................................94
Specifying Which CPU Events to Measure.............................................................................94
Shortening CPU Event Names.........................................................................................94
Specifying Which Load Modules to Collect Data For..............................................................95
Default Settings for Load Module Data Collection..............................................................95
How to Specify Load Module Names...............................................................................96
Controlling Granularity of Data Collection and Reports...........................................................97
Specifying Processes to Measure..........................................................................................97
Process Tree Report.......................................................................................................97
Syntax for -p Option......................................................................................................98
Using -p some ..............................................................................................................99
Examples of the -p Option ...........................................................................................100
Using HP Caliper in Your Build Process...............................................................................100
Using HP Caliper in Testing and Quality Assurance.........................................................100
Using HP Caliper to Generate Test Suite Reports.............................................................101
Attaching to a Running Process to Perform Measurements......................................................101
How to Display Reference Information About CPU Counters or HP Caliper Report Types.................102
Options for the caliper info Command................................................................................102
-c or --cpu-counter........................................................................................................102
-d or --details..............................................................................................................103
-o or --output-file..........................................................................................................103
-r or --report................................................................................................................103
-s or --search...............................................................................................................103
Examples of the caliper info Command...............................................................................103
HP Caliper Environment Variables...........................................................................................104
9 Controlling the Content of Reports.............................................................105
Layout of an HP Caliper Text or CSV Report.............................................................................105
6 Contents