Create a custom counter configuration

Streamline uses the counters in the Events to collect list to determine what data it collects during a capture session. If an event you want to profile is not shown, you can add it to the list and create a custom counter configuration.

Before you begin

Set up your host machine and connect to a target device as described in the relevant Streamline target setup guide.

Procedure

  1. In the Start view, select the Use advanced mode checkbox.

  2. Click Select Counters.

  3. Double-click an event, or click and drag an event to move it from Available events to the relevant category in the Events to collect list.

    • The Available events list contains categorized events that are offered for each core on your target, and other hardware and OS-specific events. Events that are contained in the processor lists are based on the PMU counters of the core. They can vary depending on the type of processor, as can the number of events that you can add.

    • To show advanced events for your target in the Available events list, click Toggle advanced view toggle_advance_view.

    The added events appear in gray in the Events to collect list under their category name, and are used by the Timeline view for its graphs. Each event that is listed here is available for display in a chart in the Timeline view.

    Note

    • Selecting a high number of counters might affect performance of the application on the target.

    • To automatically collect the set of counters that are required to generate the charts defined in a chart configuration template, see Add counters from a template. To setup chart configuration templates, click Switch and manage templates templates in the Live view and Timeline view.

    • To reset the Events to collect list to default, click Reset to default load_defaults.

  4. If a counter can be collected from different cores or interfaces, select a specific core or interface from the menu next to the counter in the Events to collect list.

  5. Click Save.

  6. (Optional) To save your custom counter configuration for future reuse, export the configuration to a file, which you can edit and import later. To learn how to export your configuration, see: Importing and exporting counter configuration files.

    For example, you can reuse an exported configuration file to profile other applications on the same device. Another example is to run Streamline in headless mode (see Generate a headless capture), where you must specify a configuration file to use on your command line.

Next steps

The number of hardware-specific events that you can collect during a capture session is limited. To make space to add new counters, you can remove unwanted counters from the Events to collect list. In the Select Counters dialog box, select all the events that you want to remove from the Events to collect list, then click Remove selected remove_selected_events.