Managing Log Messages

prevnext

Managing Log Messages

 

The following sections describe the functions of the Message Browser:

Working with the Message Browser

Monitoring Incoming Log Messages

Querying the Database

Filtering Log Messages

Deleting Log Messages

Acknowledging Log Messages

Removing Acknowledgments

Viewing Log Message Definitions

For a description of the log messages, see Log Central Message and Message Definition Formats.

Working with the Message Browser

The following sections explain how to use the Message Browser:

Starting the Message Browser

Main Components of the Message Browser

Message Browser Toolbar

Message Browser Menus

Changing the Log Message Layout

Changing Severity Colors

Starting the Message Browser

To start the Message Browser:

  1. Start the Log Central Console by running lc_launch on the central host.

    For detailed information about starting the Console, see Introducing the Log Central Console. For the lc_launch command syntax, see Commands.

  2. Click Msg Browser. Log Central displays the Message Browser.

    Figure 3-1 Message Browser

Main Components of the Message Browser

The following table describes the main components of the Message Browser.

Table 3-1 Main Components of the Message Browser

Component

Description

Menu bar

Provides the menus for the Message Browser. For more information, see Message Browser Menus.

Toolbar

Provides access to frequently used actions. For more information, see Message Browser Toolbar.

Unacknowledged field

Displays the number of messages in the message pane that have not been acknowledged. The Message Browser displays a value in this field when you perform online monitoring or query the database.

Displayed/Matched field

When you query the database, this field displays the number of messages that satisfy the filter settings and the number of messages displayed. These numbers differ if the query found more messages than the maximum that can be displayed. To configure the maximum number of messages that can be displayed, use the -n option when you start the Log Central Console.

For information about filter settings, see Filtering Log Messages. For information about the -n option, see the description of the lc_launch command in Commands.

Online Monitoring button

When you click Start, directs the Log Central Console to monitor and display log messages in real time as they arrive at the Central Collector. The Message Browser displays real-time incoming messages that satisfy the filter settings, with the most recent message displayed at the top of the message pane. For information about the filter settings, see Filtering Log Messages.

Historical Query button

When you click Start, directs the Log Central Console to query the Log Central database. The Message Browser displays messages in the database that satisfy the filter settings, with the most recent message displayed at the top of the message pane. For information about the filter settings, see Filtering Log Messages.

Message pane

Displays log messages.

Message Browser Toolbar

The following table describes the Message Browser toolbar. On the toolbar, all options except Stop and Help are inactive if the Message Browser is receiving real-time incoming messages or querying the database.

Table 3-2 Message Browser Toolbar

Button

Action


Retrieves and displays real-time incoming messages or messages that are in the Log Central database, depending on whether you selected Online Monitoring or Historical Query in the Message Browser. The Message Browser displays messages that satisfy the filter settings, with the most recent message displayed at the top of the message pane. For information about the filter settings, see Filtering Log Messages.


Stops retrieval of messages. This button is inactive if messages are not being retrieved.


Displays the Layout Definition window, in which you specify the message fields to display and the order in which to display them. For information about using the Layout Definition window, see Changing the Log Message Layout. You can also use the Layout Definition command in the Settings menu to display the Layout Definition window.


Displays the Filter Settings window, in which you can:

  • Define the criteria for determining which messages to display in the message pane

  • Select the sort order for messages from a database query

For information about using the Filter Settings window, see Filtering Log Messages. You can also use the Browser Filter command in the Settings menu to display the Filter Settings window.


Displays the Message Colors window, which enables you to change the colors for the severity levels. For information about using the Color Settings window, see Changing Severity Colors. You can also use the Message Colors command in the Settings menu to display the Message Colors window.


Displays the Log Central Online Help. You can also use the commands in the Help menu to display the Log Central Online Help.

Message Browser Menus

The following table describes the Message Browser menus.

Table 3-3 Message Browser Menus

Menu

Commands

File

Reports—Generates a report of the messages retrieved from a database query. This option is inactive if the Message Browser is in online monitoring mode. A submenu lets you generate a summary report or a detail report. A summary report groups messages by subsystem and presents the message totals for each severity level and log level. A detail report provides most of the message fields for each message. For more information about generating reports, see Generating Reports.

Close—Exits the Message Browser.

