WebSphere Message Brokers
File: an04050_
Writer: Bill Oppenheimer

Task topic

This build: July 31, 2007 21:33:10

Filtering broker domain log information

Broker domain log information is written to the Event Log editor in the workbench. The Event Log contains information about events that occur in a broker domain. For each event, the Event log records the following details:

You can filter on the type, the source and the timestamp of the message, to restrict the number of log entries that are displayed in the Event Log editor. You can also filter events, event by event, to view a particular set of events in the Event log editor. The filter settings you define are kept for your next session. A note also appears next to the view label to indicate that a filter has been applied.

To filter entries, use the Filter Event Log dialog:

  1. Switch to the Broker Administration perspective.
  2. In the Domains view, open the Event Log for the appropriate broker domain.
  3. From the Event Log editor menu, click Event Log editor> Filter Log .... This action opens the Filter Log dialog.

    The Filter Log dialog has the following controls:

    • A check box for each of the three message types (information, error or warning)
    • A check box for each of the possible message sources for all known entries so far
    • Under the source check boxes, a Select All button to select all sources and a Deselect All button to deselect all sources
    • A non-editable drop-down list containing each possible timestamp of all known entries so far
    • A table of check box items for each log entry, with a vertical scroll bar to access additional entries
    • Under the table, a Select All button to select all events, and a Deselect All button to deselect all events from this table
    • A Restore Defaults button

    In the default view of the Log Filter, all message type check boxes are selected, indicating that messages of all three types are displayed. All message source check boxes are also selected by default, indicating that messages of all sources are displayed. The timestamp is the one for the oldest known event so far. All events are selected in the table.

    To restore the default settings, click Restore Defaults (the defaults are: all types selected, all sources selected, timestamp set to oldest event one, all events selected).

    To discard all changes, click Cancel.

    To save the current filter settings, click OK. This applies the settings to the opened editor (event filtering is based on the new settings, and the editor is refreshed).

    Using the Event Log Filter, you can filter broker domain log information in the following ways:

    • Filter by message type, so that the log only displays messages of a particular type:
      1. Clear the check boxes for all three event types.
      2. Check the check box of the event type that you want to view (you can view more than one type by selecting the appropriate check boxes). All events with the selected types are selected in the filter dialog table of entries.
      3. Click OK to activate the filter. All events with the selected types are displayed in the editor.
    • Filter by message source, so that the log only displays messages from one source:
      1. Deselect all sources, click the Deselect All button under the source check boxes, or clear the check boxes for all sources.
      2. Check the check box of the event source that you want to view (you can view more than one source by selecting the appropriate check boxes). You can also view all sources click by clicking the Select All button under the source check boxes. All events with the selected sources are selected in the filter dialog table of entries.
      3. Click OK to activate the filter. All events with the selected sources are displayed in the editor.
    • Filter by timestamp, so that the log hides messages generated before a specified timestamp:
      1. Open the Hide Events generated before drop-down list by clicking the down arrow. Select the timestamp you want to filter on. All events generated before this timestamp are deselected in the filter dialog table of entries.
      2. Click OK to activate the filter. All events generated before the reference timestamp are hidden in the editor. All other events are displayed.

    You can combine filtering options (type, source, time stamp). The combinations you select are identified in the table (entries are automatically ticked or non-ticked to indicate the choices you make). The editor is also updated based on the events tables which combines all filtering options. Ticked entries are displayed, non-ticked entries are hidden. For incoming new events, the filtering options based on type, source, timestamp are applied.

Related concepts
Broker domains
Related tasks
Viewing broker domain log information
Clearing broker domain log information
Saving broker domain log information
Refreshing broker domain log information
Changing Event Log editor preferences
Related reference
Broker Administration perspective
Event Log editor
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:33:10

an04050_ This topic's URL is: