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

Part Number E10226-09
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

29 Monitoring Oracle JCA Adapters

This chapter describes how to monitor Oracle JCA Adapters.

This chapter includes the following topics:

29.1 Monitoring Instances and Faults for an Inbound Adapter

An invocation to a service from a composite may result in an error. This error is captured as a fault in the service. You can view the details of the instances and faults of the inbound adapter in the Instances and Faults section of the Dashboard page.

To monitor instances and faults for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composites is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.


  2. Monitor the instances and faults for an inbound adapter:

    1. Click Dashboard.

      The Dashboard page is displayed.

    2. View the instances and faults listed in the Instances and Faults section.

      The details of the fault is displayed in a line chart in the Instances and Faults section. This line chart shows the total number of outgoing messages since the start of the server, and the total number of faults since the start of the server.

For more information about monitoring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.2 Monitoring Recent Faults and Rejected Messages for an Inbound Adapter

You can view the details of the recent faults and rejected messages of the inbound adapter in the Recent Faults and Rejected Messages section of the Dashboard page.

To monitor the recent rejected messages for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composites is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.


  2. Monitor the recent faults and rejected messages for an inbound adapter:

    1. Click Dashboard.

      The Dashboard page is displayed.

    2. View the recent faults and rejected messages listed in the Recent Faults and Rejected Messages section.

      A list of recently rejected faults and messages with details such as error message, fault time, and the composite instance ID is displayed.

      For more information about monitoring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.3 Monitoring Faults and Rejected Messages for an Inbound Adapter

You can view the details of the faults and rejected messages of an inbound adapter in the Faults and Rejected Messages page.

To monitor the rejected messages for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composites is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.


  2. Monitor the faults and rejected messages for an inbound adapter:

    1. Click Faults and Rejected Messages.

      The Faults and Rejected Messages page is displayed.

      A list of faults and rejected messages with details such as error message, fault time, and composite instance ID is displayed.

For more information about monitoring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.3.1 Searching for Rejected Messages for an Inbound Adapter

Use the Search feature to search for faults and rejected messages for an inbound adapter.

To search for faults and rejected messages for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.


  2. Click the Faults and Rejected Messages tab.

  3. Enter any or all of the following search criteria:

    • Error Message Contains

      Enter any part of the error message text.

    • Fault ID

      Enter the ID of the fault.

    • Fault Time From

      Enter the lower limit of the time when the fault could have occurred.

    • Fault Time To

      Enter the upper limit of the time when the fault could have occurred.

    • Composite Instance ID

      Enter the ID of the composite.

    • Fault Type

      Select a type from the list of faults available.

  4. Click Search to start the search operation.

    The fault or rejected message matching the criteria you specified is displayed.

  5. Click Reset to reset the search criteria.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.3.2 Deleting Rejected Messages for an Inbound Adapter

You can directly delete rejected messages from the database by specifying a search criteria.

To delete rejected messages for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.


  2. Click the Faults and Rejected Messages tab.

  3. Click Delete Rejected Messages....

    The Delete: Rejected Messages dialog is displayed.

  4. Specify a selection criterion for deleting rejected messages directly from the database, and then click Delete.

Note that to delete a fault, you must delete the associated composite instance from the Instances page.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.4 Monitoring Properties for an Inbound Adapter

You can view the details of the properties of an inbound adapter in the Properties page.

To monitor the properties for an inbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composites is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the inbound adapter (service) from the Services and References section in the right panel.

      The Service Home page is displayed.


  2. Monitor the properties for an inbound adapter:

    1. Click Properties.

      The Properties page is displayed.

      A list of properties with details such as name and value is displayed.

Note:

In any adapter that has an inbound asynchronous request-reply scenario (the Get Message operation preceding the Send Reply operation) only details about the activation specification are displayed, and details about the interaction specification are not displayed.

For more information about monitoring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.5 Monitoring Instances and Faults for an Outbound Adapter

An invocation to a reference from a composite may result in an error. This error is captured as a fault in the reference. The details of the instances and faults of the outbound adapter can be viewed in the Instances and Faults section of the Dashboard page.

