HP Caliper User Guide Release 5.5 (5900-2351, August 2012)

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