Monitoring

In this section:

How to:

iWay Service Monitor enables process visibility, auditability, identification, and dependency management of all services deployed in iWay Service Manager. With this component, iWay implements SOA runtime governance and extends the monitoring/management concept to all iWay services, message services, and business services. The settings on this page are only valid when IWay Service Monitor is enabled.

Note: When monitoring is disabled, the monitor settings automatically revert to their default values.
Top of page
x
Enabling iWay Service Monitor

While iWay Service Monitor can be automatically configured to manage and monitor services, the following procedure is used to manually configure monitoring of services running on iWay Service Manager. For information on automatic monitoring, see Setting Up iWay Service Monitor.
x
Procedure: How to Enable iWay Service Monitor

To enable iWay Service Monitor:

  1. In the Settings section, select the On check box for the Enable Monitor option.

    Note: To enable the automatic discovery of services, select the On check box for the Enable Discovery option.

  2. In the Connection section, configure the IWay Service Monitor instance that will be used to monitor your iWay Server by entering:
    Host

    The host name or IP address of the IWay Service Monitor instance that will monitor this configuration.

    Observer

    The port number of the IWay Service Monitor instance that will receive observations about this configuration.

    Console

    The port number of the IWay Service Monitor console.

  3. Click Update to save your settings.
  4. After these parameters are configured and saved, click Go to access the IWay Service Monitor console.
Top of page
x
Differences Between Discovery and Monitoring Options

The Enable Discovery option is used to register a WSDL document with AmberPoint so that it can be managed. The Enable Monitor option is used to send copies of request and response messages to AmberPoint so that statistics on a particular service can be gathered. In previous releases, these two functions were merged. They are now separate functions and can be selected independently on the iWay Service Monitor page. This enables better Proxy abilities in AmberPoint.
x
Procedure: How to Configure Channel Monitoring

To configure channel monitoring:

  1. In the left pane of the Server section, select Activity Facility.

    The Activity Facility page opens.

  2. Click Add.

    The Activity Facility configuration page opens.

  3. From the Type drop-down list, select Channel Logger.
  4. In the Name field, type a unique name.
  5. From the Active drop-down list, select Active (default).
  6. Click Update.
  7. Click Tools in the menu bar and select iWay Service Monitor from the left pane.

    The iWay Service Monitor page opens.

  8. Select the Enable Monitor check box.
  9. In the Host field, enter the location to the AmberPoint server.
  10. Click Update.
  11. Click Deployments in the menu bar and deploy a channel you want to monitor.

    Note: A channel that is already deployed can not be monitored unless it is redeployed.

  12. Start processing messages.
  13. Check AmberPoint for the channel you are monitoring and check to see if messages are being logged.

    For additional diagnostic information, go to the Deployments section to see all the deployed channels and their WSDLs.
Top of page
x
Adding an External Page Portlet Using the AmberPoint Management Console to Deploy Up and Down Channels

A custom Web page that provides the description, listener type, and start/stop management of the monitored channel is available. It is hosted on iWay Service Manager but must be added to the AmberPoint Management Console as an external page portlet. This page is not accessible from the iWay Service Manager Administration Console. To access this page in a browser, use the following URL:

http://host:port/ism/apchannels?configuration=configname

where:

host

Is the host machine where iWay Service Manager is installed. The default value is localhost.

port

Is the port where iWay Service Manager is listening. The default port is 9999.

configname

Is the name of the iWay Service Manager configuration you are using. The default configuration is base.
Top of page
x
Procedure: How to Add an External Page Portlet

To add an external page portlet using the AmberPoint Management Console to deploy up and down channels:

  1. Start the AmberPoint Environment Monitor and access the AmberPoint Management Console.

    The AmberPoint Management Console logon page opens.

  2. Enter a valid user name and password in the corresponding fields and click Log in.

    The main page of the AmberPoint Management Console opens, as shown in the following image.

  3. Click the Add Portlet button and select External Page Portlet from the context menu.

    The Add External Page Portlet pane opens, as shown in the following image.

  4. Enter a name for the external page portlet in the Portlet Title field, for example, Up/Down Channels.
  5. Enter a brief description for the external page portlet in the Description field (optional).
  6. Enter the following URL in the Page URL field: 
    http://host:port/ism/apchannels?configuration=configname

    where:

    host

    Is the host machine where iWay Service Manager is installed. The default value is localhost.

    port

    Is the port where iWay Service Manager is listening. The default port is 9999.

    configname

    Is the name of the iWay Service Manager configuration you are using. The default configuration is base.

  7. Click Apply.

    The external page portlet is now available in the AmberPoint Management Console.

iWay Software