Edit

Delete—Deletes the selected messages.

View

Message Details—Displays the Message Details window, which displays the message body and message definition for the selected message.

Settings

Browser Filter—Displays the Filter Settings window, in which you can:

  • Define the criteria for determining which messages to display in the message pane

  • Select the sort order for messages from a database query

For information about using the Filter Settings window, see Filtering Log Messages. You can also use the Filter button in the toolbar to display the Filter Settings window.

Layout Definition—Displays the Layout Definition window, in which you can specify the message fields to display and the order in which to display them. For information about using the Layout Definition window, see Changing the Log Message Layout. You can also use the Layout button in the toolbar to display the Layout Definition window.

Message Colors—Displays the Message Colors window, which enables you to change the colors for the severity levels. For information about using the Color Settings window, see Changing Severity Colors. You can also use the Colors button in the toolbar to display the Message Colors window.

Actions

Start—Retrieves and displays real-time incoming messages or messages that are in the Log Central database, depending on whether you selected Online Monitoring or Historical Query in the Message Browser. The Message Browser displays messages that satisfy the filter settings, with the most recent message displayed at the top of the message pane. For information about the filter settings, see Filtering Log Messages.

Stop—Stops the database query or online monitoring.

Acknowledge—Acknowledges the selected messages.

Clear Acknowledgment—Clears the acknowledgments for the selected messages.

Help

Displays the Log Central Online Help for various Message Browser help topics. You can also use the Help button in the toolbar to display the Log Central Online Help.

Changing the Log Message Layout

You can change the fields to display in the Message Browser message pane. You can also change the order in which the fields are displayed.

To change the message layout:

  1. Start the Message Browser:

    1. Start the Log Central Console by running lc_launch on the central host.

      For detailed information about starting the Console, see Introducing the Log Central Console. For the lc_launch command syntax, see Commands.

    2. Click Msg Browser. Log Central displays the Message Browser.

  2. Click Layout.

    The Message Browser displays the Layout window.

    Figure 3-2 Message Browser Layout Window

  3. Select the fields to show or hide.

    Use the Show and Hide buttons to move selections from one list to the other.

  4. Use the up and down arrows to change the order in the Show list.

  5. To save these settings as the default for the current database user, select Save to Database.

  6. Click OK.

Changing Severity Colors

The following table shows the default severity colors.

Table 3-4 Default Severity Colors

Severity

Default Color

Informational

Green

Warning

Yellow

Minor

Blue

Major

Magenta

Critical

Red

To change the severity colors:

  1. Start the Message Browser or the Message Definition Editor:

    1. Start the Log Central Console by running lc_launch on the central host.

      For detailed information about starting the Console, see Introducing the Log Central Console. For the lc_launch command syntax, see Commands.

    2. Click Msg Browser or Msg Def Edit. Log Central displays the Message Browser or Message Definition Editor.

  2. Click Colors.

    The Log Central Console displays the Color Settings window.

    Figure 3-3 Color Settings Window

  3. Select the severity level to change.

  4. Move the Red, Green, and Blue sliders to get the color you want.

    If you do not want to map colors to severity levels, select the None button.

  5. Click OK.

Monitoring Incoming Log Messages

To monitor log messages in real time:

  1. Start the Message Browser:

    1. Start the Log Central Console by running lc_launch on the central host.

      For detailed information about starting the Console, see Introducing the Log Central Console. For the lc_launch command syntax, see Commands.

    2. Click Msg Browser. Log Central displays the Message Browser.

  2. Select Online Monitoring.

  3. Click Start.

    The Log Central Console monitors log messages in real time as they arrive at the Central Collector. The Message Browser displays messages that satisfy the filter settings you defined in the Filter Settings window, with the most recent message displayed at the top of the message pane. For information about the filter settings, see Filtering Log Messages.

Querying the Database

To query the Log Central database:

  1. Start the Message Browser:

    1. Start the Log Central Console by running lc_launch on the central host.

      For detailed information about starting the Console, see Introducing the Log Central Console. For the lc_launch command syntax, see Commands.

    2. Click Msg Browser. Log Central displays the Message Browser.

  2. Select Historical Query.

  3. Click Start.

    Queries the Log Central database. The Message Browser displays messages that satisfy the filter settings you defined in the Filter Settings window, with the most recent message displayed at the top of the message pane. For information about the filter settings, see Filtering Log Messages.

