Skip Headers
Oracle® Fusion Middleware Administrator's Guide for Oracle SOA Suite and Oracle Business Process Management Suite
11g Release 1 (11.1.1.4.0)

Part Number E10226-07
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

26 Monitoring Oracle User Messaging Service

This chapter describes how to monitor Oracle User Messaging Service using Oracle Enterprise Manager Fusion Middleware Control.

This chapter includes the following topics:

26.1 Monitoring Oracle User Messaging Service

You can monitor Oracle User Messaging Service logs and metrics using Oracle Enterprise Manager Fusion Middleware Control.

To monitor Oracle User Messaging Service:

  1. Go to the Oracle Enterprise Manager Fusion Middleware Control page for your SOA farm.

    Description of ns_login.gif follows
    Description of the illustration ns_login.gif

  2. Select Fusion Middleware > SOA > User Messaging Service.

  3. Select the server or driver of your choice.

    If you select a driver, quick statistics are displayed that indicate the state and performance of the driver.

    If you select a server, you see a list of associated drivers, in addition to the quick statistics. You can select one of the drivers to view its statistics, or you can click the Configure Driver icon to configure it. For more information on configuring drivers, see Chapter 25, "Configuring Oracle User Messaging Service."

    Description of ns_configdrv.gif follows
    Description of the illustration ns_configdrv.gif

  4. Right-click on the server to select an action.

    this graphic shows the menu resulting from right-clicking
    Selection Action
    Home The Home page lists the quick statistics for the selected driver.
    Control Start Up or Shut Down driver.
    Logs View and configure message logs for the selected driver.
    Performance Summary Displays Performance Statistics on a customizable metrics page. Use this page to view statistics for this driver. Customize this page using the Metric Palette. The Metric Palette enables you to choose from all of the available metrics so that you see only the information that is most valuable to you.
    Message Status Check the delivery status of messages sent and received, and resend selected messages. You can filter the search by adding more search fields and setting the desired operator and search value. Some fields can be added multiple times in order to use them with different and complementary operators, or with the Contains operator.
    Messaging Client Applications Messaging client applications registered with the User Messaging Service can be manually de-registered in cases where the applications have been undeployed and are holding onto access points that must be made available to other applications.
    Server Properties Configure message storage method and business terms for message filter creation. See Chapter 25, "Configuring Oracle User Messaging Service" for more information.
    System MBean Browser System MBean Browser the System MBeans and their configuration settings.
    General Information General Information displays the name, version, Oracle Home, and host for the selected driver. General driver information
    Description of the illustration ns_geninfo.gif

26.1.1 Using Message Status

You can check the delivery status of messages sent and received, and resend selected messages.

To check message status:

  1. In the navigation tree, right-click the UMS target for which you want to view message status.

  2. Select Message Status. The Message Status page appears.

  3. Click Search to search the messages using the default criteria. The search returns a listing for the messages.

Description of ns_msgstatus.gif follows
Description of the illustration ns_msgstatus.gif

You can customize the search by adding more search fields and setting the desired operator and search value. Some fields can be added multiple times in order to use them with different and complementary operators, or with the Contains operator. To customize the search:

  1. Click Add Fields.

  2. Select the field(s) on which you want to search.

  3. Choose operators and fill in variables as needed.

  4. Click Search. The customized search is done and results returned.

    Description of ns_msgcust.gif follows
    Description of the illustration ns_msgcust.gif

  5. If you want to resend a message, select the message in the list and click Resend.

26.1.2 Deregistering Messaging Client Applications

You can manually deregister Messaging Client Applications after the applications have been undeployed and are holding onto access points that must be made available to other applications. To deregister Messaging Client Applications:

  1. Right-click a target in the navigation tree, and select Messaging Client. The Messaging Client page appears.

  2. Select the message that you want to deregister.

  3. Click De-register.

    Description of ns_mca.gif follows
    Description of the illustration ns_mca.gif

    A confirmation box appears asking you to confirm your choice.

  4. Confirm your choice.

26.1.3 Monitoring Drivers Using the All Tab

The All tab only lists successfully-registered drivers in the domain (not all drivers that exist).

Since the drivers are not configured out-of-the-box, they are not registered unless you configure them. To ensure that you see all of the drivers in the All tab, configure the SMPP, VoiceXML and XMPP drivers (if you plan to use them). Once configured, they are registered with the engine and are displayed in the All tab.

26.2 Viewing Log Files

You can view log files.

To view log files:

  1. Right-click the driver (or server) for which you want to view log information, then choose Logs > View Log Files.

    The Log Messages page appears.

    Description of ns_logme.gif follows
    Description of the illustration ns_logme.gif

    Use this page to query for log information about a driver (or server). Fields and lists are used to customize the query.

  2. After entering your search criteria, click Log Files. The Log Files page appears.

    Description of ns_five.gif follows
    Description of the illustration ns_five.gif

  3. View log information or download the log.

26.2.1 Configuring Logging

Use Oracle Enterprise Manager Fusion Middleware Control to configure log levels, as shown in Figure 26-1.

Figure 26-1 Configuring Log Levels

Description of Figure 26-1 follows
Description of "Figure 26-1 Configuring Log Levels"

For each logger, set the notification level, as shown in Figure 26-2.

Figure 26-2 Select Notification Level

Description of Figure 26-2 follows
Description of "Figure 26-2 Select Notification Level"

As a result of your configuration actions, notifications appear according to your specification. Figure 26-3 and Figure 26-4 provides details.

Figure 26-3 Viewing Log Files

Description of Figure 26-3 follows
Description of "Figure 26-3 Viewing Log Files"

Figure 26-4 Error Messages

Description of Figure 26-4 follows
Description of "Figure 26-4 Error Messages"

26.3 Viewing Metrics and Statistics

The performance of your applications is reflected in metrics and statistics.

To view metrics and statistics:

  1. Select the Performance Summary for a driver (or server).

    The Performance Summary page appears.

    Description of ns_fourteen.gif follows
    Description of the illustration ns_fourteen.gif

    Many metrics are available for capture and display. To get the most valuable, focused information, use Metric Palette.

  2. Click Show Metric Palette to display the Metric Palette.

  3. Choose the metrics in which you are most interested. As you select or deselect metrics from the palette, the metrics display is automatically updated.

Description of ns_fifteen.gif follows
Description of the illustration ns_fifteen.gif