Renaming Events

The VTune(TM) Performance Analyzer enables you to rename an event by assigning an alias name. Use an alias name to indicate event collection settings specified in the Edit Event dialog box and easily identify the required results in the sampling views.

For example, when configuring the event collection in the Edit Event dialog box for systems with Intel(R) Pentium(R) 4 processors, you select the User T0 option to collect events in user ring only and rename the event to Clockticks User Ring Only. The Tuning Browser displays this name as the event run name:

The same name shows up in the data tables of the sampling views.

To assign an alias name to an event from GUI:

  1. Double-click the Activity in the Tuning Browser.
    The About to Modify Activity with Results dialog box opens.

  2. Specify which Activity you want to modify and Click the OK button.
    The Activity Configuration dialog box opens with the General panel active.

  3. Click Configure... under the Collector(s) list.
    The Configure Sampling dialog box opens.

  4. From the Configure Sampling dialog box, select the Events configuration panel.

  5. In the Events panel, select the required event and click Edit event....
    The Edit Event dialog box opens.

  6. Customize the collection settings as required and select the opcode filter.

  7. Modify the event name specified in the Event name field as desired.

  8. Click the OK button.
    The VTune analyzer uses the alias name specified in the Edit Event dialog box in the sampling data views and Tuning Browser.

To assign an alias name to an event from the command line:

use the -event-alias (or -ea) option.

Command-line example:

>vtl activity -c sampling -o "-ec -event-name='L3_REFERENCES' :ea='L3_REFERENCES_fpload' -opcode-filter='fploads'" run

This example creates the Activity with the sampling collector. The sampling collector uses the event-based sampling and collects samples based on the L3_REFERENCES event with the fploads opcode filter set up. This means that the VTune analyzer collects the L3_REFERENCES event only when the fploads instructions occur. The L3_REFERENCES event is renamed to L3_REFERENCES_fploads to reflect collection specifics in the sampling views.

note