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 most tabs of the Execution Statistics view. By default specifically preconfigured "Default Filter" is turned on.

  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.
  • 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
    4. Clear the Exclude get/set/is methods check box (which is checked by default) if you want to include setters and getters in the scope of displayed data.
    5. Clear the Exclude methods with negligible base time check box (which is checked by default) if you want to include all (even zero-base time) methods in the scope of displayed data.
  • 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".

    Click OK.

    1. To edit an existing entry, select it, click Edit and modify the fields.
    2. To remove an entry, select it and click Remove.
    3. Select group expression combo box to group entries in table by AND or OR condition. Default selection is AND condition.

  • 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
    Determining problems in applications


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