3 Getting Started with Oracle Service Bus Administration
This chapter describes how to log in to and navigate the menus of Fusion Middleware Control to perform Oracle Service Bus configuration, monitoring, and management tasks. It also describes the Service Bus administration pages available in the console.
This chapter includes the following sections:
-
Logging in to Oracle Enterprise Manager Fusion Middleware Control
-
Logging out of Oracle Enterprise Manager Fusion Middleware Control
For information about standard Fusion Middleware Control features and tasks, see Administering Oracle Fusion Middleware.
3.1 Introduction to the Management and Monitoring Pages
In Fusion Middleware Control, you can monitor and mange Service Bus applications and their lifecycles. You deploy Service Bus applications designed in Oracle JDeveloper or the Oracle Service Bus Console to a Service Bus domain. Fusion Middleware Control accesses the information collected for those deployed applications.
Service Bus aggregates runtime statistics, which you can view on the Dashboard, Alert History, and Service Health pages. The Dashboard allows you to monitor the health of the system and notifies you when alerts are generated in your services. With this information, you can quickly and easily isolate and diagnose problems as they occur.
Service Bus monitoring and management features are categorized into service-level, project-level, and domain-level information and tasks. The Service Bus domain pages in Fusion Middleware Control display information at the domain-level, and let you set operational settings at both the service and global level. The Service Bus Project pages display the health of all services in a project, and let you set operational settings at the service level. Service component pages display information about the health of the selected service, and let you update operational settings for that service. You can also attach and detach policies and define policy override values for business services and proxy services, as well as manage endpoint URIs for business services.
3.1.1 Service Bus Domain-Level Monitoring Pages
The Service Bus home page lets you perform administration tasks such as monitoring pipeline and SLA alerts, monitoring the health of individual services, viewing faults for resequenced messages, and updating global and operational settings. You can also perform corrective actions such as fault recovery. Fusion Middleware Control displays information for all deployed services, including proxy services, business services, pipelines, and split-joins. The level of information displayed depends on how the operational settings are configured for each service and at the global level.
3.1.1.1 Dashboard (Domain-Level)
The Service Bus dashboard displays all the alerts that have been triggered in the Service Bus runtime as a result of SLA violations or pipeline alerts. Service Level Agreements (SLAs) are agreements that define the level of service expected from the business and proxy services in Service Bus. Pipeline alerts are defined in the message flow for business purposes such as recording the number of messages that flow through the message pipeline, tracking occurrences of certain business events, or reporting errors (but not for the health of the system).
Each row of the Alert History table displays the information configured for the alert rule, such as the severity, timestamp, and associated service. Clicking the Alert Name link displays an Alert Details dialog for more information about the SLA alert. Clicking the Alert Summary link displays the Alert Details dialog for a pipeline alert. This helps you to analyze the cause of the SLA or pipeline alert. A read-only display of the configuration for the alert rule that generated each alert is also available.
The Dashboard lists the Service Bus services with the most alerts and the services with the most errors. If you click an alert or error, additional information appears to help you analyze and fix the cause of the alert or error. For services with errors, the Dashboard displays additional information such as the average response time for a service, the number of messages processed, and the number of errors.
The following image shows the Service Bus Dashboard. For more information, see Monitoring Oracle Service Bus Alerts.
Figure 3-1 Service Bus Dashboard Page in Fusion Middleware Control

