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:
- Event type (whether the event is information, an error or a warning)
- Event source (what caused the event, and where it originates within
the broker domain, for example the configuration manager, and specified
message brokers
- Event timestamp (the date and time when the event occurred)
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:
- Switch to the Broker Administration perspective.
- In the Domains view, open the Event Log for the appropriate
broker domain.
- 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:
- Clear the check boxes for all three event types.
- 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.
- 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:
- Deselect all sources, click the Deselect All button
under the source check boxes, or clear the check boxes for all sources.
- 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.
- 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:
- 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.
- 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.