Using System Manager to monitor the system
You can use the InterChange Server Component Management
view in System Manager to monitor the IBM WebSphere Business Integration
Server Express system and to get informational messages for all
component status changes in the system. You also can start, stop,
pause, and shut down InterChange Server Express components and change
component properties from this view. For instructions on starting,
stopping, and pausing components or on changing component properties,
see Administering components
of the system.
The following section describes how to work in System Manager
to connect to an InterChange Server Express instance and to view
component statistics from the InterChange Server Component Management
view. To use the InterChange Server Component Management view in
System Manager, you must first connect to an InterChange Server
Express instance.
Steps for connecting to an InterChange
Server Express instance
Perform the following steps to connect to an InterChange
Server Express instance.
- Open System Manager.
- In the InterChange Server Component Management view, right-click
the InterChange Server Express instance to which you want to connect,
and click Connect on the pop-up menu (see Figure 16).
Note:
You must register the default server first. For
Windows and Linux, the default server is WebSphereICS and for OS/400
and i5/OS, the default server is QWBIDFT44.
Figure 16. Connect to InterChange Server Express
- Enter the following information in the Login dialog box that
appears:
- In the User Name field, type or select
the user name for the server.
- In the Password field, type the password
for the server.
- Click OK.
When a connection is made, the light on the InterChange Server Express instance icon
changes from red to green, and any objects that have been deployed
to that server appear in folders beneath the server (see Figure 17).
Figure 17. InterChange Server Component Management view, showing connection to InterChange Server Express
Viewing and using
statistics
You can monitor statistics for the InterChange Server
Express environment in the InterChange Server Component Management
view to help you better manage the system. Statistics can be viewed
for InterChange Server Express, collaboration objects, and connectors.
By watching and becoming familiar with your system's
normal operating statistics, when problems occur, you can use the
monitors to identify and isolate problems, and pinpoint problems
in flow processing.
Monitoring your system's statistics can help you to
optimally configure your system's resources. The statistics
windows show currently configured parameters and provide graphs
that track resources during flow processing. You can easily see
if your system resources are used efficiently or if they need to
be adjusted. The following procedures describe how to use the Server
Statistics window, the Collaboration Object Statistics window, and
the Connector Statistics window:
Note:
Before you can see any system statistics, System
Manager must be connected to an InterChange Server Express instance.
For instructions on connecting to an InterChange Server Express
instance, see
Steps for connecting to an InterChange
Server Express instance.
Steps
for viewing server statistics
Perform the following steps to check InterChange Server
Express statistics:
- Open System Manager and go to the InterChange Server Component
Management view.
- Right-click the InterChange Server Express instance and click Statistics.
The server statistics appear (see Figure 18).
Figure 18. Statistics window for InterChange Server Express
- Under Database Connections you can view
the following information:
- Find out how many database connections the InterChange Server
Express system's connection cache is currently using and
the peak amount used since the server was booted. This can help
you tune the interaction with the underlying Database server for
InterChange Server Express. By using the parameters in the InterchangeSystem.cfg file and the respective underlying database server's
.cfg files, you can configure the optimal number of connections.
- Look for the connection pool that is consuming the most number
of connections. This can help you configure InterChange Server Express
to meet the maximum database connections constraint or increase
the maximum number of connections for this pool.
- The database parameters contained in the DB_CONNECTIVITY section of the InterchangeSystem.cfg file govern the overall interactions between InterChange
Server Express and the database management system (DBMS). For information
about these parameters, see the WebSphere Business Integration Server
Express installation guide for Windows, for Linux, or for OS/400
and i5/OS.
The Database connections area shows statistics for:
- Cache max
configured
- The maximum number of connections configured. This is the
value the attribute MAX_CONNECTIONS. If this attribute is not configured,
it displays Default.
- Cache in use
- The current number of connections used from the connection
cache.
- Cache peak
- The maximum number of connections used by the server from
its connection cache since the server was booted.
The area below the cache statistics lists the system and dynamic
connection pools. The system pools are REPOSITORY, EVENTS_MANAGEMENT, FLOW_MONITORING, USER_REGISTRY and TRANSACTIONS. The dynamic pool is the Relationship pool. The following
details for each of these pools are maintained:
- Free
- The current number of available connections in the connection
pool.
- In use
- The current number of connections used by this connection
pool.
- Max Configured
- The maximum number of connections configured. This is the
value in the InterchangeSystem.cfg file for the attribute MAX_CONNECTIONS in the respective
subsections of the different connection pools (Event Management,
Transactions, Repository). If this attribute is not configured,
it displays Default.
- Peak
- The highest number of connections used by the server from
this pool since the server was booted.
- Under Depth of Message Queues, you can
view a list of all the subscription queues in the configured queue
manager. The following statistics are displayed:
- Queue Name
- The name of the subscription queue.
- Current
- The number of messages currently in the queue. This does not
include subscriptions messages that are in the work-in-progress
(WIP) queue.
- Max Configured
- The maximum number of physical messages that can exist on
the queue.
Steps for viewing collaboration object
statistics
Perform the following steps to check collaboration object
statistics:
- Open System Manager and go to the InterChange Server Component
Management view.
- Expand the Collaboration Objects folder.
- Right-click the collaboration object for which you want to view
statistics and click Statistics.
The statistics for that collaboration object appear (see Figure 19).
Figure 19. Statistics window for collaboration objects
Note:
Statistics for a collaboration group, as a whole,
are not maintained. Each collaboration member in a collaboration
group maintains its own statistics. The statistics among group members
may differ.
- Check the Failed flows statistic for an
increase in the normal failure rate. A failure can be caused by several
situations, including the unavailability of a connector, corrupt
data, and so forth. This number should be kept as low as possible,
because some user intervention is needed to resubmit the failures.
This count is retained when the collaboration is paused, and it
is reset when the collaboration is stopped.
- To view general statistics, do the following in the top section
of the statistics window:
- You can quickly see when the collaboration object was started,
how long it has been running, the number of access calls from Web-based
servlets, the number of successful and failed flows, and the total
number of flows that have been processed.
- The Maximum number of concurrent events reflects the maximum
number of concurrent processes of event-triggered flows. For detailed
information about concurrent flows, see the System Implementation Guide
- Under Flow Status, you can do the following:
- Use this area to search for flows taking longer than the specified
time. It can help you recognize and get details about these flows
such as their FlowEventID and related application.
- Enter a duration using the minutes/hours selectors to list flows
whose processing time exceeds this number. The Details button
provides additional information about these flows such as FlowInitiatorID,
associated connector, business object, and application.
- Under Flow Control, you can do the following:
- This section displays the number of buffered events and the
number of events pending in the database. It also displays two configurable
Flow Control properties: Max Event Capacity and Blocked Status.
- Use this section to monitor the Flow Control of the collaboration
object and to determine if you need to reconfigure the Flow Control
properties of the collaboration object. For instructions on reconfiguring
Flow Control properties, see Steps for configuring flow control for
collaboration objects
- At the bottom of the statistics window, you can do the following:
- Use the In Progress, Queued,
and Current rate areas to monitor the number
of flows that are queued, the number that are currently processing,
and the rate at which the flows are processed.
- Use the number of the Mean service time during
normal processing as a base to determine if processing rates are
increasing. During normal system operation, this number should be
fairly constant. A noticeable increase might reflect a problem such
as a network or application slowdown or other situation that needs
to be resolved.
- Use the queued events statistic to help tune the collaboration
for concurrent flow processing, if necessary. If the installation
consistently shows long queues, an option is to increase the number
of concurrent event-triggered flows for the collaboration and restart
the collaboration. Increasing the number of concurrent flows increases
the system process size and may require additional database connections.
Steps
for viewing connector statistics
Perform the following steps to check connector statistics:
- Open System Manager and go to the InterChange Server Component
Management view.
- Expand the Connectors folder.
- Right-click the connector for which you want to view statistics
and click Statistics.
The statistics for that connector appear (see Figure 20). The window for provides information about the running
connector: the connector's application, when the connector
was started, how long it has been running, the number of business
objects it has received and sent, and flow control information.
Figure 20. Statistics for connectors
- Under Time, you can view the start time
of the connector and how long is has been running.
- Under Business Objects, you can view the
total number of business objects received and sent during the time
the connector has been running.
- Under Business Objects Sent and Received,
you can view the names of the business objects that the connector
has sent and received. If the number of business objects sent does
not match the number received, some business objects might not have
been processed completely.
- Under Subscriptions, you can view a list
of subscriptions the collaboration subscribes to and the business
object name and verb for that subscription. Check the list of subscriptions
to verify that the names of the collaborations and initiators are
all present and that they are supposed to be there.
- Under Flow Control, you can view the number
of buffered events and the number of events pending in the database.
Two configurable Flow Control properties are listed: Max Event Capacity and Blocked Status.
Use this section to monitor the flow control of the connector and
to determine if you need to reconfigure the flow control properties
of the connector. For instructions on reconfiguring flow control properties,
see Steps for configuring flow control for
connectors.
