HP Caliper Advisor Rule Writer Guide
Table 4-2 Histogram Types and Sort Keys Available
Sort KeyHistogram Type
MISSES (default)ALAT
AVERAGE_LATENCY, LATENCY (default), MISSESDCACHE
HPW_FILLS, L2_FILLS, MISSES (default), SOFT_FILLSDTLB
AVERAGE_LATENCY, LATENCY (default), MISSESICACHE
SAMPLES (default)IP
HPW_FILLS, L2_FILLS, MISSES (default), SOFT_FILLSITLB
Table 4-3 “Histogram Types and Return Values” shows the data returned for function
histograms.
The data is structured as a tuple of tuples, one inner tuple for each of the N histogram
items returned. The table describes the contents of each of the inner tuples.
function_name and image_name are string values, average_latency is a
floating-point value, and all other metrics are integer values. Note that image_name
can be the None value if the origin of the sample is unknown.
Table 4-3 Histogram Types and Return Values
Return ValuesHistogram Type
(function_name, image_name, misses)
ALAT
(function_name, image_name, misses, latency,
average_latency)
DCACHE
(function_name, image_name, misses, l2_fills, hpw_fills,
soft_fills)
DTLB
(function_name, image_name, misses, latency,
average_latency)
ICACHE
(function_name, image_name, samples)
IP
(function_name, image_name, misses, l2_fills, hpw_fills,
soft_fills)
ITLB
Sampling Parameters
The sampling parameters used for a histogram can be retrieved using the following
metric name:
sample
Returns the requested sampling parameter, which is an integer or string
value, depending on the specific parameter.
Replace sample with SAMPLE_COUNT, SAMPLE_EVENT, SAMPLE_PLM,
SAMPLE_RATE, SAMPLE_THRESHOLD, or SAMPLE_VARIATION.
44 HP Caliper Advisor Accessor Functions