28 Monitoring Oracle JCA Adapters

This chapter describes how to monitor Oracle JCA Adapters.

This chapter includes the following topics:

28.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 tab.

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 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 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 tab 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.

28.2 Monitoring Recent Faults and Rejected Messages for an Inbound Adapter

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 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 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 tab 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.

28.3 Monitoring Faults and Rejected Messages for an Inbound Adapter

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 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 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 tab 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.

28.4 Monitoring Properties for an Inbound Adapter

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 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 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 tab 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.

28.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 tab.

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 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 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 tab 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 tab. 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.

28.6 Monitoring Recent Faults for an Outbound Adapter

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 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 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 tab 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.

28.7 Monitoring Faults for an Outbound Adapter

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 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 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 tab 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.

28.8 Monitoring Properties for an Outbound Adapter

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 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 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 portlet 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.

28.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. Make an adapter to fail. For example, delete a directory that the file adapter is supposed to write to, or delete a table that the Database adapter is reading 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."