1. Administering Oracle User Messaging Service
  2. Monitoring Oracle User Messaging Service

5 Monitoring Oracle User Messaging Service

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

Monitoring Oracle User Messaging Service

You can monitor UMS logs and metrics using Oracle Enterprise Manager Fusion Middleware Control.

To monitor UMS:

  1. Log in to Oracle Enterprise Manager Fusion Middleware Control as an administrator.

  2. Expand the User Messaging Service folder. You will see a User Messaging server, and a list of User Messaging drivers.

  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 Configuring Oracle User Messaging Service.

  4. You can perform a series of actions on the server. Right-click the server to select any of the actions. Table 5-1 lists the selection and their resultant actions.

    Table 5-1 Server Selection and Actions

    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 to use them with different and complementary operators, or with the Contains operator

    Messaging Client Applications

    Messaging client applications registered with UMS can be manually deregistered 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. For more information, see Configuring Oracle User Messaging Service.

    System MBean Browser

    System MBean Browser and its configuration settings

    Target Information

    Target Information displays the version, Middleware Home, Domain Home, Host and Deployed On details for the selected driver

Parent topic: Monitoring Oracle User Messaging Service

Using Message Status

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

Checking message status

To check message status, perform the following tasks:

  1. From the navigation tree, navigate to the server page. On the server page, select Message Status from the drop-down list that appears at the top of the page.

    The Message Status page appears.

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

Customizing the Search

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 to use them with different and complementary operators, or with the Contains operator. To customize the search, perform the following tasks:

  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.

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

Deleting Messages

You can delete selected messages or delete messages in bulk by setting the option for deleting all messages older than a specific date.

  • To delete a selected message, select the message in the list and click Delete Selected.

  • To delete all messages older than a specific date, click Delete with Options. In the pop-up window that appears, you must specify a date that is older than 7 days, and click OK. All messages before the specified date will be deleted.

Note:

If you choose to delete messages using the date feature in the EM UI, ensure that you do not have more than 2000 messages to be deleted at any given time. If there are more than 2000 messages to be deleted, you will see the following error message:

The specified options result in the deletion of more than 2000 messages. Please narrow your query and try again.

To delete more than 2000 messages, you must use the DB purge script for Oracle database.

Parent topic: Monitoring Oracle User Messaging Service

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, perform the following tasks:

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

  2. Select the message to deregister and click De-register.

    A confirmation box appears asking you to confirm. Confirm your choice.

Parent topic: Monitoring Oracle User Messaging Service

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.

    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.

  3. View log information or download the log.

Parent topic: Monitoring Oracle User Messaging Service

Configuring Logging

Use Oracle Enterprise Manager Fusion Middleware Control to configure log levels.

For each logger, set the notification level.

Parent topic: Viewing Log Files

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.

    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.

Parent topic: Monitoring Oracle User Messaging Service