Description of "Figure 3-1 Service Bus Dashboard Page in Fusion Middleware Control"
3.1.1.2 Alert History
The Alert History page provides search features, so you can search for alerts based on the alert type, alert rule, or alert severity. You can also search for alerts for specific services or for a specific date range. The information provided on the Alert History page is similar to that provided on the Dashboard; however, the search feature allows you to view only those alerts or services you are interested in. The search results list provides additional links so you can view additional information about the alert, navigate to the Dashboard page for the service for which the alert was generated, and view the alert rule that generated the alert.
Use the purge and delete features on the Alert History page to manage the size of the alert store. You can purge all alerts, or just purge those alerts that were generated within a specific time period.
The following figure shows the Alert History page. For more information, see Monitoring Oracle Service Bus Alerts.
3.1.1.3 Service Health
When you display statistics for the current aggregation interval, the Service Bus Service Health page displays a dynamic view of statistical data collected for each deployed service. The display is updated at certain intervals to only display alerts for the aggregation interval. For example, if the aggregation interval of a particular service is twenty minutes, this page displays the data collected in the last twenty minutes for that service.
You can search for specific services or groups of services to view. The Services table displays statistics for each service returned for your search, such as the number of alerts, messages, and errors, as well as the average response time. The aggregation interval can be individually configured for services, so the table also displays the aggregation interval for each service.
The following figure shows the domain-level Service Health page. For more information, see Monitoring Oracle Service Bus Service Health.
3.1.1.4 Resequence Messages
If any of your deployed pipelines use the resequencer to re-order messages, the Resequence Messages page displays information about the state of processing those messages so you can monitor the current health of the resequencing groups. A group can be running, faulted, or completed. The search feature lets you search for messages in specific resequencer groups, for groups in specific states, or for messages associated with a specific service.
When message processing is suspended in a resequencing group, you can take steps on the Resequence Messages page to fix, retry, or abort processing the message. The corrective action depends on the type of fault, and might include canceling message processing, skipping a stuck message, or modifying the payload and retrying the message. These can all be performed from the Resequence Messages page.
The following figure shows the Resequence Messages page. For more information, see Monitoring Resequencing Groups.
3.1.1.5 Operations
The Service Bus Operations page displays the current operational settings for your deployed services. You can update the settings for the listed services, either individually in or bulk. The Service Bus Operations page only includes a subset of the available operational settings, and only allows enabling and disabling settings. You can further configure these settings, and configure additional settings, on a service's own Operations page. The settings you can configure from the Service Bus page include monitoring, alerts, message tracing, execution tracing, alerts, reporting, logging, and business service performance tuning. Certain operational settings are set at the service level, some are set at the global level, and some need to be set at both the service and global level in order to take effect. The Operations page only configures the settings at the service level.
The following figure shows the Operations page. For more information, see Configuring Operational and Global Settings.
3.1.1.6 Global Settings
The Service Bus Global Settings page lets you enable operational settings, such as monitoring, logging, and alerting, on a global scale. You can also configure certain resequencing properties for the runtime.
You must enable or disable these settings at the global level in conjunction with the settings at the service level to effectively enable or disable them. The following settings must be enabled at the global level in order to be enabled for a specific service:
-
Monitoring
-
SLA Alerting
-
Pipeline Alerting
-
Reporting
-
Logging
-
Result Caching
The following figure shows the Global Settings page. For more information, see Configuring Operational and Global Settings.
3.1.2 Service Bus Project Monitoring Pages
The Service Bus Project pages display information about the services in the selected project, and include the Service Health page and the Operations page. These pages are similar to the domain-level pages described in Service Bus Domain-Level Monitoring Pages,, but are only for the services included in the selected project. The Service Health page displays service health metrics for the services in the selected project. The Operations page displays the operational settings for the services in the selected project. You can update these settings individually or for all services in the project.
3.1.3 Service Bus Service Monitoring Pages
You can monitor a specific service using the monitoring pages for that service. The service-specific pages include a Dashboard, the Policies page, and the Properties page.
3.1.3.1 Dashboard (Service-Level)
The Dashboard displays service health metrics for the selected service, including alert counts, message counts, response times, and error counts. It also displays statistics for WSDL operations, if applicable. For business services only, you can view information about the state of the endpoint along with other statistics, and you manage endpoint URIs by bringing an endpoint URI online or offline. For pipeline and split-joins only, the Dashboard displays additional statistics down to the branch and activity levels.
3.1.3.2 Properties
The Properties page displays the current operational settings for the service. You can update the settings by enabling or disabling settings, specifying monitoring and logging levels, specifying alert severities, and defining an aggregation interval. The available settings differ based on the type of Service Bus service you are monitoring. For more information, see Configuring Operational and Global Settings.
3.1.3.3 Policies
The Policies page displays a list of all security policies attached to the service at a global level and a list of those attached directly to the service. From this page you can attach and detach policies and specify override values for policies that support overrides. Global policies cannot be modified on this page. Fusion Middleware Control provides features to monitor policy usage and violations, and to create global policy sets. For more information, see Monitoring and Managing Security Policies.
3.2 Logging in to Oracle Enterprise Manager Fusion Middleware Control
You can access Fusion Middleware Control from a URL in a browser or from the Oracle Service Bus Console.
To access Fusion Middleware Control from the Oracle Service Bus Console, click Links > EM Console. This lets you bypass the login step.
To log in to Oracle Enterprise Manager Fusion Middleware Control from a browser:
3.3 Navigating to Oracle Service Bus Administration Pages
You can navigate to Service Bus administration tasks through the Service Bus home page and menu.
The Service Bus home page provides you with access to all deployed Service Bus services and service components. You can navigate through the Service Bus pages using several different methods and menus.
3.3.1 Navigating Through the Service Bus Home Page and Menu
The Service Bus home page and menu provide access to all SLA and pipeline alerts, health statistics, and Service Bus services.
To navigate through the Service Bus home page and menu:
3.3.2 Navigating Through the Service Bus Projects Home Page and Menu
You can navigate directly to Service Bus tasks for a specific Service Bus project using the Service Bus Project menu. This menu is the same for both Service Bus projects and services.
To navigate through the Service Bus Project home page and menu:
3.3.3 Navigating to Oracle Service Bus Pages from the Home Page
The Fusion Middleware Control home page is the WebLogic Domain page, and is the page that appears when you first log in to the console. You can access the Service Bus home page or the home page for a specific Service Bus project from WebLogic Domain page.
To navigate to a Service Bus or Service Bus project home page:
-
In the Deployments section of the home page, scroll through the list of deployed applications, and select either service-bus or the name of a specific Service Bus project.
The home page for your selection appears.
3.4 Navigating to the System MBean Browser
Some configuration parameters for Oracle Service Bus are not exposed in any Fusion Middleware Control property page. These parameters can be viewed using the System MBean Browser.
A managed bean (MBean) is a Java object that represents a Java Management Extensions (JMX) manageable resource in a distributed environment, such as an application, a service, a component, or a device. Fusion Middleware Control provides the System MBean Browser for managing MBeans that perform specific monitoring and configuration tasks. For general information about the System MBean Browser, see "Getting Started Using the Fusion Middleware Control MBean Browsers" in Administering Oracle Fusion Middleware.
You can directly access the main System MBean Browser page from the Target Navigator. The main page provides you with access to all properties in the System MBean Browser. You must then traverse the navigational tree to the section that you want to manage.
To access the System MBean Browser:
3.5 Setting Accessibility Options
Fusion Middleware Control provides accessibility options for the pages on which you monitor and manage Service Bus services. Fusion Middleware Control supports screen readers and provides standard shortcut keys to support keyboard navigation. You can also view the console pages in high contrast or with large fonts for better readability.
For information and instructions on configuring accessibility in Fusion Middleware Control, see "Using Oracle Fusion Middleware Accessibility Options" in Administering Oracle Fusion Middleware.
3.6 Logging out of Oracle Enterprise Manager Fusion Middleware Control
You can log out of Oracle Enterprise Manager Fusion Middleware Control from any page.
Use the the Log Out link in the upper right-hand corner of the page.
3.7 Starting Oracle Service Bus Servers
Service Bus services must be deployed to a running Oracle WebLogic Server, which can be started in a number of ways.
For complete information about starting the servers using a command line, startup script, or the Administration Console, see Administering Server Startup and Shutdown for Oracle WebLogic Server.