Oracle® Fusion Middleware Administrator's Guide for Oracle SOA Suite 11g Release 1 (11.1.1) Part Number E10226-02 |
|
|
View PDF |
This chapter describes how to monitor Oracle JCA Adapters.
This chapter includes the following topics:
Section 28.1, "Monitoring Instances and Faults for an Inbound Adapter"
Section 28.2, "Monitoring Recent Faults and Rejected Messages for an Inbound Adapter"
Section 28.3, "Monitoring Faults and Rejected Messages for an Inbound Adapter"
Section 28.4, "Monitoring Properties for an Inbound Adapter"
Section 28.5, "Monitoring Instances and Faults for an Outbound Adapter"
Section 28.6, "Monitoring Recent Faults for an Outbound Adapter"
Section 28.8, "Monitoring Properties for an Outbound 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:
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... |
---|---|
|
|
Monitor the instances and faults for an inbound adapter:
Click Dashboard.
The Dashboard tab is displayed.
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.
To monitor the recent rejected messages for an inbound adapter:
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... |
---|---|
|
|
Monitor the recent faults and rejected messages for an inbound adapter:
Click Dashboard.
The Dashboard tab is displayed.
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.
To monitor the rejected messages for an inbound adapter:
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... |
---|---|
|
|
Monitor the faults and rejected messages for an inbound adapter:
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.
To monitor the properties for an inbound adapter:
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... |
---|---|
|
|
Monitor the properties for an inbound adapter:
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.
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:
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... |
---|---|
|
|
Monitor the instances and faults for an outbound adapter:
Click Dashboard.
The Dashboard tab is displayed.
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.
To monitor recent faults for an outbound adapter:
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... |
---|---|
|
|
Monitor the recent faults for an outbound adapter:
Click Dashboard.
The Dashboard tab is displayed.
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.
To monitor faults for an outbound adapter:
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... |
---|---|
|
|
Monitor the faults for an outbound adapter:
Click the Faults tab.
The Faults tab is displayed.
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.
To monitor properties for an outbound adapter:
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... |
---|---|
|
|
Monitor the properties for an outbound adapter:
Click the Properties tab.
The Properties portlet is displayed.
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.
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:
Navigate to Composite Home, J2EE Application (menu), Monitoring, Logs.
Find the oracle.soa.adapter logger for adapters and increase verbosity.
Find resulting log files.
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.
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."