Highlighting Log Entries

The Log Viewer enables you to highlight log entries based on an expression. For example, you could highlight all log entries whose severity is ERROR.

There are two ways you can highlight log file entries in the Log Viewer.

Using Pre-Defined Highlight Filters

You can right-click directly on a log file entry and use the pre-defined filters to highlight log file entries.
Highlight Filter Description
attributeName = value The attribute name in the log entry you selected is equal to the value in the log entry you selected. Selecting this highlights all other log entries with an attribute that has that value.
attributeName <> value The attribute name in the log entry you selected is greater than or less than the value in the log entry you selected. Selecting this highlights all other log entries with an attribute that has value greater than or less than the value in the log entry you have selected.
isset (attributename) The attribute name in the log entry you selected is set. Selecting this displays all the log entries with an attribute that has been set.
(NOT (isset(attributename))) The attribute name the log entry you selected is not set. Selecting this displays all the log entries with an attribute that has not been set.
threadName = threadname The thread name in the log entry you selected. Selecting this displays all log entries with the same thread name as the log entry you selected.

To clear the highlights, right-click anywhere in the Log Viewer and select Clear Highlights.

Using the Highlights Dialog

In the Highlights dialog, you can configure an expression that highlights the log file entries that match the expression. The expression uses Event Collector Query Language (ECQL). See TIBCO ActiveMatrix BPM Developer's Guide for information about ECQL.

Procedure

  1. From Log Viewer, select Highlights.
  2. From the Load Highlights from View drop-down list, select the view you require.
    By default, there are two expressions already configured to highlight log entries that have a log level of ERROR or WARN.
  3. Click Add.
    A new line is added.
  4. Click in the left-hand column to type your expression. For example, severity='FATAL'.
    You can click Save view to save your current settings as a view. Enter the name of your view in the Save view dialog and click OK. The newly created view is now available for you to use in the View drop-down list.
  5. Click in the right-hand column to display the Pick a Color dialog.
  6. Select the color you require and click OK.
  7. You can use the Move Up and Move Down buttons to determine which expression in the Highlights dialog is evaluated first. You can click Delete to remove an expression at any time.
  8. Click OK to close the Highlights dialog and return to the Log Viewer.
    The Log Viewer highlights the log entries that match the expression you have specified.
  9. You can click Save view to save your current settings as a view. Enter the name of your view in the Save view dialog and click OK. The newly created view is now available for you to use in the View drop-down list.
  10. To clear the highlights, right-click anywhere in the Log Viewer and select Clear Highlights.
Next topic: Filtering Log Files
Previous topic: Configuring Log Viewer Columns