HP Caliper Advisor Rule Writer Guide

Table of Contents
About This Document.....................................................................................................................9
1 Overview: HP Caliper Advisor and Analysis Rules........................................................................13
What Is the HP Caliper Advisor?.......................................................................................13
Steps in Using the Advisor.................................................................................................13
Example of an HP Caliper Advisor Report........................................................................15
What Are Analysis Rules?..................................................................................................16
2 Running the HP Caliper Advisor.................................................................................................19
Getting Started with the Advisor: Examples......................................................................19
Simplest Example..........................................................................................................19
More Typical Examples.................................................................................................19
Explanation of Report Output.......................................................................................20
Command Line to Invoke the Advisor...............................................................................22
How to Read an Advisor Report........................................................................................23
3 How the HP Caliper Advisor Works............................................................................................27
Analysis Objects and Datasets............................................................................................27
Processing Stages: What the HP Caliper Advisor Does.....................................................27
Preprocessing Steps ......................................................................................................27
Analysis and Printing Steps..........................................................................................29
Rule Files: Syntax and Concepts.........................................................................................29
Analysis Objects: Concepts.................................................................................................30
Accessor Functions.............................................................................................................32
Arguments and Return Values......................................................................................33
Distinctions Between Datasets.................................................................................34
Advanced Features..................................................................................................35
4 HP Caliper Advisor Accessor Functions.......................................................................................37
Global Metrics Accessor Function: get_metrics..................................................................37
Total PMU Counts.........................................................................................................37
Multiplexed PMU Statistics...........................................................................................38
Sampling Parameters.....................................................................................................39
Dataset ID......................................................................................................................40
Examples of the Use of the Global Metrics Accessor Functions...................................41
Histogram Accessor Function: get_histogram...................................................................42
Histogram Results.........................................................................................................42
Sampling Parameters.....................................................................................................44
Table of Contents 3