Setting up System Monitor

Before you begin using System Monitor, you must have the required web servers, client browsers, and other software installed on your system.

You also must decide whether you want to use the default monitors provided with System Monitor or if you want to create additional monitors using the Monitor Definition wizard. For example, you might want a monitor called System Overview, which displays status and start time of all system components. You create this monitor using the Monitor Definition Wizard, a tool opened from System Manager.

Requirements for System Monitor

System Monitor requires the following software, listed in Table 1:


Table 1. Required software for System Monitor
Supported Web servers Software required on Web server Supported browsers

A Web application server which supports JSP versions 1.1 or later, and servlets versions 2.2 or later, such as IBM WebSphere Application Server versions 5.0.2 with fixpack 4 or 5.1, IBM WebSphere Application Server versions 5.0.2 with fixpack 4 or 5.1, or Tomcat versions 4.1.24 or 4.1.27 (using IBM JDK 1.4.2)

DB2 Client (if using DB2 for repository database)

  • Microsoft Internet Explorer 5.5 SP2 or higher, with Adobe SVG Viewer 3.0 plug-in
  • Netscape 4.7x (only), with Adobe SVG Viewer 3.0 plug-in (on a Windows 2000 or Windows XP operating system only)

Steps for reviewing default monitors

Refer to Table 2 below for information you can use to determine if you want to use the default monitors included with the System Monitor.

Note:
Table 3 contains a description of the display options listed in Table 2. The section entitled Examples of display options contains samples of the display options listed in Table 2.


Table 2. Default monitors
Default monitor Definition Display options Available operations when viewing monitor
System Overview Overview of the current status of all major components of the system: collaborations, connectors, maps, and relationships Table tree (a table with expandable nodes in the first column that display more rows)
  • Start, stop, pause, and shut down a collaboration
  • Start, stop, pause, and shut down a connector
  • Restart a connector agent
  • Start and stop a map
  • Start and stop a relationship

Collaboration Statistics Current status and statistics of all collaborations in the system:
  • Status
  • Start time
  • Total flows
  • Successful flows
  • Failed flows
  • Events in process
  • Queued events
  • Max concurrent events
Table
  • Start, stop, pause, and shut down

Connector Statistics Current status and statistics of all connectors:
  • Status
  • Start time
  • Total up time
  • Business objects received
  • Business objects sent
  • Agent status
Table
  • Start, stop, pause, and shut down
  • Restart connector agent

Map Status Status of all maps Table Start and stop
Relationship Status Status of all relationships Table Start and stop
Server Statistics Current statistics of the server: the number of failed and successful calls, events, and flows Stacked bar None
Database Connections Current status of database connections:
  • Number of free connections
  • Number of active connections
  • Maximum number of connections
  • Peak number of connections
Table None
Message Queues Current status of message queues:
  • Current depth
  • Maximum depth configured
Table None
Business Objects Current statistics of the business objects for a particular connector: business objects sent and business objects received Table None
Connector Subscriptions Current statistics of the subscriptions for a particular connector:
  • Collaboration object
  • Initiator
Table None
Collaboration Events Current statistics of collaboration events, which includes the following information:
  • Events in process
  • Queued events
Bar None
Historical Server Statistics Server statistics for a specific period of time. Statistical information:
  • Successful calls
  • Failed calls
  • Total calls
  • Successful events
  • Failed events
  • Total events
  • Successful flows
  • Failed flows
  • Total flows

Time intervals:

  • Start date
  • End date
Bar None
Historical Server Flows Flow statistics of the server for a specific period of time at certain time intervals. Statistical information:
  • Successful flows
  • Failed flows
  • Total flows

Time intervals:

  • 15 min., 30 min., hourly, daily, weekly, or monthly
  • Start date
  • End date
  • Line
  • Stacked
    bar
  • Bar

None
Historical Collaboration Flows Stack Flow statistics of a particular collaboration for a specific period of time at certain time intervals. Statistics information:
  • Successful flows
  • Failed flows
  • Total flows

Time intervals:

  • 15 min., 30 min., hourly, 4 hours, 12 hours, daily, weekly, or monthly
  • Start date
  • End date
Stacked bar None
Historical Collaboration Flows Line Flow statistics of a particular collaboration for a specific period of time at certain time intervals. Statistics information:
  • Successful flows
  • Failed flows
  • Total flows

Time intervals:

  • 15 min., 30 min., hourly, 4 hours, 12 hours, daily, weekly, or monthly
  • Start date
  • End date