To monitor instances and faults for an outbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composites is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Service Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Service Home page is displayed.


  2. Monitor the instances and faults for an outbound adapter:

    1. Click Dashboard.

      The Dashboard page is displayed.

    2. View the instances and faults listed in the Instances and Faults section.

      The details of the fault is displayed in a line chart in the Instances and Faults section. This line chart shows the total number of outgoing messages since the start of the server, and the total number of faults since the start of the server.

For more information about monitoring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.6 Monitoring Recent Faults for an Outbound Adapter

The details of the recent faults of the outbound adapter can be viewed in the Recent Faults section of the Dashboard page.

To monitor recent faults for an outbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composites is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Service Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Service Home page is displayed.


  2. Monitor the recent faults for an outbound adapter:

    1. Click Dashboard.

      The Dashboard page is displayed.

    2. View the recent faults listed in the Recent Faults section.

      A list of recent faults with details such as name, time, and type is displayed.

For more information about monitoring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.7 Monitoring Faults for an Outbound Adapter

The details of the instances and faults of the outbound adapter can be viewed in the Faults page.

To monitor faults for an outbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composites is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Service Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Service Home page is displayed.


  2. Monitor the faults for an outbound adapter:

    1. Click the Faults tab.

      The Faults page is displayed.

    2. Click View.

      A list of faults with details such as name, time, and type is displayed.

For more information about monitoring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.7.1 Searching for Faults for an Outbound Adapter

Use the Search feature to search for faults for an outbound adapter.

To search for faults for an outbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composite applications is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Reference Home page is displayed.


  2. Click the Faults tab.

  3. In the Search section, enter any or all of the following search criteria:

    • Error Message Contains

      Enter any part of the error message text.

    • Fault ID

      Enter the ID of the fault.

    • Fault Time From

      Enter the lower limit of the time when the fault could have occurred.

    • Fault Time To

      Enter the upper limit of the time when the fault could have occurred.

    • Composite Instance ID

      Enter the ID of the composite.

    • Fault Type

      Select the type of the fault from the list of types available.

  4. Click Search to start the search operation.

    The fault matching the criteria you specified is displayed.

  5. Click Reset to reset the search criteria.

For more information about configuring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.8 Monitoring Properties for an Outbound Adapter

The details of the properties of the outbound adapter can be viewed in the Properties page.

To monitor properties for an outbound adapter:

  1. Navigate to the SOA composite application by using either of the following options:

    From the SOA Infrastructure Menu... From the SOA Folder in the Navigator...
    1. Click Home.

      The SOA Infrastructure page is displayed.

    2. Click the Deployed Composites tab.

      The list of deployed composites is displayed.

    3. In the Composite section, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    4. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Service Home page is displayed.

    1. Under soa-infra, click a specific SOA composite application.

      The SOA Composite home page is displayed.

    2. Click the outbound adapter (reference) from the Services and References section in the right panel.

      The Service Home page is displayed.


  2. Monitor the properties for an outbound adapter:

    1. Click the Properties tab.

      The Properties page is displayed.

    2. Click View.

      A list of properties with details such as name, and value is displayed.

Note:

In the case of an adapter which has an outbound asynchronous request-reply scenario (the Send Message operation preceding the Get Response operation), only details about the interaction specification are displayed, and details about the activation specification are not displayed.

For more information about monitoring adapters, see Oracle Fusion Middleware User's Guide for Technology Adapters.

29.9 Monitoring Adapter Logs

Oracle Fusion Middleware components generate log files containing messages that record all types of events, including startup and shutdown information, errors, warning messages, access information on HTTP requests, and additional information. There is only one log for all Oracle JCA Adapters, and the log is called oracle.soa.adapter.

To monitor the File adapter logs:

  1. Navigate to Composite Home > J2EE Application (menu) > Monitoring > Logs.

  2. Find the oracle.soa.adapter logger for adapters and increase verbosity.

  3. Find resulting log files.

  4. Cause an adapter to fail. For example, delete a directory that the file adapter writes to, or delete a table that the Database adapter reads from.

  5. Ensure that the resulting log files give a good indication of the cause of failure.

For information about configuring logs, see Section 3.4, "Configuring Log Files."