This chapter describes how to monitor Oracle Communications Integration targets in Enterprise Manager Cloud Control by using the home page provided by Oracle Application Management Pack for Oracle Communications.
Oracle Communications Integration targets represent Oracle Application Integration Architecture (Oracle AIA) Oracle Communications Pre-Built Integrations deployed on Oracle Service Oriented Architecture (SOA).
Application Management Pack for Oracle Communications lets you monitor Oracle Communications Integration targets using Oracle Enterprise Manager Cloud Control. A Management Agent monitors targets for collection items and metrics and sends the data to the Management Server for presentation.
You must install and deploy the Application Management Pack for Oracle Communications plug-in on both your Management Server and host agents before monitoring Oracle Communications Integration targets.
See the following chapters for information about setting up Oracle Communications application monitoring with Enterprise Manager Cloud Control:
Installing Application Management Pack for Oracle Communications
Managing Communications Applications with Enterprise Manager Cloud Control
The home page for Oracle Communications Integration targets displays summary information and metrics data that you can use to monitor the health and performance of your integration. See "Viewing Home Pages" for information about accessing home pages. You can access the target's configuration topology from the home page as described in "Viewing Topology".
Table 11-1 describes the regions shown on the Dashboard tab of the home page for Oracle Communications Integration targets.
Table 11-1 Regions on the Dashboard Tab of the Integration Home Page
| Region | Description |
|---|---|
|
Integration Configuration Summary |
Displays version numbers and dates for Oracle AIA and SOA integration packs and patches. Does not appear for Communications Integration targets for which the Oracle AIA instance is not installed on the same host as the Management Agent. |
|
Extended Composites |
Lists the service composites configured for Oracle AIA in alphabetical order. You can filter the list by searching for a particular service name. Does not appear for Communications Integration targets for which the Oracle AIA instance is not installed on the same host as the Management Agent. |
|
Integrated Edge Applications |
Provides the status of the BRM and OSM instances that the Oracle Communications Integration target integrates. You can use this region to add a monitoring agent and configure automatic discovery for the integrated applications. See "Configuring Integrated Applications for Status Monitoring" for more information. |
|
Host Performance Data |
Displays performance information for the host on which SOA and Oracle AIA are deployed, including CPU and memory use. Use this region to determine whether a particular host is causing problems by identifying fluctuations in host performance. |
Table 11-2 describes the regions on the Fault Order Details tab of the home page for Oracle Communications Integration targets.
Table 11-2 Regions on the Fault Order Details Tab of the Integration Home Page
| Region | Description |
|---|---|
|
Integration Fault Summary |
Displays the total number and percentage of business, system, and data faults. Use this region to identify and resolve faults. You can click the links in the Total Faults column to see a list of faults and their details, and use the arrows in the list to see the SOA trace instance for the fault. You can click the Show Recoverable Faults link to go to the SOA infrastructure target home page where you can recover from faults in bulk. See "Viewing and Recovering from Faults" for more information. |
|
Order Throughput |
Displays the number of incoming and failed orders for the last 24 hours in a list and a graph. Use this region to identify failed order backlogs or to determine if increased numbers of incoming orders are causing performance problems. |
|
Integration Fault Backlog Trend |
Displays a graph of the total number of backlogged errors over time. |
After you have discovered an Oracle Communications Integration target, you can monitor the status of the applications that the target integrates from the target's home page.
You can monitor the status of integrated applications that have been discovered and promoted as targets in Enterprise Manager Cloud Control, and configured on the Oracle Communications Integration target's home page.
To configure the integrated applications for status monitoring, repeat the following steps for each application listed in the Integrated Edge Applications region:
Log in to the Enterprise Manager Cloud Control administration console.
Navigate to the home page for the Oracle Communications Integration target for which you want to configure integrated applications, as described in "Viewing Home Pages".
In the Integrated Edge Applications region, select an application row and click Configure Edge Application Details.
In the Hostname field, enter the host on which the application is deployed.
In the PinUser/Port field, enter one of the following:
For BRM, enter the user name for the BRM host.
For OSM, enter the port for the OSM server.
Click Submit.
The application's name appears as a link to the application's target home page, and its status is shown. For OSM targets, the status is a green Up arrow or a red Down arrow. Because BRM targets consist of many components, some of which may be up or down, the status is always n/a.
If the Add Agent or Discover Edge Application link appears beside the target name, you have not installed a Management Agent on the integrated application's host or discovered the application. To monitor the integrated application's status from the Oracle Communications Integration target's home page, do the following:
If the Add Agent link appears, click the link to go to the Add Targets Manually page. You must perform the following tasks:
Add the host target and agent as described in "Adding Host Targets Manually and Installing the Management Agent".
Discover and promote the edge applications as described in "Adding Oracle Communications Targets".
If the Discover Edge Application link appears, click the link to go to the Setup Discovery page for configuring automatic discovery. You must discover and promote the integrated application as described in "Discovering Targets Automatically".
You can view lists of faults from the Oracle Communications Integration target home page, and recover from some system faults from the SOA infrastructure target home page.
To view lists of faults and their details:
Log in to the Enterprise Manager Cloud Control administration console as a privileged user.
Navigate to the home page for the Oracle Communications Integration target for which you want to view faults, as described in "Viewing Home Pages".
Click the Fault Order Details tab.
In the Total Faults column in the Integration Fault Summary region, select one of the number of business, data, or system faults links.
The fault list page with summary information about the faults appears.
In the first column of the table, next to an individual fault, click the arrow icon.
The Trace Instance page appears for that fault. This page provides detailed information about all faults associated with the same Execution Context ID (ECID).
To recover from system faults:
Log in to the Enterprise Manager Cloud Control administration console as a privileged user.
Navigate to the home page for the Oracle Communications Integration target for which you want to recover from system faults, as described in "Viewing Home Pages".
Click the Fault Order Details tab.
In the Integration Fault Summary region, click Show Recoverable Faults.
The home page appears for the SOA infrastructure target to which the Integration target is deployed.
Click the Faults and Rejected Messages tab.
In the Search panel, set the search criteria. Ensure that you select Recoverable from the Fault list.
Click Search.
In the Faults and Rejected Messages table, select up to 5 faults.
From the Recovery Options menu, select a recovery action.
A message is displayed indicating whether the recovery job can be submitted successfully.
Click OK.
The fault recovery job is run.
To verify that the recovery job was successful, set the same search criteria and click Search.
The faults for which you selected a recovery action do not appear if the recovery job was successful.
See the chapter about discovering and monitoring the SOA suite in Oracle Enterprise Manager Cloud Control Oracle Fusion Middleware Management Guide and the Enterprise Manager Online Help for more information about instance tracing and managing faults.
You can view a list of all metrics collected for an Integration target and view details about individual metrics, including values, severity, and alerts that are triggered for that metric. See "Viewing Target Metrics".
Application Management Pack for Oracle Communications provides default thresholds for critical collection items and metrics. You can customize the thresholds and add thresholds and alerts for collection items and metrics that have no default thresholds. See "Configuring Metric Monitoring Thresholds and Alerts" for more information about configuring thresholds.