Line None
Event Rate Current number of processed events per minute Meter None
Flow Control Current state of collaboration objects and connectors under Flow Control:
  • Buffered events
  • Max event capacity
  • Blocked status (does not apply to non-blocking collaboration)
  • Events pending in database (applies only to non-blocking collaborations)
  • Saturated status
Table None
State Change Log Current persisted state changes on a component for a specified time period. State change information:
  • Time stamp
  • State

Time intervals:

  • Start date
  • End date
Table None

Steps for creating additional monitors

Before you begin creating additional monitors, review the existing default monitors in Table 2, to see if the monitor you want to create already exists.

Perform the following steps to create a monitor:

  1. Open System Manager.
  2. In the InterChange Server Component Management view, right-click the server instance to which you want to connect, then click Connect. The Server User ID and Password dialog box appears.
  3. Type the User ID and password for that server, then click OK. The status of the server changes from unknown or disconnected to connected.
    Note:
    If the status does not change to connected, make sure the selected InterChange Server instance is running.
  4. Right-click the server instance, then click Monitor Definition Wizard. The Monitor Definition Wizard appears. See Figure 1.

    Figure 1. Monitor Definition Wizard, page for selecting information type and display option

    The figure shows the first screen in the Monitor Definition Wizard, where you can select your information types and display options. The left side of the screen shows the available information types, for example, System Overview, Collaboration Statistics and Map Status, while the right side of the screen shows the display options, for example, Table, Table Tree, or Stacked Bars.

  5. Select the type of information you want in the monitor from the Information Types list, and select how you want the information displayed under Displayed Option(s).

    Each information type has one or more available display options, and each display option has configurable properties. When you select an information type, only the display options for that information type are available under Displayed Option(s). For a description of the configurable properties of each display option, see Steps for using monitor display options, and for examples of how the display options appear in System Monitor, see Examples of display options.

    Note:
    If business object probes exist, they appear in the Information Types list. For instructions on adding business object probes, refer to the Collaboration Development Guide.
  6. Click Next. The Specify Monitor Properties page appears (see Figure 2).

    Figure 2. Monitor Definition Wizard, Specify Monitor Properties page

    The figure shows the second screen in the Monitor Definition Wizard, where you can specify monitor properties. The top of the screen shows allows you to name the monitor and enter an optional description. The remainder of the screen allows you to select the layout of your table, for instance, setting the number of rows for your monitor table, selecting the table column attributes and ordering the attributes.

  7. Add the following information on the Specify Monitor Properties page:
  8. Do one of the following:

    Figure 3. Monitor Definition Wizard, Specify Attribute Thresholds screen

    The figure shows the last screen in the Monitor Definition Wizard, where you can specify attribute thresholds. On this screen you can specify the number of buffered events, events pending in the database and the maximum event capacity.

Steps for using monitor display options

Perform this step to use display options for monitors you are creating with the Monitor Definition Wizard or using monitors in System Monitor:

Refer to Table 3 to determine ways you can configure display options when creating monitors in Monitor Definition Wizard, or when you are using the monitors in System Monitor. (For examples of the display options, see Examples of display options.)

Table 3. Configurable display options for monitors
Display option Properties you can configure when building monitors in Monitor Definition Wizard Properties you can configure when using monitors in System Monitor
  • Table
  • Table tree

  • Columns to display
  • Order of columns
  • Number of rows to display

  • Font and color settings of the labels and data
  • Number of rows to display

  • Stacked bar
  • Line
  • Bar

None
  • Font and color settings of the labels and data
  • Show or hide values

Meter Meter threshold Font and color settings of the labels and data

Examples of display options

The following exemplify the display options you can select when creating monitors in the Monitor Definition Wizard and how they appear in System Monitor:

Note:
The data in the examples is not indicative of actual data in an InterChange Server system.

Figure 4. Table display option

The figure shows a table display, with the connector name, the status of the connector, the start up time, the total time the connector has been running, the number of business objects received and sent by the connector, and the agent status.

Figure 5. Table tree display option

The figure shows a table tree display, listing the component name, the component type, the component status, the component start time, and the total time the component has been running.

Figure 6. Line display option

The figure shows an example of a line display, with a left axis that shows the total amount in integer format, and the bottom axis, which shows various system items, for example, calls or events. A diagonal line charts the rise and fall of the information being charted.

Figure 7. Bar display option

The figure shows an example of a bar display. Each bar in the chart represents a unique piece of information, and the height of the bar is determined by the informational value.

Figure 8. Stacked bar display option

The figure shows an example of a stacked bar display, with like information grouped together on top of each other to make composite bar displays.

Figure 9. Meter display option

The figure shows an example of a meter display, where information displays in a metered format, much like a speedometer.

Copyright IBM Corp. 1997, 2004