Filtering Log Messages

The Message Browser enables you to set filter criteria that:

  • Define which real-time incoming messages to display during online monitoring

  • Define which messages to retrieve in a database query

You can also set filters that the data collection agents use. For more information, see Chapter 7, "Creating Filters," in the Log Central Configuration Guide.

To filter messages:

  1. Start the Message Browser:

    1. Start the Log Central Console by running lc_launch on the central host.

      For detailed information about starting the Console, see Introducing the Log Central Console. For the lc_launch command syntax, see Commands.

    2. Click Msg Browser. Log Central displays the Message Browser.

  2. Click Filter.

    The Message Browser displays the Filter Settings window.

    Figure 3-4 Filter Settings Window

  3. Select Online Monitoring or Historical Query.

    The Filter Settings window displays the current filter settings for online monitoring or database queries. When you select Online Monitoring in the Message Browser and click Start, the Message Browser uses the online monitoring filter settings to display real-time incoming messages. When you select Historical Query in the Message Browser and click Start, the Message Browser uses the database query filter settings to retrieve and display messages that are in the Log Central database.

  4. Select one of the Acknowledged Messages buttons:

    • Yes—Display only acknowledged messages.

    • No—Display only unacknowledged messages.

    • All—Display acknowledged and unacknowledged messages.

  5. If you are filtering a database query:

    • Optionally, specify the first message by checking First Log Message and setting a date and time for the first message.

    • Optionally, specify the last message by checking Last Log Message and setting a date and time for the last message.

  6. If you are filtering a database query, optionally set the sort order based on message fields.

    You can configure up to three sorts, using ascending and descending sort order. To configure a sort:

    • Select or deselect Ascending. If you deselect Ascending, the Log Central Console sorts the messages in descending order. Ascending or descending order is determined by the alphabetical or numerical values in the selected message field. If a message field can contain both alphabetical and numerical values, the numerical values come first when sorted in ascending order.

    • Choose a message field in the Key drop-down list. Log Central sorts based on Key1 if it is set, then based on Key2 if it is set, and finally based on Key3 if it is set. The result is one list. For example, if Key1 is Date and Key2 is Subsystem, Log Central sorts by date and then by subsystem. The resulting list is ordered by subsystem, with the messages for a given subsystem ordered by date.

  7. Optionally, select the severity levels and log levels to include.

  8. Optionally, set filter criteria for the message fields:

    1. Select the tab for a message field. (There is a tab for most of the message fields.)

    2. Decide which of the following types of filter criteria to use for this field:

      Include messages that contain any values for this field (Show All).

      Include messages that contain values in the Use Include List.

      Exclude messages that contain values in the Use Exclude List.

      In the example in the preceding figure, Log Central excludes messages for which the Subsystem value is EM, GP, LM, or ORACLE.

    3. If you decided to use the Use Include List or Use Exclude List:

      To move values from one list to the other, highlight the values and click the appropriate Selected button (Selected < or Selected >).

      To move all values from one list to the other, click the appropriate All button (All < or All >).

      To delete values from a list, select the values and click Del Selected. To delete all values in both lists, click Delete All.

      To add a new value to a list, select the Use Include List or the Use Exclude List, enter the value in the text field above the buttons, and press Enter.

    4. Select the Show All, Use Include List, or Use Exclude List button depending on the type of filter criteria you are using.

    5. Repeat steps a through d for other tabs (fields) as desired.

  9. Click OK.

    The Log Central Console preserves these message definition editor filter settings until the next time that you modify them as long as you keep the Log Central Console running. Filter settings are lost when you exit the Log Central Console.

Deleting Log Messages

