Applying filters in profiling views

The Profiling Tool provides a filtering mechanism that can be used to reduce the amount of data displayed in the different profiling views. Profiling filters are available in the UML2 Sequence Diagram views, the Memory Statistics view, and the Execution Statistics view.

  1. To work with filters, select Manage Filters Filter icon from the toolbar menu.
  2. If prompted to add a new filter, select New...
  3. In the Edit Filters dialog, select Profiling Filter and click OK.
  4. Define your filter by using one or both of the Filter mechanisms on the two tabs: Standard or Advanced. The Standard tab lets you quickly set some simple, common filters. The Advanced tab lets you create highly customized filters.
  5. To define a standard filter:
    1. To show only data that matches a pattern, specify a string pattern in the Filter String field.
    2. Select the object type to filter by, i.e. by package, class or method.
    3. Click the Show information matching check box if you want only a specific set of data. Use the drop-down boxes to define the filter. In the example below, the filter is specified to show the lowest 10 entries by the number of calls.
      basic filter
  6. To define an advanced filter:
    1. Click the Advanced tab. The Advanced filtering table shows all the filter criteria defined. Profiling data entries that match all of the defined criteria will be displayed in the view. If there are no filter criteria specified, all data entries will be displayed.
    2. To add an entry in the table, click Add. Select the attribute you want to filter on from Attribute list. Select the operator (like performs a pattern match). Enter a value that profiling data entry must have for that attribute in order to be filtered:
      • Use an asterisk (*) to represent any string.
      • Use a bar (|) to represent a non-exclusive "or".
    3. Click OK.

    4. To edit an existing entry, select it, click Edit and modify the fields.
    5. To remove an entry, select it and click Remove.
    6. Select group expression combo box to group entries in table by AND or OR condition. Default selection is AND condition.
  7. To edit an existing filter, select Manage filters Filter iconfrom the toolbar or select the filter listed in the drop down menu. When a filter is selected and applied in the view, click on the Filter button to edit the filter. If there is no filter applied, clicking on the Filter button will open the Filter creation dialog.

Note: When using view filters, it is best to choose the application context for the view first, if the choice is available. That is, if you want to filter the view to show only a certain Java package, you should set the display to the Java application context first, then specify your filter pattern.

When using import filters, the application context of the data to be imported is not yet known. Import filters are always specified using Java syntax, with a dot separating each component of a package name, for example "org.eclipse."

For more information, see Understanding application contexts in profiling views.

Related concepts
Overview of the Profiling Tool
Overview of the Log and Trace Analyzer
 

Related tasks
Profiling an application
Using UML2 Trace Interaction views
Using the Memory Statistics view
Using the Execution Statistics view