You copied the Doc URL to your clipboard.

Category and event parameters for custom counters in events.xml

In addition to adding gator functions to your code so that gator can collect data for your custom counters, you also must provide descriptions of your counters in the events.xml file.

The category node has the following attributes:

Mode

Description

name A name for this category of counters. This names the header the counter appears under in the counter configuration dialog box.

counter_set

Defines the counter set to be used.

per_cpu

Defines whether or not Streamline collects data on a per cpu basis. Set this value to yes and Streamline collects data from each cpu separately for these counters.
supports_event_based_sampling Use yes or no to define whether or not the counters in this category can be used for event based sampling. The default value is no.

For example: <category name="Cortex-A9" counter_set="ARM_Cortex-A9_cnt" per_cpu="yes" supports_event_based_sampling="yes">

Use the following attributes in the event elements:

Mode

Description

counter Every event element must have either the counter or event attribute defined. Use the counter attribute for fixed counter types, like cycle count. Use the event attribute for all other events.

event

Architecture specific or implementation-specific event number, in hexadecimal, determined from either the architecture specification document or the Technical Reference Manual of the processor. This attribute is required if the element does not have a counter attribute.

title

The title of the chart that Streamline displays. Counters with matching titles stack in the charts.
name The name that Streamline displays after the title.
per_cpu Defines whether or not Streamline collects data on a per cpu basis. Set this value to yes and Streamline collects data from each cpu separately for this event.
supports_event_based_sampling Use yes or no to define whether or not the event can be used for event based sampling. This value defaults to the category value if the attribute is not present in the event.
display Use one of the following values with the display attribute: average, maximum, minimum, hertz, accumulate. This is the same as adding .avg, .max, .min or .hz to the counter name in the chart configuration panel of Streamline. The default value is accumulate.
units Defines the unit type to display in Streamline.
average_selection Enter yes to have the values of the Cross Section Marker in the Timeline view display as average. Enter no to have them display as a total.
description Use this attribute to define a description to show in Streamline. The value of this attribute is used as the tooltip for the counter.
Was this page helpful? Yes No