You use the Configuration module to locate and manage proxy services, business services, alert destinations, SLA alert rules, and the run-time tracing for proxy services.
You can specify operational settings for all services, at the service and global level, and use the global settings to turn on and off monitoring, SLA alerts, and, for proxy services only, pipeline message reporting and pipeline message logging.
Finding and Updating Operational Settings
Use the Smart Search page to easily locate proxy services, business services, alert destinations, and SLA alert rules. Additionally, you can use the Smart Search page to specify service-specific operational settings, with the following exceptions: you cannot set an aggregation interval or specify an alerting or logging severity level. For more information, see Configuring Operational Settings for Proxy Services and Configuring Operational Settings for Business Services.
The run-time effects of the service-level settings depend on their corresponding global settings. You must enable both the global and the service-level settings for a service to be completely enabled at run time. Additionally, the service State must also be enabled. See Enabling Global Settings.
You can enable or disable operational settings only from within a session.
Finding All Services (Proxy and Business Services)
Select Operations > Smart Search.
From the Type drop-down list, select All Services, then click Search. The Summary of All Services page displays the information shown in Table 24-1.
To restrict the number of items in the list or locate specific services:
Click the Open icon to display additional search filters. If you specify multiple search criteria, only results that match all the criteria will be returned.
Filter by service name. In the Name field, enter the name of the search target or enter wildcard characters (use * and ? as wildcard characters to perform a more general search), then click Search.
This search method is preferable if the name of the service is unique across all projects and paths.
Filter by service path. In the Path field, enter the path of the search target, which is the project name and the name of the folder in which services reside. You can use * and ? as wildcard characters to perform a more general search. All the services that reside in that path are displayed.
The format for the Path field is as follows: project-name/root-folder/ . . ./parent-folder
If a service is directly under the project, the format is as follows: project-name
Filter by service name and path. This search method is preferable if there is more than one service with the same name that reside in different paths.
Filter by service state. From the State drop-down list, select the state of the service: Enabled or Disabled, then click Search. Select All to ignore the service state filter criteria.
Filter by service monitoring. From the Monitoring drop-down list, select the monitoring status of the service: Enabled or Disabled, then click Search. Select All to ignore the service monitoring filter criteria.
Filter by service’s SLA Alerts setting. From the SLA Alerts drop-down list, select the SLA alerts setting of the service: Enabled or Disabled, then click Search. Select All to ignore the service SLA alerts filter criteria.
The project associated with the service. If the service resides in a project folder, this folder is also listed. The path is displayed in the format:
project-name/root-folder/ . . ./parent-folder
The path is a link to the corresponding path in the Project Explorer.
Type
The parent service type: proxy service or business service.
State
The state of the service: Enabled or Disabled.
Monitoring
The monitoring status of the service: Enabled or Disabled.
SLA Alerts
The SLA alerts status: Enabled or Disabled, and the level enabled at and above: Normal (N), Warning (W), Minor (Mn), Major (Mj), Critical (C), or Fatal (F).
Pipeline Alerts
For proxy services only:
The pipeline alerts status: Enabled or Disabled, and the level enabled at and above: Normal (N), Warning (W), Minor (Mn), Major (Mj), Critical (C), or Fatal (F).
Reports
For proxy services only:
The message reporting status of the service: Enabled or Disabled.
Logs
For proxy services and Split-Joins only:
The logging status: Enabled or Disabled, and the level enabled at and above: Debug (D), Info (I), Warning (W), or Error (E).
Tracing
For proxy services and Split-Joins only:
The run-time tracing status of the proxy service: Enabled or Disabled.
Actions
For proxy services: The Edit Message Flow icon is a link to the pipeline for that proxy service.
You can use this page also to do the following:
To remove the search filter and display all services, click View All.
To discard your changes and refresh the page with the currently stored settings using the same search criteria, click Reset.
From within a session, to enable or disable any service-level settings, select or clear the check box next to it and click Update.
Note:
The run time effects of the service-level settings depend on their corresponding global settings. You must enable both the global and the service-level settings for a service to be completely enabled at run time. Additionally, SLA Alerts depends on both the global and service-level Monitoring states—both must be enabled for SLA alerts to be enabled at run time. See Enabling Global Settings.
Note:
In addition, the service State must also be enabled.
To customize your view of the operational settings information, click the Table Customizer icon. See Customizing Table Views.
Finding Proxy Services
Select Operations > Smart Search.
From the Type drop-down list, select Proxy Services, then click Search. The Summary of Proxy Services page displays the information shown in Table 24-2.
To restrict the number of items in the list or locate specific proxy services:
Click the Open icon to display additional search filters. If you specify multiple search criteria, only results that match all the criteria will be returned.
Filter by proxy service name and path. In the Name and Path fields, enter the name and path of the search target, then click Search. The path is the project name and the name of the folder in which the proxy service resides. You can use * and ? as wildcard characters to perform a more general search.
Filter by service state. From the State drop-down list, select the proxy service state: Enabled or Disabled, then click Search. Select All to ignore the service state filter criteria.
Filter by service monitoring. From the Monitoring drop-down list, select the monitoring status of the proxy service: Enabled or Disabled, then click Search. Select All to ignore the service monitoring filter criteria.
Filter by service’s SLA Alerts setting. From the SLA Alerts drop-down list, select the SLA alerts setting of the proxy service: Enabled or Disabled, then click Search. Select All to ignore the service SLA alerts filter criteria.
Filter by service’s pipeline alerts setting. From the Pipeline Alerts drop-down list, select the pipeline alerts setting of the proxy service: Enabled or Disabled, then click Search. Select All to ignore the service pipeline alerts filter criteria.
Filter by services with message reports. From the Message Reports drop-down list, select the message reports status of the proxy service: Enabled or Disabled, then click Search. Select All to ignore the service message reports filter criteria.
Filter by services with logging. From the Logs drop-down list, select the logging status of the proxy service: Enabled or Disabled, then click Search. Select All to ignore the service logging filter criteria.
Filter by services with run-time tracing. From the Tracing drop-down list, select the run-time tracing status of the proxy service: Enabled or Disabled, then click Search. Select All to ignore the service tracing filter criteria.
The project associated with the proxy service. If the service resides in a project folder, this folder is also listed. The path is displayed in the format:
project-name/root-folder/ . . ./parent-folder
The path is a link to the corresponding path in the Project Explorer.
Type
The parent service type: proxy service.
State
The state of the proxy service: Enabled or Disabled.
Monitoring
The monitoring status of the proxy service: Enabled or Disabled.
SLA Alerts
The SLA alerts status: Enabled or Disabled, and the level enabled at and above: Normal (N), Warning (W), Minor (Mn), Major (Mj), Critical (C), or Fatal (F).
Pipeline Alerts
The pipeline alerts status: Enabled or Disabled, and the level enabled at and above: Normal (N), Warning (W), Minor (Mn), Major (Mj), Critical (C), or Fatal (F).
Reports
The message reports status of the service: Enabled or Disabled.
Logs
The logging status: Enabled or Disabled, and the level enabled at and above: Debug (D), Info (I), Warning (W), or Error (E).
Tracing
The run-time tracing status of the proxy service: Enabled or Disabled.
Actions
The Edit Message Flow icon is a link to the pipeline for that proxy service.
You can use this page also to do the following:
To remove the search filters and display all proxy services, click View All.
To discard your changes and refresh the page with the currently stored settings using the same search criteria, click Reset.
From within a session, to enable or disable any service-level settings, select or clear the check box next to it and click Update.
Note:
The run time effects of the service-level settings depend on their corresponding global settings. You must enable both the global and the service-level settings for a service to be completely enabled at run time. Additionally, SLA Alerts depends on both the global and service-level Monitoring states—both must be enabled for SLA alerts to be enabled at run time. See Enabling Global Settings.
Note:
In addition, the service State must also be enabled.
To customize your view of the operational settings information, click the Table Customizer icon. See Customizing Table Views.
Finding Business Services
Select Operations > Smart Search.
From the Type drop-down list, select Business Services, then click Search. The Summary of Business Services page displays the information shown in Table 24-3.
To restrict the number of items in the list or locate specific business services:
Click the Open icon to display additional search filters. If you specify multiple search criteria, only results that match all the criteria will be returned.
Filter by business service name and path. In the Name and Path fields, enter the name and path of the search target, then click Search. The path is the project name and the name of the folder in which the business service resides. You can use * and ? as wildcard characters to perform a more general search.
Filter by service state. From the State drop-down list, select the business service state: Enabled or Disabled, then click Search. Select All to ignore the service state filter criteria.
Filter by service monitoring. From the Monitoring drop-down list, select the monitoring status of the business service: Enabled or Disabled, then click Search. Select All to ignore the service monitoring filter criteria.
Filter by business service’s SLA alerts setting. From the SLA Alerts drop-down list, select the SLA alerts setting of the business service: Enabled or Disabled, then click Search. Select All to ignore the service SLA alerts filter criteria.
The project associated with the business service. If the service resides in a project folder, this folder is also listed. The path is displayed in the format:
project-name/root-folder/ . . ./parent-folder
The path is a link to the corresponding path in the Project Explorer.
Type
The parent service type: business service.
State
The state of the business service: Enabled or Disabled.
Monitoring
The monitoring status of the business service: Enabled or Disabled.
SLA Alerts
The SLA alerts status: Enabled or Disabled, and the level enabled at and above: Normal (N), Warning (W), Minor (Mn), Major (Mj), Critical (C), or Fatal (F).
You can use this page also to do the following:
To remove the search filter and display all business services, click View All.
To discard your changes and refresh the page with the currently stored settings using the same search criteria, click Reset.
From within a session, to enable or disable any service-level settings, select or clear the check box next to it and click Update.
Note:
The run time effects of the service-level settings depend on their corresponding global settings. You must enable both the global and the service-level settings for a service to be completely enabled at run time. Additionally, SLA Alerts depends on both the global and service-level Monitoring states—both must be enabled for SLA alerts to be enabled at run time. See Enabling Global Settings.
Note:
In addition, the service State must also be enabled.
To customize your view of the operational settings information, click the Table Customizer icon. See Customizing Table Views.
Finding Split-Joins
Select Operations > Smart Search.
From the Type drop-down list, select Split-Joins, then click Search. The Summary of Split-Joins page displays the information shown in Table 24-4.
To restrict the number of items in the list or locate specific business services:
Click the Open icon to display additional search filters. If you specify multiple search criteria, only results that match all the criteria will be returned.
Filter by Split-Join name and path. In the Name and Path fields, enter the name and path of the search target, then click Search. The path is the project name and the name of the folder in which the Split-Join resides. You can use * and ? as wildcard characters to perform a more general search.
Filter by Split-Joins with logging. From the Logs drop-down list, select the logging status of the Split-Join: Enabled or Disabled, then click Search. Select All to ignore the logging filter criteria.
Filter by execution tracing. From the Execution Tracing drop-down list, select the execution tracing status of the Split-Join: Enabled or Disabled, then click Search. Select All to ignore the service logging filter criteria.
Table 24-4 Split-Join Summary Information
Property
Description
Name
The name assigned to the Split-Join. The name is a link to the Operational Settings page. See Editing Split-Joins.
Path
The project associated with the Split-Join. If the Split-Join resides in a project folder, this folder is also listed. The path is displayed in the format:
project-name/root-folder/ . . ./parent-folder
The path is a link to the corresponding path in the Project Explorer.
Type
The parent service type: Split-Join.
Logs
The logging status: Enabled or Disabled, and the level enabled at and above: Debug (D), Info (I), Warning (W), or Error (E).
Execution Tracing
The run-time tracing status of the Split-Join: Enabled or Disabled.
You can use this page also to do the following:
To remove the search filter and display all Split-Joins, click View All.
To discard your changes and refresh the page with the currently stored settings using the same search criteria, click Reset.
From within a session, to enable or disable any service-level settings, select or clear the check box next to it and click Update.
Note:
The run-time effects of the Split-Join-level settings depend on their corresponding global settings. You must enable both the global and the service-level settings for a service to be completely enabled at run time.
To customize your view of the operational settings information, click the Table Customizer icon. See Customizing Table Views.
Finding Alert Destinations
Select Operations > Smart Search.
From the Type drop-down list, select Alert Destinations, then click Search. The Summary of Alert Destinations page displays the information shown in Table 24-5.
To restrict the number of items in the list or locate specific alert destinations:
Click the Open icon to display additional search filters. If you specify multiple search criteria, only results that match all the criteria will be returned.
Filter by alert destination name and path. In the Name and Path fields, enter the name and path of the search target, then click Search. The path is the project name and the name of the folder in which the alert destination resides. You can use * and ? as wildcard characters to perform a more general search.
Filter by alert destination target. In the Target multi-select box, select one or more alert destination targets: SNMP Trap, Reports, e-mail, or JMS, then click Search. Only alert destinations with at least one of the selected targets will be displayed. Select no alert destination targets to ignore the alert destination filter criteria.
Filter by search pattern. In the Search Pattern (Any String) text box, specify any string, then click Search. The system uses the string to search all the Description fields of the alert destinations, as well as the specific detailed fields of the e-mail and JMS destinations. If the string appears in any of the alert destination fields, the alert destinations matching the search criteria are displayed.
Table 24-5 Alert Destinations Summary Information
Property
Description
Name
The name of the alert destination resource. This field is a link to the View Alert Destination - Configuration page. See Locating Alert Destinations.
Path
The project associated with the alert destination. If the alert destination resides in a project folder, this folder is also listed. The path is displayed in the format:
project-name/root-folder/ . . ./parent-folder
The path is a link to the corresponding path in the Project Explorer.
Options
Click the Delete icon to delete a specific alert destination. A Deletion Warning icon is displayed when other resources reference this resource. You can delete the resource with a warning confirmation. This might result in conflicts due to unresolved references to the deleted resource. See Deleting Alert Destinations.
You can use this page also to do the following:
To remove the search filter and display all alert destinations, click View All.
To delete a specific alert destination if not referenced by other resources, select the check box next to it and click Delete.
To customize your view of the operational settings information, click the Table Customizer icon. See Customizing Table Views.
Finding SLA Alert Rules
Select Operations > Smart Search.
From the Type drop-down list, select SLA Alerts, then click Search. The Summary of SLA Alert Rules page displays the information shown in Table 24-6.
To restrict the number of items in the list or locate specific SLA alert rules:
Click the Open icon to display additional search filters. If you specify multiple search criteria, only results that match all the criteria will be returned.
Filter by alert rule name. In the Name field, enter the name of the search target or enter wildcard characters (use * and ? as wildcard characters to perform a more general search), then click Search.
This search method is preferable if the name of the alert rule is unique across all projects and paths.
Filter by parent service path. In the Path field, enter the path of the parent service, which is the project name and the name of the folder in which parent service resides. You can use * and ? as wildcard characters to perform a more general search. All alert rules whose parent services reside in that path are displayed.
The format for the Path field is as follows: project-name/root-folder/ . . ./parent-folder
If a service is directly under the project, the format is as follows: project-name
Filter by parent service. In the Parent Service field, click Browse to display the Select Service page. Select the parent service from the list and click Submit. Click Clear to remove the parent service filter criteria, or click Search.
Note:
Your selection in the Parent Service field restricts your choices in the Service Type field.
Filter by parent service type. From the Service Type drop-down list, select Proxy Services or Business Services, then click Search. Select All Services to ignore filtering by parent service type criteria.
Note:
Your selection in the Service Type field restricts your choices in the Parent Service field.
Filter by rule state. From the Rule State drop-down list, select the state of the alert rule: Enabled or Disabled, then click Search. Select All to ignore the rule state filter criteria.
Filter by severity. From the Severity drop-down list, select to restrict SLA alerts rules to the specified level, then click Search.
Select the or above check box to restrict your search to the specified severity level or above (listed from the most inclusive to the most restrictive level): Normal, Warning, Minor, Critical, and Fatal.
Table 24-6 SLA Alert Rules Summary Information
Property
Description
Name
The name assigned to this alert rule. The name is a link to the Alert Rule Configuration page. See Viewing Alert Rule Configurations.
SLA State
The status of the alert rule: Enabled or Disabled.
Description
Note:
This field is hidden by default.
A description of the alert rule.
Service Name
The name of the parent service. The name is a link to the SLA Alert Rules page. See Viewing Alert Rules.
Path
The project associated with the parent service of the alert rule. If the parent service of the alert rule resides in a project folder, this folder is also listed. The path is displayed in the format:
project-name/root-folder/ . . ./parent-folder
The path is a link to the corresponding path in the Project Explorer.
Severity
The severity of the alert that is triggered by this rule: Normal, Warning, Minor, Major, Critical, or Fatal.
Aggr. Interval
The length of the aggregation interval in terms of hours and minutes.
Expiration Date
The date when this alert rule is no longer in effect.
Stop Processing
Note:
This field is hidden by default.
Displays Yes or No.
Frequency
The frequency of this alert:
Every Time
Notify Once
You can use this page also to do the following:
To remove the search filter and display all SLA Alert Rules, click View All.
To discard your changes and refresh the page with the currently stored settings using the same search criteria, click Reset.
From within a session, to enable or disable an SLA Alert Rule, select or clear the check box next to it and click Update.
To customize your view of the operational settings information, click the Table Customizer icon. See Customizing Table Views.
Enabling Global Settings
You can enable or disable all global settings only from within a session. Table 24-7 lists global settings tasks and help topics.
Table 24-7 Global Settings Tasks and Help Topics
To...
See...
Turn monitoring for all services on and off at the domain level
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Operations > Global Settings.
Select the Enable Monitoring check box for the system to start collecting monitoring statistics for all services whose monitoring is enabled at the service level.
Click Update to save all of the settings on this page.
Alternatively, click Reset at any time during the session to discard your changes and refresh the page with the currently stored settings.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Disabling Global Monitoring of Services
Note:
If you disable monitoring for all services, all statistics collected so far for those services are deleted as well. These statistics cannot be restored using the session Undo function. You can use Undo to enable monitoring again for the services, but the deletion of the statistics is irreversible.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Operations > Global Settings.
Clear the Enable Monitoring check box for the system to stop collecting monitoring statistics for all services in your configuration.
This option also overrides the Enable SLA Alerts option. If you disable monitoring at the global level, SLA alerts will also be disabled at run time as well, even though the corresponding Enable SLA Alerts check box may be selected. See Enabling SLA Alerts Globally.
Click Update. The monitoring configuration is saved in the current session.
Alternatively, click Reset at any time during the session to discard your changes and refresh the page with the currently stored settings.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Enabling SLA Alerts Globally
Although you can configure SLA Alerts independently from Monitoring, there is an interaction between the two settings at run time. If global monitoring is enabled, SLA alerts can be enabled or disabled. However, if global monitoring is disabled then SLA alerts will be effectively disabled because SLA alert rule conditions depend on monitoring statistics being evaluated.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Operations > Global Settings.
Select the Enable SLA Alerts check box for the system to start evaluating alert rules for all services in your configuration.
Click Update to save all of the settings on this page.
Alternatively, click Reset at any time during the session to discard your changes and refresh the page with the currently stored settings.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Disabling SLA Alerts Globally
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Operations > Global Settings.
Clear the Enable SLA Alerts check box for the system to stop evaluating alert rules for all services in your configuration.
Click Update. The pipeline alerts configuration is saved in the current session.
Alternatively, click Reset at any time during the session to discard your changes and refresh the page with the currently stored settings.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Enabling Message Reporting Globally
This option controls pipeline Report actions on the message context only. It does not effect SLA alerts or pipeline alerts targeted to the reporting framework.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Operations > Global Settings.
Select the Enable Reporting check box to start any pipeline Report actions for all proxy services.
Click Update to save all of the settings on this page.
Alternatively, click Reset at any time during the session to discard your changes and refresh the page with the currently stored settings.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Disabling Message Reporting Globally
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Operations > Global Settings.
Clear the Enable Reporting check box to stop any pipeline Report actions for all proxy services.
Click Update. The message reporting configuration is saved in the current session.
Alternatively, click Reset at any time during the session to discard your changes and refresh the page with the currently stored settings.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Enabling Logging Globally
If you select Enable Logging, pipeline Log action messages are sent to the WebLogic Server logging service. To be able to view them, you must configure WebLogic Server to forward these messages to the domain log.
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Operations > Global Settings.
Select the Enable Logging check box to start any pipeline Log actions for all proxy services.
Click Update to save all of the settings on this page.
Alternatively, click Reset at any time during the session to discard your changes and refresh the page with the currently stored settings.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Disabling Logging Globally
If you have not already done so, click Create to create a new session or click Edit to enter an existing session. See Using the Change Center.
Select Operations > Global Settings.
Clear the Enable Logging check box to stop any pipeline Log actions for all proxy services.
Click Update. The logging configuration is saved in the current session.
Alternatively, click Reset at any time during the session to discard your changes and refresh the page with the currently stored settings.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Setting User Preferences
Use this page to customize and persist your console display options and settings. You can update (change) your User Preferences without activating a change session.
Table 24-8 describes the options and controls on the page.
Table 24-8 User Preferences - Options and Controls
To...
Do This...
Change your Home Page, the page that opens when you launch the console
From the first drop-down list, select any main menu choice: Operations, Resource Browser, Project Explorer, SecurityConfiguration, or System Administration.
From the second drop-down list, select any one of the sub-menu choices. (The contents of the sub-menus dynamically change based on your first menu selection.)
Display Search Filters
Select Yes or No.
By default, search filters are not displayed (closed). By selecting Yes, search filters are always displayed (open).
Display Stage Annotations
Select Yes or No.
By default, pipeline stage annotations are not displayed (closed). By selecting Yes, stage annotations are always displayed (open).
Display Resource Metadata
Select Yes or No.
By default, resource metatdata sections are displayed (open). By selecting No, resource metatdata sections are not displayed (closed).
Change how often the console updates the display of data on the Dashboard
From the Dashboard Refresh Rate drop-down list, select No Refresh, 1, 2, 3, 5, 10, 20, 30 or 60 minutes as the refresh rate for the Dashboard.
The default rate is No Refresh, but you can select another predefined time. For example, if you select 5 minutes, the Dashboard is updated with data every 5 minutes.
WARNING:
By selecting a dashboard refresh rate interval other than the default (No Refresh), the browser refreshes the Dashboard at regular intervals. This prevents your session from timing out, even without you interacting with the console.
WARNING:
Oracle recommends that you use the Dashboard refresh rate feature with caution. You should never leave a console session unattended. While your console session is active others can gain access to it from your machine, without re-authentication.
Change the time interval for displaying historical data for alerts on the Dashboard
From the Alert History Duration drop-down list, select 30 minutes, 1, 2, 3, or 6hours as the time interval for displaying historical alert data. The default is 30 minutes (displays alerts received within the last 30 minutes) but you can select another predefined duration. For example, if you select 1 hour, the Dashboard displays the alerts received within the last hour.