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:

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

Figure 3-2 Service Bus Alert History Page

Description of Figure 3-2 follows
Description of "Figure 3-2 Service Bus Alert History Page"

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.

Figure 3-3 Service Health Page

Description of Figure 3-3 follows
Description of "Figure 3-3 Service Health Page"

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.

Figure 3-4 Resequence Messages Page

Description of Figure 3-4 follows
Description of "Figure 3-4 Resequence Messages Page"

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.

Figure 3-6 Global Settings Page

Description of Figure 3-6 follows
Description of "Figure 3-6 Global Settings Page"

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:

  1. Enter the following URL in your browser:
    http://host_name:port/em
    

    Where host_name is the name of the host on which Fusion Middleware Control is installed and port is the port number of the Administration Server (7001, by default). The port number is listed in the following file:

    DOMAIN_HOME/config/config.xml
    
  2. Enter the administrator user name and password and click Login.

    Note:

    The default administrator user name is weblogic. You can change this during installation.

    The Accessibility Preference dialog appears the first time you log in. If you want, you can select to not display this dialog again.

  3. Select an appropriate action and click Continue.

    The home page appears. From here, you can navigate to Oracle Service Bus in several different ways, as described in the following sections.

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:

  1. In the Target Navigator, expand SOA, and then click service-bus.

    The Dashboard page of the Service Bus home page appears.

    The upper part of the page displays a chart of SLA alerts, and you can choose to view pipeline alerts instead. It also displays services with the most alerts, information about the alerts, and a list of services with the most errors.

  2. To access additional information about a service that is listed in any of the sections, click the service name.
  3. To access additional information for all items in a section, click Show More at the bottom of that section.
  4. To access the navigation menu, do one of the following:
    • Click the Service Bus menu below service-bus the upper left of the page.

    • Right-click service-bus in the Target Navigator.

    Note:

    Depending upon your current location, the context of this menu changes to provide you with relevant administrative options. For example, when you are within the pages of a project or service, the Service Bus Project menu appears instead.

  5. From the Service Bus menu, access any of the following options.
    Option Description

    Home

    Select this option to select a different Service Bus page to view.

    Logs

    Select this option to view or configure log files, and select one of the following options:

    • View Log Messages: Select this to view the entries logged in the target log file.

    • Log Configuration: Select this to define log files and log levels for the different Service Bus loggers.

    Message Reports

    Select this option to view any message reports generated from pipeline reporting actions.

    Import

    Select this option to import a Service Bus configuration JAR file and, optionally, a configuration file that defines environment values.

    Export

    Select this option to export Service Bus projects and resources to a configuration JAR file.

    Security

    Select this option to configure security policies or roles, and select one of the following options:

    • Application Policies: Select this to create application policies that an application relies upon for controlling access to resources.

    • Application Roles: Select this to create application roles for applications.

    These options do not configure security policies for Service Bus services.

    System MBean Browser

    Select this option to launch the MBean browser, where you can view information about the MBean properties set for this domain.

    Target Information

    Select this option to view information about the target server, including the version, the location of the domain and Fusion Middleware home directories, and the server host name.

  6. From the Service Bus home page, select any of the following tabs to search for and view additional information:

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:

  1. Expand SOA in the Target Navigator, and then expand service-bus.

    All running Service Bus projects appear in the list below service-bus.

  2. Select a specific Service Bus project.

    The Service Health page for the selected project appears.

  3. To access the navigation menu, do one of the following:
    • Click Service Bus Project below service-bus the upper left of the page.

    • Right-click the name of a project in the Target Navigator.

    The Service Bus Project menu provides you with administrative tasks specific to the current Service Bus application.

  4. From the Service Bus Project menu, access any of the following options.
    Option Description

    Home

    Select this option to return to the Service Bus Project home page and directly navigate to any of the tabbed pages.

    Message Reports

    Select this option to view message reports generated from a pipeline reporting action.

    Import

    Select this option to import a Service Bus configuration JAR file or configuration file that defines environment values.

    Export

    Select this option to export Service Bus resources to a configuration JAR file.

    Target Information

    Select this option to view information about the target server, including the version, the location of the domain and Fusion Middleware home directories, and the server host name.

  5. From the Service Bus Project home page, select any of the following tabs to search for and view additional information:
    • Service Health: Displays service health statistics and lets you search for running services in the current project to view. For more information, see Monitoring Oracle Service Bus Service Health.

    • Operations: Displays the operational settings for services in the project, and lets you search for services in the current project to update their operational settings. For more information, see Configuring Operational and Global Settings.

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:

  1. In the Target Navigator, right-click service-bus.
  2. Select System MBean Browser.

    The System MBean Browser appears with a list of application-defined MBeans for Service Bus.

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.