HP Caliper Advisor Rule Writer Guide

type
Returns a list of tuples with the top N entries of type
type for the specified histogram.
In this release of the Advisor, type can only be
replaced with FUNCTION. In later releases, other
types will be supported.
N (number of items) is assumed to be 10 and the
default sort key is appropriate to the type of
histogram.
Examples:
get_histogram(‘ALAT’, ‘FUNCTION’)
get_histogram_nth(‘ALAT’, ‘FUNCTION’, -1)
(type, number) Similar to type above, except that the number of
items to return is also given. When the number
modifier is provided, the entire event description
must be enclosed in parentheses to form a Python
tuple.
Replace type with FUNCTION.
Replace number with the number of items to return.
The default sort key is appropriate to the type of
histogram.
Examples:
get_histogram(‘IP’, (‘FUNCTION’, 20))
get_histogram_nth(‘IP’, (‘FUNCTION’, 20),
-2)
(type, number, sort ) Similar to type above, except that the number of
items to return and the sort key are also given. When
the number and sort modifiers are provided, the
entire event description must be enclosed in
parentheses to form a Python tuple.
Replace type with FUNCTION.
Replace number with the number of items to return.
Replace sort with the desired sort key appropriate
to the type of histogram, as shown in
Table 4-2 “Histogram Types and Sort Keys Available”.
Examples:
get_histogram(‘DCACHE’, (‘FUNCTION’, 25,
‘AVERAGE_LATENCY’))
get_histogram_nth(‘DCACHE’, (‘FUNCTION’, 25,
‘AVERAGE_LATENCY’), 0)
Histogram Accessor Function: get_histogram 43