To delete messages from the Log Central database:

  1. Start the Message Browser:

    1. Start the Log Central Console by running lc_launch on the central host.

      For detailed information about starting the Console, see Introducing the Log Central Console. For the lc_launch command syntax, see Commands.

    2. Click Msg Browser. Log Central displays the Message Browser.

  2. Select Online Monitoring or Historical Query.

  3. Click Start.

    If you selected Online Monitoring, the Log Central Console monitors log messages in real time as they arrive at the Central Collector. If you selected Historical Query, the Log Central Console queries the Log Central database.

    The Message Browser displays messages that satisfy the filter settings you defined in the Filter Settings window, with the most recent message displayed at the top of the message pane. For information about the filter settings, see Filtering Log Messages.

  4. Click Stop.

  5. If you are not going to delete all messages, select the messages to delete.

    Note: The option to delete all messages is available only for historical queries. It is not available for real-time incoming messages.

  6. From the Edit menu, choose Delete.

    A submenu lets you delete the selected messages or all messages that were returned in the last database query.

Acknowledging Log Messages

Message acknowledgment is a feature that you can use to keep track of system problems that are currently being resolved or actively investigated. The Message Browser displays each message's acknowledgment status (Yes or No) in the Acked column in the Message pane. When you view the messages, you can see which ones are being worked on and which ones are not being handled yet.

Note: The option to acknowledge all messages is available only for historical queries. It is not available for real-time incoming messages.

To acknowledge messages:

  1. Start the Message Browser:

    1. Start the Log Central Console by running lc_launch on the central host.

      For detailed information about starting the Console, see Introducing the Log Central Console. For the lc_launch command syntax, see Commands.

    2. Click Msg Browser. Log Central displays the Message Browser.

  2. Select Online Monitoring or Historical Query.

  3. Click Start.

    If you selected Online Monitoring, the Log Central Console monitors log messages in real time as they arrive at the Central Collector. If you selected Historical Query, the Log Central Console queries the Log Central database.

    The Message Browser displays messages that satisfy the filter settings you defined in the Filter Settings window, with the most recent message displayed at the top of the message pane. For information about the filter settings, see Filtering Log Messages.

  4. Click Stop.

  5. If you are not going to acknowledge all messages, select the messages to acknowledge.

  6. From the Actions menu, choose Acknowledge.

    A submenu lets you acknowledge the selected messages or all messages that were returned in the last database query.

Removing Acknowledgments

You might want to remove an acknowledgment if a message was acknowledged when it should not have been, or if a problem that was thought to be resolved is still occurring.

Note: The option to remove acknowledgments for all messages is available only for historical queries. It is not available for real-time incoming messages.

To remove message acknowledgments:

  1. Start the Message Browser:

    1. Start the Log Central Console by running lc_launch on the central host.

      For detailed information about starting the Console, see Introducing the Log Central Console. For the lc_launch command syntax, see Commands.

    2. Click Msg Browser. Log Central displays the Message Browser.

  2. Select Online Monitoring or Historical Query.

  3. Click Start.

    If you selected Online Monitoring, the Log Central Console monitors log messages in real time as they arrive at the Central Collector. If you selected Historical Query, the Log Central Console queries the Log Central database.

    The Message Browser displays messages that satisfy the filter settings you defined in the Filter Settings window, with the most recent message displayed at the top of the message pane. For information about the filter settings, see Filtering Log Messages.

  4. Click Stop.

  5. If you are not going to remove acknowledgments for all messages, select the desired messages.

  6. From the Actions menu, choose Clear Acknowledgment.

    A submenu lets you remove the acknowledgments from the selected messages or all messages that were returned in the last database query.

Viewing Log Message Definitions

To view the message definition fields associated with a message:

  1. Start the Message Browser:

    1. Start the Log Central Console by running lc_launch on the central host.

      For detailed information about starting the Console, see Introducing the Log Central Console. For the lc_launch command syntax, see Commands.

    2. Click Msg Browser. Log Central displays the Message Browser.

  2. Select Online Monitoring or Historical Query.

  3. Click Start.

    If you selected Online Monitoring, the Log Central Console monitors log messages in real time as they arrive at the Central Collector. If you selected Historical Query, the Log Central Console queries the Log Central database.

    The Message Browser displays messages that satisfy the filter settings you defined in the Filter Settings window, with the most recent message displayed at the top of the message pane. For information about the filter settings, see Filtering Log Messages.

  4. Click Stop.

  5. Select a message.

  6. From the View menu, choose Message Details.

    The Message Browser displays the Message Details window. This window displays the message body and the message definition fields.

To change a message definition, see Changing Message Definitions and Subsystem Descriptions.

prevnext

 

Copyright © 2000 BEA Systems, Inc. All rights reserved.
Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.