Figure 9–1 Instances View – Tracking Tab and Details Subtab
Understanding Instances View Elements and Controls
The Instances view of the Oracle ESB Control, as shown in Figure 9–1 is divided into four main regions, as follows:
■ Manage panel
This panel, shown in Figure 9–2, enables you to enable and disable message instance tracking as well as purge the message instances. Note that when instances that are purged, they are lost forever.
The control to the left of the Manage title enables you to open or close this panel;
the green arrow icon to the right of the Manage title applies changes you make in this panel.
Figure 9–2 Instances View – Manage Panel
■ Search panel
Because the volume of messages processed during that time can be quite large, the Search panel, shown in Figure 9–3, enables you to limit the messages displayed using a variety of filter criterion.
The control to the left of the Search title enables you to open or close this panel; the green arrow icon to the right of the Search title applies changes you make in this
panel. The Advanced control toggles to Basic and back; it enables you to show or hide the Instances containing region of this panel.
By default, the Instances panel displays all the messages processed during the past day. If you want to view messages processed prior to the past day, then you need to increase the number of days in the Activity in last field in the Advanced options before searching for messages.
Only the first 100 instances are returned after any search filtering.
Figure 9–3 Instances View – Search Panel
■ Instances panel
The Instances panel lists the message instances processed or being processed by the ESB services, optionally filtered by search options you select. The maximum number of displayed is 100.
For each message, the time at which each message instance entered the enterprise service bus, instance ID for the message, and the status of that processing is provided. The status is represented by the following color-coded icon(s) in the Status column (shown in Figure 9–4):
– Green rectangle - No faults or errors during message processing – Solid red circle overlaid with an X - Error occurred
– Yellow triangle overlaid with an exclamation point - Faulted message (the target service returned an application fault)
– An error icon plus a faulted icon - Error and faulted
– An error icon overlaid with a small yellow left arrow – Error is resubmittable (for asynchronous processing)
– An error icon overlaid with a small yellow left arrow plus a faulted icon – Error (resubmittable) and faulted
– An error icon overlaid with a small yellow right arrow plus a faulted icon – Error (rejection by inbound adapter) and faulted
Understanding Instances View Elements and Controls
Figure 9–4 Instances Panel Showing Status Codes
■ Tracking Tab (with associated subtabs)
The Tracking tab has a diagram region that provides a schematic of the message processing, as well as Navigator, Details, and Overlay subtabs, as described in the following list:
– Schematic
The Tracking tab schematic shows the path the message selected from the Instances panel has taken (or is taking) across the enterprise service bus. If you select a particular service within the Instances panel, that service is enclosed in a dotted grey box, as shown for the service labeled CustOut_RS in Figure 9–1.
If a service has successfully processed the message, that service appears in green, as shown for the service labeled CRMOut in Figure 9–1.
If any service has not processed the selected message because processing is incomplete or due to filter criterion, that service appears in grey, as shown for the service labeled CustDBOut in Figure 9–2.
If an error occurred during processing, the service at which the error occurred is red, as shown in Figure 9–5. A yellow service icon indicates a
non-transactional endpoint.
Figure 9–5 Oracle ESB Control – Instances View with Error
– Navigator subtab
For complex ESB configurations, the schematic can be quite large and you may not be able to view it in its entirety all at once. The Navigator subtab provides a birds-eye view of the entire schematic. The purple region of the Navigator tab highlights the area of the schematic currently in showing.
Use the scroll bars around the schematic to view areas currently outside the purple shaded region. Click the down-arrow button to the left of the Navigator tab to hide the contents of the subtabs (and thereby increase the available viewing area for the schematic.)
– Details subtab
The details subtab provides information about the status of a message with respect to a selected service. Note that a pencil icon on the service designates that the service has been updated since the message instance was processed.
– Overlay subtab
The Overlay subtab enables you to view statistics on the messages processed by each service.
■ Error tab
The Error tab is presented only when you select a service in the Instances panel where an error occurred, as shown in Figure 9–6. The Errors tab contains an error table that lists the time, service:operation, and message associated with each error.
Click the Error Details icon in the Message column to view the error message and the stack trace. See Chapter 10, "Error Handling" for information about handling error conditions.