To manage filters using the GUI Filter Manager

Purpose

Perform this procedure to create, modify, assign or delete a LogViewer filter.

Note: The Filter Manager is opened from within LogViewer, but runs as a separate applet. This enables the dragging and dropping of filters between Filter Manager and the Filters sub-tab of a lob tab.

Steps
 
1 

Choose Log→Filter Manager from the LogViewer main menu. The Filter Manager applet opens.

2 

To add a regular filter or a simple filter:

  1. Click Add or Add Simple, as required. The Add Filter form opens.

  2. Configure the Name parameter by specifying a unique name for the filter.

  3. Configure the required parameters that correspond to the fields in a log entry by entering regular expressions for regular filters, or just strings for simple filters as a filter criterion for each:

    • Level

    • Message

    • Thread

    • Logger

    • Timestamp

    • Platform

  4. If you are configuring a simple filter, go to Step 2 11 .

  5. Test a regular expression that you enter by clicking Test beside the regular expression. The Regular Expression form opens.

  6. Paste an example log entry that you want to match using the regular expression into the Example field.

  7. Click on the green right-pointing arrow to test the expression. If the expression is invalid, a message is displayed to indicate the error in the expression.

  8. Correct the errors in the expression.

  9. Repeat Step 2 7 and Step 2 8 until no error message is displayed.

  10. Repeat Step 2 5 to Step 2 9 to test additional regular expressions, if required.

  11. Enable the Color parameter and click in the field beside the parameter to specify a highlight color for the matching log entries. A standard color chooser form opens.

  12. Use the form to specify a color and click OK. The color chooser form closes and the Add Filter form reappears.

  13. Click OK. The Add Filter form closes and the Filter Manager form lists the new filter.

3 

To create a saved filter based on the current quick filter, perform the following steps:

  1. Choose Log→Create from Quick Filter from the LogViewer main menu, or click Create from quick in the main tool bar. The Add Filter form opens and is populated with the quick filter match criteria.

  2. Modify the match criteria as required.

  3. Click OK to save the filter.

4 

To create a saved filter using a log entry as a template:

  1. Select a log entry.

  2. Choose Log→Create from Selected from the LogViewer main menu, or click Create from entry in the main tool bar. The Add Filter form opens and is populated with the current log-entry field values as match criteria.

  3. Modify the match criteria as required.

  4. Click OK to save the filter.

5 

To move a filter to other instances of the LogViewer:

  1. To export a filter, click Export in the main tool bar, or choose Log→Filter Manager from the LogViewer main menu. The Export form opens, and allows you to export a filter to a specified file.

  2. To import a filter, click Import in the main tool bar, or choose Log→Filter Manager from the LogViewer main menu. The Import form opens, and allows you to import a filter from a specified file.

  3. Click OK to save the filter.

6 

To make a copy of a filter, select the filter and click Copy. A copy of the filter is listed on the Filter Manager form.

7 

To edit a filter, select the filter and click Edit. Configure the required parameters described in Step 2.

8 

To delete a filter, select the filter and click Delete.

End of steps