Job Management Partner 1/Performance Management User's Guide

[Contents][Glossary][Index][Back][Next]

7.2.1 Displaying the event history

To check the information on the previous events that occurred in the Performance Management system:

  1. From the monitoring console browser, log on to PFM - Web Console.
    The main window appears.

  2. In the navigation frame of the main window, select the Agents tab.
    The Agents window appears.

  3. In the navigation frame of the Agents window, select the agent whose event history you want to display.
    When you want to select multiple agents, select Multiselect.
    The selected agents are marked with checkmarks.

    Reference note:
    If you do not select an agent, the histories of events that occurred in all the agents are displayed.

  4. In the method frame of the Agents window, select the Event History method.
    The Event History window (Show Options tab's window) appears as a separate window.

    Figure 7-5 Example of the Event History window (Show Options tab)

    [Figure]

  5. Set the individual items in Settings for the report display period.
    Set display conditions for the following items, if necessary:

    Date range
    When you set the date range for the data you want to display as an event history, select the appropriate date range from the Date range pull-down menu.
    The selectable values are as follows:
    - Specify when displayed
    - Within the past hour
    - Within the past 24 hours
    - Within the past 7 days
    - Within the past month
    - Within the past year
    The default is Within the past 24 hours.
    When you select something other than Specify when displayed, the dates and times corresponding to the Start time and End time are automatically set.

    Start time and End time
    When you select Specify when displayed in Date range, set the Start time and End time of the date range for displaying the event.
    You should specify the Start time and End time in a display format corresponding to the locale.
    For details, see the chapter that describes installation and setup in the Job Management Partner 1/Performance Management Planning and Configuration Guide.
    The range of dates and times you can specify is from 1971/01/01 00:00 to 2035/12/31 23:59. For the End time, specify a date and time after the Start time you specified.
    Note that when you select something other than Specify when displayed, the appropriate date and time is automatically set. Additionally, if you change the date and time that are automatically displayed, settings for the Date range change to Specify when displayed.

  6. Set the Maximum number of records.
    Set the display conditions for the following items, if necessary:

    Maximum number of records
    The maximum number of events to be displayed as an event history in the Report tab's window can be an integer from 1 to 1440. The default is 1000.
    However, you can specify the maximum number of records (maxFetchCount) from 1 to 2,147,483,647 in the initialization settings file (config.xml) of PFM - Web Console. In this case, you can specify the maximum number of records within the range of values you specified in the config.xml file.

  7. Set the individual items in Filter.
    Set the display conditions for the following items, if necessary:

    Alarm Name
    An alarm name of an event to be displayed can be any number of characters up to 2,048 bytes. Specifying an alarm name in this item enables an event at which the alarm occurred to be displayed.
    By default, an asterisk (a wildcard character) is used.

    Alarm Table
    An alarm table name of an event to be displayed can be any number of characters up to 2,048 bytes. Specifying an alarm table name in this item enables you to display events that occurred and that are for alarms of the alarm table.
    By default, an asterisk (a wildcard character) is used.

    Message
    The message text of an event can be displayed using no more than 2,048 bytes. Specifying message text in this item enables you to display events that output the message text.
    By default, an asterisk (a wildcard character) is used.

  8. Click the OK button.
    The Event History window (Report tab's window) appears.

    Figure 7-6 Example of the Event History window

    [Figure]

    The following table describes the display items of the Event History window.

    Table 7-2 Display items of the Event History window

    Display Items Description
    Date and Time Displays the system's date and time of the agent host, which is the source of the event occurrence, in the format corresponding to the locale. For details, see the chapter describing installation and setup in the Job Management Partner 1/Performance Management Planning and Configuration Guide.
    Agent Service ID of the agent that is the source of the event occurrence.
    Host Operating host name of the agent that is the source of the event occurrence.
    StateEx The meanings of the statuses are as follows:
    For agent events and alarm events:
    • OK: Normal
    • Exception: Abnormal
    • Warning: Warning
    • Inactive: Not started or an unknown status

    For health check events:
    • Not Supported: The agent does not support the health check function.
    • Running: The services on the agent are working normally.
    • Incomplete: Some functionality on the agent is unavailable.
    • Stopped: The service on the agent has stopped.
    • Unconfirmed: The health check function cannot confirm the status of the host.
    • Host Not Available: The host is stopped.
    Alarm Name The alarm names in the source of the event occurrence.
    Alarm Table The alarm table names in the source of the event occurrence.
    Message

    For an agent event:
    Displays messages output from an agent.
    The main messages to be displayed are as follows:
    - Startup: PFM - Agent or PFM - RM has started.
    - Shutdown: PFM - Agent or PFM - RM has stopped.
    - State change: The status of PFM - Agent or PFM - RM has changed.
    - Heartbeat timeout: The Agent Collector or Remote Monitor Collector service has changed to the busy or stop status.
    - Heartbeat detected: The Agent Collector or Remote Monitor Collector service has recovered from the busy or stop status.
    In addition to the above, messages starting with KAV might be displayed.
    When Heartbeat timeout is displayed, check the status of PFM - Agent or PFM - RM. If a message starting with KAV appears, see the chapter describing messages in the appropriate PFM - Agent or PFM - RM manual. When other messages are displayed, no actions are needed, because there are no such messages that indicate abnormality.

    For an alarm event:
    Displays the message text set in the alarm wizard.
    The main messages to be displayed are as follows:
    - Alarm updated/deleted: The alarm definition has been updated or deleted.
    - Alarm deactivated: The alarm has changed to the inactive state.
    - Alarm cleared: The alarm was unbound.
    - Alarm expired: The current time exceeded the alarm evaluation time range.
    - Heartbeat timeout: The Agent Collector or Remote Monitor Collector service has changed to the busy or stop status.
    - Heartbeat detected: The Agent Collector or Remote Monitor Collector service has recovered from the busy or stop status.

    For a health check event:
    Displays the message text in the format HC: health-check-status.
    This area also displays message text describing the status of the agent, followed by the status of the service. For details on message display rules and examples, see the appendix describing data models in the Job Management Partner 1/Performance Management Planning and Configuration Guide.
    Multi-instance records operate as follows:
    • When any of the values in a warning or abnormal condition is detected in a target instance:
      The user-defined message set in the message text in an alarm definition is displayed. Additionally, the instance value for which a value over the threshold was detected is displayed if the measured value of the performance data in set in the message text.
    • When conditions return to normal from abnormal or warning:
      Nothing is specified in the message text even though normal events are issued, because all the instance values become normal and the value that caused the event to occur is not determined.

  9. Click the Close menu in the upper-right corner of the window to close the window.
    The Event History window closes.

Supplemental information:
  • If no displayable event exists, a message indicating this is displayed.
  • The display conditions set in this operation are available only while the Event History window is being displayed, and the settings are not saved.

Reference note:
If the number of records exceeds the maximum number of records, the records from the oldest one to the maximum number of records are displayed.

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.