Using the AquaLogic Service Bus Console

Monitoring

This section includes the following topics:

Overview of Monitoring

When you create a business or proxy service, monitoring is disabled by default for that service. To explicitly enable monitoring for the service, set an aggregation interval over which statistics are computed and define alert rules for that service, you must use the Monitoring Configuration page. You can access this page from the Resource Browser or Project Explorer module. In the Actions column for the service, click the Manage Monitoring icon. To learn more, see Listing and Locating Alert Rules.

Note: The aggregation interval is the period over which aggregated statistics are computed for display in the console. The aggregation interval set from the Monitoring Configuration page has no effect on when alert rules are triggered. Each alert rule allows you to specify the aggregation interval for that rule when configuring the alert rule.

Note: When you are in a session, the Enable Monitoring option on the Global Settings page of the System Administration module enables you to enable or disable monitoring of all services that have individually been enabled for monitoring. To learn more, see Enabling Monitoring.

The following table lists the pages you can access from the Monitoring module. The tasks and help topics associated with each are provided.

Page	Associated Tasks	Help Topics
Dashboard	View Dashboard statistics	Viewing the Dashboard Statistics
Service Monitoring Summary	View a summary of services	Listing and Locating Services
Service Monitoring Details - [service name]	View details of a specific service	Viewing Service Monitoring Details
Server Summary	View a summary of servers	Listing and Locating Servers
Server Summary	Customize your view of the server summary	Listing and Locating Servers
Server Details	View details of a specific server	Viewing Server Details
Customized System Alert History	View a summary of alerts	Listing and Locating Alerts
Customized System Alert History	Search for alerts	Listing and Locating Alerts
System Alert Details	View alert details	Viewing Alert Details
Monitoring Configuration - [service name]	Configure monitoring for specific services	Configuring Monitoring for Specific Services
Monitoring Configuration - [service name]	List and locate alert rules	Listing and Locating Alert Rules

Alerts

BEA AquaLogic Service Bus implements Service Level Agreements (SLAs) and automated responses to SLA violations by enabling you to define rules that specify unacceptable service performance and the system response you require under those circumstances. You can construct rules that AquaLogic Service Bus evaluates against its aggregated metrics each time it updates that data. When a rule evaluates to true, it raises an alert. Rules can be configured to generate an Alert Log that is displayed on the Dashboard. In addition, AquaLogic Service Bus executes the action you specified for the rule when it evaluates to true. You can assign any of the following types of actions to a rule:

Send email notification
Send a JMS message

To learn about creating alert rules, see Creating an Alert Rule.

Note: When an alert is fired in your configuration, an entry is made to your domain log, which resides at the following location:

BEA_HOME\servers\server_name\logs\domain_name.log

Where domain_name represents the name you assigned your AquaLogic Service Bus domain when you created it.

The message is logged as an alert and has this message ID: BEA-394015

The message body is a string that consists of the following elements:

Alert Rule ID
Alert Rule Name
Severity
Timestamp
Name of the service associated with the alert

Viewing the Dashboard Statistics

The Dashboard page enables you to view service monitoring, server, and alerts information. When you create a business or proxy service, monitoring is disabled by default for that service. To explicitly enable monitoring for the service and set an aggregation interval over which statistics are computed for that service, you must visit the Monitoring Configuration page. You can access this page from the Resource Browser or Project Explorer module. In the Actions column for the service, click the Manage Monitoring icon.To learn more, see Listing and Locating Alert Rules.

At run time, the default refresh rate for this page is one minute. However, depending on the timing of the alert rule, it may take up to three minutes for the information to refresh. To learn more, see "Refresh Rate of Monitored Information" in Monitoring in the BEA AquaLogic Service Bus User Guide.

This page includes the following information:

Property	Description
Service Summary (30 mins)	The Service Summary panel includes the following attributes: A pie chart of the services with alerts over the past 30 minutes, which is the default interval. This information is gathered from the alert log. You can click the area in the chart corresponding to the alert severity to display more details. The percentage of services that have normal, warning, minor, major, critical, and fatal alerts. A list of the services with the most alerts in the current aggregation interval. Each service name is a link to the service monitoring details. To learn more, see Viewing Service Monitoring Details. A link to the Service Monitoring Summary page. To display the list of services, click View Service Monitoring Summary. To learn more, see Listing and Locating Services. Note: To display service summary information only on this page, you can click the Maximize icon in the right-hand corner of the Service Summary panel.
Server Summary	The Server Summary panel includes the following attributes: A pie chart of the servers that have monitoring enabled. You can click the area in the chart that corresponds to the server to display more details. A list of the most critical servers. Each server name is a link to the server details. To learn more, see Listing and Locating Servers. A link to the Server Summary page. To display the list of servers, click View Server Summary List. To learn more, see Listing and Locating Servers. A link to the Server Summary Log. To display the log, click View Log Summary. To learn more, see Viewing Server Log Files. Note: To display server summary information only on this page, you can click the Maximize icon in the right-hand corner of the Server Summary panel.
Alert Summary (30 mins)	The Alert Summary panel includes the following attributes: A link that enables you to customize the table of alerts on this page. To display the list of options, click Customize table. To learn more, see To Customize the Alert Summary Table. A link to the Customized System Alert History page. To display the list of alerts, click View Alert Summary List. To learn more, see Listing and Locating Alerts. Fields that display alert information depending on your customized settings for the alert table. For example, alert severity, timestamp, alert name, and the names of the service and project associated with the alert. To learn more about these fields, see Listing and Locating Alerts. The Alert Summary displays alerts for the past 30 minutes only. This is a sliding window. Any alerts older than 30 minutes are not available on the Dashboard page. The number of alerts on the page match the pie chart that displays on the Service Summary panel, which displays the breakdown of the number of alerts over the past 30 minutes. Note: To display alert summary information only on this page, you can click the Maximize icon in the right-hand corner of the Alert Summary panel. Note: To learn more about alerts, see Alerts.

Property

Description

Service Summary (30 mins)

The Service Summary panel includes the following attributes:

A pie chart of the services with alerts over the past 30 minutes, which is the default interval. This information is gathered from the alert log. You can click the area in the chart corresponding to the alert severity to display more details.

The percentage of services that have normal, warning, minor, major, critical, and fatal alerts.

A list of the services with the most alerts in the current aggregation interval. Each service name is a link to the service monitoring details. To learn more, see Viewing Service Monitoring Details.

A link to the Service Monitoring Summary page. To display the list of services, click View Service Monitoring Summary. To learn more, see Listing and Locating Services.

Note: To display service summary information only on this page, you can click the Maximize icon in the right-hand corner of the Service Summary panel.

Server Summary

The Server Summary panel includes the following attributes:

A pie chart of the servers that have monitoring enabled. You can click the area in the chart that corresponds to the server to display more details.

A list of the most critical servers. Each server name is a link to the server details. To learn more, see Listing and Locating Servers.

A link to the Server Summary page. To display the list of servers, click View Server Summary List. To learn more, see Listing and Locating Servers.

A link to the Server Summary Log. To display the log, click View Log Summary. To learn more, see Viewing Server Log Files.

Note: To display server summary information only on this page, you can click the Maximize icon in the right-hand corner of the Server Summary panel.

Alert Summary (30 mins)

The Alert Summary panel includes the following attributes:

A link that enables you to customize the table of alerts on this page. To display the list of options, click Customize table. To learn more, see To Customize the Alert Summary Table.

A link to the Customized System Alert History page. To display the list of alerts, click View Alert Summary List. To learn more, see Listing and Locating Alerts.

Fields that display alert information depending on your customized settings for the alert table. For example, alert severity, timestamp, alert name, and the names of the service and project associated with the alert. To learn more about these fields, see Listing and Locating Alerts.

The Alert Summary displays alerts for the past 30 minutes only. This is a sliding window. Any alerts older than 30 minutes are not available on the Dashboard page. The number of alerts on the page match the pie chart that displays on the Service Summary panel, which displays the breakdown of the number of alerts over the past 30 minutes.

Note: To display alert summary information only on this page, you can click the Maximize icon in the right-hand corner of the Alert Summary panel.

Note: To learn more about alerts, see Alerts.

To Customize the Alert Summary Table

Click Customize table. Additional fields are displayed.

Note: You can click Close table customizer at any time to close this table and retain the original settings.

In the Columns Display field, select the columns you want to display:

Select a column name from the Available field.

Click the arrow to move this column name to the Chosen field.

Repeat until you have listed all the column names you want to display in the Chosen field.

Note: In the Chosen field, you can use the Up and Down arrows to reorder the column names as required.

Do one of the following:

To save these settings, click Apply.
To discard your changes and retain the original settings, click Reset.

Listing and Locating Services

The Service Monitoring Summary page displays the list of services that have monitoring enabled. To learn how to enable monitoring for a service, see Configuring Monitoring for Specific Services.

To List and Locate Services that have Monitoring Enabled

From the left navigation pane, select Monitoring. The Dashboard page is displayed.

In the Service Summary panel, click View Service Monitoring Summary. The Service Monitoring Summary page is displayed, which displays statistics for each service.

In the Show Metrics For field, do one of the following:

To display monitoring statistics for each service for the period of the current aggregration interval, select Current Aggregation Interval. Current Aggregation Interval displays a moving statistic view of the service metrics
To display monitoring statistics for the period since you last clicked Reset All Statistics on the Global Settings page to reset statistics for all services, select Since Last Reset. Since Last Reset displays a running count of the metrics.

The following information is displayed for each service:

Property

Description

Name

The name assigned to the service. The name is a link to Service Monitoring Details page. To learn more, see Viewing Service Monitoring Details.

Path

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

Aggregation Interval

The current aggregation interval set for monitoring this service, in terms of hours and minutes. You set this interval on the Monitoring Configuration page. To learn more, see Setting the Aggregation Interval for a Service.

This field is displayed only when you have selected Current Aggregation Interval in the Show Metrics For field.

Avg. Exec Time

The average execution time (in msec) for this service for the period of the current aggregation interval or for the period since the last reset.

Message Count

The number of messages associated with this service for the period of the current aggregation interval or for the period since the last reset.

Error Count

The number of error messages associated with this service for the period of the current aggregation interval or for the period since the last reset.

Alert Count

The number of alerts associated with this service for the period of the current aggregation interval or for the period since the last reset.

Action

In this column, you can click the Reset Statistics icon for a specific service to reset the statistics for that service. When you confirm you want to do this, the system deletes all monitoring statistics that were collected for the service since the last time you clicked the Reset Statistics icon or the last time you clicked Reset All Statistics on the Global Settings page. However, the system does not delete the statistics being collected during the Current Aggregation Interval for the service. Additionally, after you click the Reset Statistics icon, the system immediately starts collecting monitoring statistics for the service again.

This field is displayed only when you have selected Since Last Reset in the Show Metrics For field.

Property	Description
Name	The name assigned to the service. The name is a link to Service Monitoring Details page. To learn more, see Viewing Service Monitoring Details.
Path	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`
Aggregation Interval	The current aggregation interval set for monitoring this service, in terms of hours and minutes. You set this interval on the Monitoring Configuration page. To learn more, see Setting the Aggregation Interval for a Service. This field is displayed only when you have selected Current Aggregation Interval in the Show Metrics For field.
Avg. Exec Time	The average execution time (in msec) for this service for the period of the current aggregation interval or for the period since the last reset.
Message Count	The number of messages associated with this service for the period of the current aggregation interval or for the period since the last reset.
Error Count	The number of error messages associated with this service for the period of the current aggregation interval or for the period since the last reset.
Alert Count	The number of alerts associated with this service for the period of the current aggregation interval or for the period since the last reset.
Action	In this column, you can click the Reset Statistics icon for a specific service to reset the statistics for that service. When you confirm you want to do this, the system deletes all monitoring statistics that were collected for the service since the last time you clicked the Reset Statistics icon or the last time you clicked Reset All Statistics on the Global Settings page. However, the system does not delete the statistics being collected during the Current Aggregation Interval for the service. Additionally, after you click the Reset Statistics icon, the system immediately starts collecting monitoring statistics for the service again. This field is displayed only when you have selected Since Last Reset in the Show Metrics For field.

To locate a specific service, do one of the following:

Filter by service name. In the Name field, enter the name of the search target, then click Search. The services matching the search criteria are displayed.

Note: 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. All the services that reside in that path are displayed.

Note: 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 services with alerts. Select the Has Alerts option, then click Search. The services matching the search criteria are displayed.
Filter by services with errors. Select the Has Errors option, then click Search. The services matching the search criteria are displayed.
Filter by proxy service. Select the Invoked by Proxy option, enter the name and path of a proxy service in the field provided, then click Search. The business services invoked by the proxy service you specified are displayed.
Resort the list. Ascending and descending arrow buttons indicate sortable columns. Click the button to change the sort order.
Scroll through the pages. Use the controls in the lower right corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.

This page also enables you to do the following:

To remove the search filter and display all services, click View All.
To update this page with the latest information, click Refresh.

Note: When you click Refresh, the Service Monitoring Summary page is refreshed with statistics for all services. Any search criteria you have selected for this page are removed; therefore you need to apply the search criteria again. As an alternative to Refresh, you can click Search every few minutes to maintain your search criteria. Clicking Refresh is preferable only when you do not have any search criteria selected for this page.

To return to the Dashboard page, click Back. To learn more, see Viewing the Dashboard Statistics.

Configuring Monitoring for Specific Services

The Monitoring Configuration - [service name] page enables you to enable and disable monitoring for specific services.

To Configure Monitoring for a Specific Service

If you have not already done so, from the left navigation pane, under Change Center, click Create to create a new session for making changes to the current configuration. For more information, see Using the Change Center.

From the left navigation pane, select Business Services or Proxy Services from under Resource Browser. Depending on what you select, the Summary of Business Services or Summary of Proxy Services page is displayed.

In the Actions column, select the Manage Monitoring icon for a specific service. The Monitoring Configuration - [service name] page is displayed for the service.

Do one of the following:

To disable a service that is currently enabled, clear the Enable Service checkbox, then click Update. When you activate the session, the system deletes all monitoring statistics previously collected for the service. The system also stops evaluating any alert rules configured for the service; therefore, you no longer receive alerts associated with the service.
To disable monitoring for the service that is currently enabled, clear the Enable Monitoring checkbox, then click Update. When you activate the session, the system stops collecting monitoring statistics for the service, and deletes any statistics collected previously.
To enable a service that is currently disabled, select the Enable Service checkbox, then click Update. When you activate the session, the system starts evaluating any alert rules configured for the service; therefore, you may start to receive alerts associated with the service.
To enable monitoring for the service that is currently disabled, select the Enable Monitoring checkbox, then click Update. When you activate the session, the system starts collecting monitoring statistics for the service. You must also select an aggregation interval for the service when you select the Enable Monitoring checkbox.
To select an aggregation interval for the service, make sure the Enable Monitoring checkbox is selected, select the interval in terms of hours or minutes, then click Update. If your selection for hours exceeds 0, then the default selection for minutes is always zero. However, if your selection for hours is 0, then you can configure intervals in terms of minutes. To learn more, see Setting the Aggregation Interval for a Service.

Note: The updates are saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

The Monitoring Configuration - [service name] page also enables you to do the following:

To...	Do This...
List and locate alert rules	See Listing and Locating Alert Rules.
Add a new alert rule	Click Add New. To learn more, see Creating an Alert Rule.

Note: Suppose a proxy service ProxyService1 currently exists in your configuration that has monitoring enabled and an alert rule AlertRule1 configured. The Aggregation Interval for this proxy service is set to 10 minutes. You import a configuration JAR file that includes the same proxy service ProxyService1, which does not have monitoring enabled and does not have alert rules associated with it. After the import, monitoring is disabled and the Aggregation Interval is set to zero. However, the Summary of Alerts list still contains AlertRule1. Therefore, you must enable monitoring again and reset the aggregation interval for ProxyService1, but you do not need to recreate the alert rules associated with this proxy service.

Setting the Aggregation Interval for a Service

The Monitoring Configuration - [Service Name] page enables you to set the aggregation interval for a specific service.

Warning: If you change the aggregation interval for a service, for example from 20 minutes to 30 minutes, the statistical information collected so far for all the services and alerts associated with that service is deleted. The Service Monitoring Summary page shows all statistics as zero. The system starts to collect statistics again from zero.

To Set the Aggregation Interval for a Service

From the left navigation pane, select Proxy Services or Business Services from under Resource Browser.

In the Actions column, click the Manage Monitoring icon for the proxy service or business service for which you want to set the aggregation interval. The Monitoring Configuration - [Service Name] page is displayed.

Make sure the Enable Service checkbox is selected.

Select the Enable Monitoring checkbox to enable monitoring for the service.

In the Select Aggregation Interval for the service field, select the length of the aggregation interval in terms of hours and minutes, then click Update. If your selection for hours exceeds 0, then the default selection for minutes is always zero. However, if your selection for hours is 0, then you can configure intervals in terms of minutes.

Viewing Service Monitoring Details

The Service Monitoring Details page enables you to view monitoring details of a specific service.

To View Monitoring Details of a Service

Locate the service in the Monitoring module. To learn more, see Listing and Locating Services.

Click the name of the service.

In the Show Metrics For field, do one of the following:

To display monitoring statistics for the service for the period of the current aggregration interval, select Current Aggregation Interval. Current Aggregation Interval displays a moving statistic view of the service metrics.
To display monitoring statistics for this service for the period since you last clicked the Reset Statistics icon or since you last clicked Reset All Statistics on the Global Settings page to reset statistics for all services, select Since Last Reset. Since Last Reset displays a running count of the metrics.

If you select Current Aggregation Interval, the Service Monitoring Details page displays the following information:

Property

Description

Alert Status

The alert status for this service as of the current time and date. For example, it may display the following status:

Normal at 11:57:32 AM November 16, 2005

Aggregation Interval

The current aggregation interval set for monitoring this service, in terms of hours and minutes. You set this interval on the Monitoring Configuration page. To learn more, see Setting the Aggregation Interval for a Service.

Alerts for Last Aggregation Interval

The total number of alerts associated with this service within the last aggregation interval.

Alert History

This is a link to the Customized System Alert History page, which displays the total number of alerts in the system since the last time you reset statistics. To learn more, see Listing and Locating Alerts.

Location Path

The location of this service; that is, the project and folder where it resides in your configuration.

Display Metrics For

Select a server from the drop-down list to display metrics for that server.

Note: For a single node, only one item displayed in this drop-down list. If a cluster exists, then more items are displayed.
If you select Since Last Reset, the Service Monitoring Details page displays the following information:

Property

Description

Alerts since last reset

The total number of alerts associated with this service since you last clicked the Reset Statistics icon for the service or since you last clicked Reset All Statistics on the Global Settings page to reset statistics for all services.

Alert History

This is a link to the Customized System Alert History page, which displays the total number of alerts in the system since the last time you reset statistics. To learn more, see Listing and Locating Alerts.

Location Path

The location of this service; that is, the project and folder where it resides in your configuration.

Display Metrics For

Select a server from the drop-down list to display metrics for that server.

Note: For a single node, only one item displayed in this drop-down list. If a cluster exists, then more items are displayed.
The page displays the following Operations information:

Note: If there are multiple pages of statistics for operations, you can scroll through the pages by using the arrow button controls in the lower right corner. You can also go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.

Property

Description

Operations

The operations associated with this service

Message Count

If you have selected Current Aggregation Interval in the Show Metrics For field, the total number of messages that this operation has executed within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the total number of messages that this operation has executed within the period since you last reset statistics.

Error Count

If you have selected Current Aggregation Interval in the Show Metrics For field, the number of messages with errors that this operation has executed within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the number of messages with errors that this operation has executed within the period since you last reset statistics.

Min Resp. Time

If you have selected Current Aggregation Interval in the Show Metrics For field, the minimum response time this operation has taken to execute messages within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the minimum response time this operation has taken to execute messages within the period since you last reset statistics.

Max Resp Time

If you have selected Current Aggregation Interval in the Show Metrics For field, the maximum response time this operation has taken to execute messages within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the maximum response time this operation has taken to execute messages within the period since you last reset statistics.

Avg. Exec Time

If you have selected Current Aggregation Interval in the Show Metrics For field, the overall average time this operation has taken to execute messages within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the overall average time this operation has taken to execute messages within the period since you last reset statistics.
The page displays the following Performance information:

Property

Description

Min Response Time

If you have selected Current Aggregation Interval in the Show Metrics For field, the minimum response time this service has taken to execute messages within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the minimum response time this service has taken to execute messages within the period since you last reset statistics.

Max Response Time

If you have selected Current Aggregation Interval in the Show Metrics For field, the maximum response time this service has taken to execute messages within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the maximum response time this service has taken to execute messages within the period since you last reset statistics.

Overall Avg. Execution Time (msecs)

If you have selected Current Aggregation Interval in the Show Metrics For field, the overall average time this service has taken to execute messages within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the overall average time this service has taken to execute messages within the period since you last reset statistics.

Total Number of Messages

If you have selected Current Aggregation Interval in the Show Metrics For field, the total number of messages that this service has executed within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the total number of messages that this service has executed within the period since you last reset statistics.

Messages With Errors

If you have selected Current Aggregation Interval in the Show Metrics For field, the number of messages with errors that this service has executed within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the number of messages with errors that this service has executed within the period since you last reset statistics.

Failover Count

For business services only:

If you have selected Current Aggregation Interval in the Show Metrics For field, the number of failover messages that this service has executed within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the number of failover messages that this service has executed within the period since you last reset statistics.

Success Ratio (%)

If you have selected Current Aggregation Interval in the Show Metrics For field, the success ratio of this service within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the success ratio of this service within the period since you last reset statistics.

For example, if the service has executed 9 out of 10 messages successfully, then the success ratio is 90%.

Failure Ratio (%)

If you have selected Current Aggregation Interval in the Show Metrics For field, the failure ratio of this service within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the failure ratio of this service within the period since you last reset statistics.

For example, if the service has failed to execute 1 out of 10 messages, then the failure ratio is 10%.

Number of WS Security Errors

If you have selected Current Aggregation Interval in the Show Metrics For field, the number of messages with WS security errors that this service has executed within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the number of messages with WS security errors that this service has executed within the period since you last reset statistics.

Number of Validation Errors

For business services: N/A is displayed.

For proxy services:

If you have selected Current Aggregation Interval in the Show Metrics For field, the number of messages with validation errors that this service has executed within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the number of messages with validation errors that this service has executed within the period since you last reset statistics.
If this is a proxy service that has pipelines, the page displays the following Flow Components information:

Note: If there are multiple pages of statistics for flow components, you can scroll through the pages by using the arrow button controls in the lower right corner. You can also go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.

Property

Description

Component Name

The name of the component.

Message Count

If you have selected Current Aggregation Interval in the Show Metrics For field, the total number of messages that this component has executed within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the total number of messages that this component has executed within the period since you last reset statistics.

Error Count

If you have selected Current Aggregation Interval in the Show Metrics For field, the number of messages with errors that this component has executed within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the number of messages with errors that this component has executed within the period since you last reset statistics.

Avg. Execution Time (msecs)

If you have selected Current Aggregation Interval in the Show Metrics For field, the overall average time this component has taken to execute messages within the period of the current aggregation interval.

If you have selected Since Last Reset in the Show Metrics For field, the overall average time this component has taken to execute messages within the period since you last reset statistics.

Property	Description
Alert Status	The alert status for this service as of the current time and date. For example, it may display the following status: `Normal at 11:57:32 AM November 16, 2005`
Aggregation Interval	The current aggregation interval set for monitoring this service, in terms of hours and minutes. You set this interval on the Monitoring Configuration page. To learn more, see Setting the Aggregation Interval for a Service.
Alerts for Last Aggregation Interval	The total number of alerts associated with this service within the last aggregation interval.
Alert History	This is a link to the Customized System Alert History page, which displays the total number of alerts in the system since the last time you reset statistics. To learn more, see Listing and Locating Alerts.
Location Path	The location of this service; that is, the project and folder where it resides in your configuration.
Display Metrics For	Select a server from the drop-down list to display metrics for that server. Note: For a single node, only one item displayed in this drop-down list. If a cluster exists, then more items are displayed.

Property	Description
Alerts since last reset	The total number of alerts associated with this service since you last clicked the Reset Statistics icon for the service or since you last clicked Reset All Statistics on the Global Settings page to reset statistics for all services.
Alert History	This is a link to the Customized System Alert History page, which displays the total number of alerts in the system since the last time you reset statistics. To learn more, see Listing and Locating Alerts.
Location Path	The location of this service; that is, the project and folder where it resides in your configuration.
Display Metrics For	Select a server from the drop-down list to display metrics for that server. Note: For a single node, only one item displayed in this drop-down list. If a cluster exists, then more items are displayed.

Property	Description
Operations	The operations associated with this service
Message Count	If you have selected Current Aggregation Interval in the Show Metrics For field, the total number of messages that this operation has executed within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the total number of messages that this operation has executed within the period since you last reset statistics.
Error Count	If you have selected Current Aggregation Interval in the Show Metrics For field, the number of messages with errors that this operation has executed within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the number of messages with errors that this operation has executed within the period since you last reset statistics.
Min Resp. Time	If you have selected Current Aggregation Interval in the Show Metrics For field, the minimum response time this operation has taken to execute messages within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the minimum response time this operation has taken to execute messages within the period since you last reset statistics.
Max Resp Time	If you have selected Current Aggregation Interval in the Show Metrics For field, the maximum response time this operation has taken to execute messages within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the maximum response time this operation has taken to execute messages within the period since you last reset statistics.
Avg. Exec Time	If you have selected Current Aggregation Interval in the Show Metrics For field, the overall average time this operation has taken to execute messages within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the overall average time this operation has taken to execute messages within the period since you last reset statistics.

Property	Description
Min Response Time	If you have selected Current Aggregation Interval in the Show Metrics For field, the minimum response time this service has taken to execute messages within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the minimum response time this service has taken to execute messages within the period since you last reset statistics.
Max Response Time	If you have selected Current Aggregation Interval in the Show Metrics For field, the maximum response time this service has taken to execute messages within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the maximum response time this service has taken to execute messages within the period since you last reset statistics.
Overall Avg. Execution Time (msecs)	If you have selected Current Aggregation Interval in the Show Metrics For field, the overall average time this service has taken to execute messages within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the overall average time this service has taken to execute messages within the period since you last reset statistics.
Total Number of Messages	If you have selected Current Aggregation Interval in the Show Metrics For field, the total number of messages that this service has executed within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the total number of messages that this service has executed within the period since you last reset statistics.
Messages With Errors	If you have selected Current Aggregation Interval in the Show Metrics For field, the number of messages with errors that this service has executed within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the number of messages with errors that this service has executed within the period since you last reset statistics.
Failover Count	For business services only: If you have selected Current Aggregation Interval in the Show Metrics For field, the number of failover messages that this service has executed within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the number of failover messages that this service has executed within the period since you last reset statistics.
Success Ratio (%)	If you have selected Current Aggregation Interval in the Show Metrics For field, the success ratio of this service within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the success ratio of this service within the period since you last reset statistics. For example, if the service has executed 9 out of 10 messages successfully, then the success ratio is 90%.
Failure Ratio (%)	If you have selected Current Aggregation Interval in the Show Metrics For field, the failure ratio of this service within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the failure ratio of this service within the period since you last reset statistics. For example, if the service has failed to execute 1 out of 10 messages, then the failure ratio is 10%.
Number of WS Security Errors	If you have selected Current Aggregation Interval in the Show Metrics For field, the number of messages with WS security errors that this service has executed within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the number of messages with WS security errors that this service has executed within the period since you last reset statistics.
Number of Validation Errors	For business services: N/A is displayed. For proxy services: If you have selected Current Aggregation Interval in the Show Metrics For field, the number of messages with validation errors that this service has executed within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the number of messages with validation errors that this service has executed within the period since you last reset statistics.

Property	Description
Component Name	The name of the component.
Message Count	If you have selected Current Aggregation Interval in the Show Metrics For field, the total number of messages that this component has executed within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the total number of messages that this component has executed within the period since you last reset statistics.
Error Count	If you have selected Current Aggregation Interval in the Show Metrics For field, the number of messages with errors that this component has executed within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the number of messages with errors that this component has executed within the period since you last reset statistics.
Avg. Execution Time (msecs)	If you have selected Current Aggregation Interval in the Show Metrics For field, the overall average time this component has taken to execute messages within the period of the current aggregation interval. If you have selected Since Last Reset in the Show Metrics For field, the overall average time this component has taken to execute messages within the period since you last reset statistics.

To return to the Service Monitoring Summary page, click Back. To learn more, see Listing and Locating Services.

Listing and Locating Servers

The Server Summary page displays information for each server, depending on the filter settings you have specified. To learn more, see Customizing Your View of the Server Summary.

To List and Locate Servers

From the left navigation pane, select Dashboard from under Monitoring. The Dashboard page is displayed.

In the Server Summary panel, select the pie chart or click View Server Summary List. The Server Summary page is displayed. These are the fields that the page can display. For a more detailed description of each server, see Viewing Server Details.

Property	Description
Status	The status of the server: Fatal—the server has failed and must be restarted. Critical—server failure pending; something must be done immediately to prevent failure. Check the server logs and the corresponding Runtime MBean for more details. Warning—the server could have problems in the future. Check the server logs and the corresponding RuntimeMBean for more details. OK—the server is functioning without any problems Overloaded—the server has more work assigned to it than the configured threshold; it might refuse more work.
Server	The name of the server. The name is a link to the View Server Details page. To learn more, see Viewing Server Details.
Cluster Name	The name of the cluster associated with this server.
Machine Name	The name of the machine associated with this server.
State	The state of the server: RUNNING FAILED SHUTDOWN
Uptime	The length of time this server has been running.

To locate a specific server, do one of the following:

Resort the list. Ascending and descending arrow buttons indicate sortable columns. Click the button to change the sort order.
Scroll through the pages. Use the controls in the lower right corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.

The Server Summary page also enables you to do the following:

To display the list of servers in a pie chart or bar chart, click View as Graph. To learn more, see Viewing a Chart of Servers.
To customize your view of the server information, click Customize table. To learn more, see Customizing Your View of the Server Summary.
To update the page with the latest information, click Refresh.

Customizing Your View of the Server Summary

The Server Summary page enables you to customize the display of information for each server. For a description of each field, see Listing and Locating Servers.

To Customize Your View of the Server Summary

From the left navigation pane, select Dashboard from under Monitoring. The Dashboard page is displayed.

In the Server Summary panel, select the pie chart or click View Server Summary List. The Server Summary page is displayed.

On the Server Summary page, click Customize table. Additional fields are displayed.

Note: You can click Close table customizer at any time to close this table and retain the original settings.

In the Server Summary Table Filter fields, do the following:

Select the Severity checkbox to include severity in the filter criteria, then select the alert severity: All, Critical, Fatal, Overloaded, OK or Warning.

Select the Server checkbox to include server names in the filter criteria, then select All or select a specific server name.

Select the Cluster Name checkbox to include cluster names in the filter criteria, then select All or select a specific cluster name.

Select the Machine Name checkbox to include machine names in the filter criteria, then select All or select a machine name.

Select the State checkbox to include server states in the filter criteria, then select a server state: All, RUNNING, FAILED, or SHUTDOWN.

In the Columns Display field, select the names of the columns you want to display:

Select a column name from the Available field.

Click the arrow to move this column name to the Chosen field.

Repeat until you have listed all the column names you want to display in the Chosen field.

Note: In the Chosen field, you can use the Up and Down arrows to reorder the column names as required.

In the Number of rows displayed per page, select the number of rows you want to display on a single page. You can select 10, 20, or 30.

In the Maximum Results Returned field, select the maximum number of results you want to display in total. You can select 10, 20, or 30.

Do one of the following:

To save the new settings, click Apply.
To discard your changes and retain the original settings, click Reset.

Viewing a Chart of Servers

The Server Summary page enables you to view a pie chart and bar chart of server data. A pie chart is displayed by default.

This page enables you to do the following:

To display an updated version of the data, click Refresh chart information.
To display the data in tabular format, click View data as table. To learn more, see Listing and Locating Servers.
To display the same data in a bar chart, click View as bar chart.

Viewing Server Log Files

The Server Log Summary page enables you to view a summary of domain log file entries.

To View Domain Log File Entries

From the left navigation pane, select Dashboard from under Monitoring. The Dashboard page is displayed.

In the Server Summary panel, click View Log Summary. A table is displayed, which displays the number of messages currently raised by the system. The server message information is grouped according to its severity: Alert, Critical, Emergency, Error, Info, Notice, and Warning.

To display domain log file entries for a specific type of alert, click the link that displays the number of messages for a given severity. The Server Log Summary page is displayed.

This page displays the latest domain log file entries. It displays the following information for each entry: Property Description Date The date the entry was logged. Subsystem The subsystem associated with the entry. Severity The severity of the message. Message ID The unique identification for the message. Message The message description

Property	Description
Date	The date the entry was logged.
Subsystem	The subsystem associated with the entry.
Severity	The severity of the message.
Message ID	The unique identification for the message.
Message	The message description

Note: To display details of a specific log file, select the radio button for the appropriate entry, then click View. To learn more, see Viewing Details of Server Log Files.

Viewing Details of Server Log Files

The Server Log Details page enables you to view details of a domain log file entry.

To View Details of a Domain Log Entry

From the left navigation pane, select Dashboard from under Monitoring. The Dashboard page is displayed.

To display domain log file entries for a specific type of alert, click the appropriate link. The Server Log Summary page is displayed.

Select the radio button associated with the log entry you want to view, then click View. The Server Log Details page is displayed, which includes the following information:

Property	Description
Message	A description of the event or condition.
Date	Displays the time and date when the message originated, in a format that is specific to the locale. The Java Virtual Machine (JVM) that runs each WebLogic Server instance refers to the host computer operating system for information about the local time zone and format.
Subsystem	Indicates the subsystem of WebLogic Server that was the source of the message; for example, Enterprise Java Bean (EJB) container or Java Messaging Service (JMS).
Message ID	A unique six-digit identifier. All message IDs that WebLogic Server system messages generate start with BEA- and fall within a numerical range of 0-499999.
Severity	Indicates the degree of impact or seriousness of the event reported by the message: Alert—A particular service is in an unusable state while other parts of the system continue to function. Automatic recovery is not possible; the immediate attention of the administrator is needed to resolve the problem. Critical—A system or service error has occurred. The system can recover but there might be a momentary loss or permanent degradation of service. Emergency—The server is in an unusable state. This severity indicates a severe system failure or panic. Error—A user error has occurred. The system or application can handle the error with no interruption and limited degradation of service. Info—Used for reporting normal operations; a low-level informational message. Notice—An informational message with a higher level of importance. Warning—A suspicious operation or configuration has occurred but it might not affect normal operation.
Machine	The DNS name of the computer that hosts the server instance.
Server	The name of the WebLogic Server instance on which the message was generated.
Thread	The ID that the JVM assigns to the thread in which the message originated.
User ID	The user ID under which the associated event was executed.
Transaction ID	Present only for messages logged within the context of a transaction.
Context ID	Context information to correlate messages coming from a specific request or application.
Detail	A description of the event or condition.
Cause	The cause of the message.
Action	The action that should be taken.

Listing and Locating Alerts

The Customized System Alert History page enables you to view a summary of system alerts. To learn more about alerts, see Alerts.

About Alerts and the Domain Log

When an alert is fired in your configuration, a message is sent to your domain log, which resides at the following location:

BEA_HOME\servers\server_name\logs\domain_name.log

Where domain_name represents the name you assigned your AquaLogic Service Bus domain when you created it.

The message is logged as an alert and has this message ID: BEA-394015.

The message body is a string that consists of the following elements:

Alert Rule ID
Alert Rule Name
Severity
Timestamp
Name of the service associated with the alert

To List and Locate Alerts

From the left navigation pane, select Dashboard from under Monitoring.

In the Alert Summary panel, click View Alert Summary List. The Customized System Alert History page is displayed. At the top of the page, a table displays the number of alerts currently raised by the system. The alerts are grouped according to their severity:

Property	Description¹
Fatal	The number of fatal alerts
Critical	The number of critical alerts
Major	The number of major alerts
Minor	The number of minor alerts
Warning	The number of warning alerts
Normal	The number of normal alerts

1. For each alert type, you can click the number to display more details.

The page also displays fields that display alert information depending on your customized settings for the alert table. For example, the page can display the alert, alert name, timestamp, and the name of the service or project associated with the alert:

Property

Description

Alert Severity

The severity of the alert. This is a link to the System Alert Details page. To learn more, see Viewing Alert Details:

Fatal

Critical

Major

Minor

Warning

Normal

Alert Rule Name

The name assigned to the alert. The name is a link to the Alert Rule Details page. To learn more, see Viewing and Changing Alert Rule Details.

Timestamp

The date and time that the alert occurred.

Service/Project Name

The name of the service or project associated with the alert. The name is a link to the Service Monitoring Details page. To learn more, see Viewing Service Monitoring Details.

Property	Description
Alert Severity	The severity of the alert. This is a link to the System Alert Details page. To learn more, see Viewing Alert Details: Fatal Critical Major Minor Warning Normal
Alert Rule Name	The name assigned to the alert. The name is a link to the Alert Rule Details page. To learn more, see Viewing and Changing Alert Rule Details.
Timestamp	The date and time that the alert occurred.
Service/Project Name	The name of the service or project associated with the alert. The name is a link to the Service Monitoring Details page. To learn more, see Viewing Service Monitoring Details.

To locate a specific alert, do one of the following:

Resort the list. Ascending and descending arrow buttons indicate sortable columns—in this case, the Alert Severity and Timestamp columns. Click the button to change the sort order.
Scroll through the pages. Use the controls in the lower right corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.

This page also enables you to do the following:

To display the list of alerts in a pie chart or bar chart, click View Graph. To learn more, see Viewing a Chart of Alerts.
To customize the display of information for each alert, click Customize table. To learn more, see Customizing Your View of Alerts.
To update the page with the latest information, click Refresh.

Viewing a Chart of Alerts

The Customized System Alert History page provides a link (View as Graph) that allows you to view a pie chart and a bar chart of system alerts for the previous designated time. The pie chart is displayed by default. To learn more about alerts, see Alerts.

This page enables you to do the following:

To display an updated version of the data, click Refresh chart information.
To display the data in a tabular format, click View data as table.
To display the same data in a bar chart, click View as bar chart.

Customizing Your View of Alerts

The Customized System Alert History page enables you to customize the display of information for each alert. For a description of each field, see Listing and Locating Alerts. To learn more about alerts, see Alerts.

To Customize Your View of the Alerts Summary

From the left navigation pane, select Dashboard from under Monitoring. The Dashboard page is displayed.

In the Alert Summary panel, click View Alert Summary List. The Customized System Alert History page is displayed.

Click Customize table. Additional fields are displayed.

Note: You can click Close table customizer at any time to close this table and retain the original settings.

In the System Alerts Table Filter fields, do the following:

In the Time field, select the appropriate radio button, then select the number of days, hours, and minutes from which you want to view alerts. Alternatively, you can select a different radio button, then select the specific month, date, year, hour, and minute from which you want to view alerts.

Select the Severity checkbox to include severity in the filter criteria, then select the alert severity: All, Critical, Fatal, Major, Minor, Warning, or Normal.

Select the Service checkbox to include services in the filter criteria, then select a service name. The default is All.

Select the Alert Rule Name checkbox to include alert rule names in the filter criteria, then select an alert rule name. The default is All.

In the Columns Display field, select the columns you want to display:

Select a column name from the Available field.

Click the arrow to move this column name to the Chosen field.

Repeat until you have listed all the column names you want to display in the Chosen field.

Note: In the Chosen field, you can use the Up and Down arrows to reorder the column names as required.

In the Number of rows displayed per page field, select the number of alerts you want to display on a single page.

In the Maximum Results Returned field, select the maximum number of alerts you want to display in total or select Show All to display all of them.

Do one of the following:

To save the new settings, click Apply.
To discard your changes and retain the original settings, click Reset.

Property	Description
Alert Name	The name assigned to the alert.
Description	A description of this alert.
Timestamp	The date and time the alert occurred.
Severity	The severity of the alert: Fatal Critical Major Minor Warning Normal
Alert Rule Name	The alert rule name. The name is a link to the View Alert Rule Details page. To learn more, see Viewing and Changing Alert Rule Details.
Service	The name and path of the service associated with this alert. The field is a link to the Service Monitoring Details page. To learn more, see Viewing Service Monitoring Details.
Annotation	Notes associated with this alert, if any exist.

Creating an Alert Rule

The New Alert Rule pages enable you to create new alert rules. To learn more about alerts, see Alerts.

To create an alert rule, you must first configure general information for the alert rule, then define conditions for the alert rule, and finally define alert rule actions. You can review the configuration before you create the new alert.

The tasks in this procedure include:

To Configure General Information for an Alert Rule

From the left navigation pane, select Proxy Services or Business Services from under Resource Browser.

In the Actions column, click the Manage Monitoring icon for the proxy service or business service for which you want to create a new alert rule. The Monitoring Configuration - [service name] page is displayed.

Select the Enable Monitoring checkbox to enable monitoring for the service. Rules can only be created for services that are enabled for monitoring. To learn more, see Configuring Monitoring for Specific Services.

In the Select Aggregation Interval for the service field, select the length of the aggregation interval in terms of hours and minutes, then click Update.

Click Add New. The New Alert Rule - General Configuration [service name] page is displayed.

In the Rule Name field, enter a name for the alert rule. This is a required field.

In the Rule Description field, enter a description for the alert rule.

In the Start Time field, enter a start time in the format HH:MM. For example, enter 09.00. You use the Start Time and End Time fields to specify a window of time during which the rule is active on each day prior to the expiration date. For example, Between 9am and 5pm every day.

In the End Time field, enter an end time in the format HH:MM. For example, enter 17.00. You use the Start Time and End Time fields to specify a window of time during which the rule is active on each day prior to the expiration date. For example, Between 9am and 5pm every day.

Note: The alert rule is active daily during the start time you specified until the end time you specified, until the rule expires.

In the Rule Expiration Date field, enter an expiration date in the format MM/DD/YYYY. For example, enter 12/31/2010. The rule expires at 12.01am on the specified date. If you do not specify a date, the rule never expires.

In the Rule Enabled field, keep Yes as the default to ensure that this rule is enabled, or select No to disable this rule.

In the Alert Severity field, select one of the following:

Normal
Warning
Minor
Major
Critical
Fatal

In the Alert Frequency field, select one of the following:

Property	Description
Every Time	If you select this option, the actions included in the alert rule are executed every time the alert rule evaluates to `true`. Rules are executed once every aggregation interval, therefore you receive an alert for each aggregation interval that the rule evaluates to `true`. For example, if you set the condition that the average response time is greater than 300 milliseconds, you receive an alert every time this condition evaluates to `true`. The number of times an alert rule is fired depends on the aggregation interval and the sample interval associated with that rule. If the aggregation interval is set to 5 minutes, the sample interval is 1 minute. Rules are evaluated each time 5 samples of data are available. Therefore, the rule is evaluated for the first time approximately 5 minutes after it is created and every minute thereafter.
Once Until Conditions Clear	If you select this option, the actions included in the rule are executed the first time the rule evaluates to `true`, and no more alerts are generated until the condition resets itself and evaluates to `true` again. For example, if you set the condition that the average response time is less than 300 milliseconds, you receive an alert the first time this condition evaluates to `true`, but you do not receive any more alerts until the condition evaluates to `false` and then to `true` again. Therefore, if you select this option, after an alert is fired the first time in an aggregation interval, it is not fired again in the same aggregation interval.

Property

Description

Every Time

If you select this option, the actions included in the alert rule are executed every time the alert rule evaluates to true. Rules are executed once every aggregation interval, therefore you receive an alert for each aggregation interval that the rule evaluates to true. For example, if you set the condition that the average response time is greater than 300 milliseconds, you receive an alert every time this condition evaluates to true.

The number of times an alert rule is fired depends on the aggregation interval and the sample interval associated with that rule. If the aggregation interval is set to 5 minutes, the sample interval is 1 minute. Rules are evaluated each time 5 samples of data are available. Therefore, the rule is evaluated for the first time approximately 5 minutes after it is created and every minute thereafter.

Once Until Conditions Clear

If you select this option, the actions included in the rule are executed the first time the rule evaluates to true, and no more alerts are generated until the condition resets itself and evaluates to true again. For example, if you set the condition that the average response time is less than 300 milliseconds, you receive an alert the first time this condition evaluates to true, but you do not receive any more alerts until the condition evaluates to false and then to true again.

Therefore, if you select this option, after an alert is fired the first time in an aggregation interval, it is not fired again in the same aggregation interval.

Select Yes for the Stop Processing More Rules option if you want to abort executing further rules after one of the rules associated with a service evaluates to true. This option enables you to stop evaluating subsequent rules when there are multiple rules associated with a particular service. Keep No as the default to continue processing rules.

Note: This option behaves like the Stop Processing More Rules option in the Rules Wizard in Microsoft Outlook.

Keep Yes as the default or select No for the Include Log In Management Data Set option. If you select Yes, when an alert is raised, a log of the alert is included in management data set. These alert logs are visible on the Dashboard in the Alert Summary table. If you select No, a log of the alert is not generated in the management data set.

Select Yes or keep No as the default for the Include Log In Reporting Data Set option. If you select Yes, when an alert is raised, a log of the alert is included in reporting data set. If you select No, a log of the alert is not included in this data set. Viewing the reporting data set requires developing a Reporting Provider to fetch and display these logs. To learn more, see Reporting in the BEA AquaLogic Service Bus User Guide.

Do one of the following:

To continue, click Next. The New Alert Rule - Define Conditions [service name] page is displayed.
To disregard changes, click Cancel.

To Define Alert Rule Conditions

The New Alert Rule - Define Conditions [service name] page is displayed when you click Next on the New Alert Rule - General Configuration page. This page enables you to define conditions for the alert rule. You must specify at least one condition. If you specify multiple conditions, you must use the And/Or operators to combine them.

In the Select Aggregation Interval for the Condition field, select the number of hours and minutes to set the aggregation interval for this condition. The aggregation interval determines the frequency at which the condition is tested. The condition is tested each time the monitoring subsystem aggregates enough samples of data to constitute 1 aggregation interval.

For example, if you select an aggregation interval of 1 hour, the condition is tested each time an hour's worth of data is available. The first time the condition is tested is at the end of the first hour. After that, the condition is tested every 10 minutes because the sampling interval for an aggregation interval of 1 hour is set to 10 minutes.

You start by defining a simple expression. Two or more simple expressions can be combined to form a complex expression. To define a complex simple expression, do the following:

In the first drop-down field, select Count, Minimum, Maximum, or Average.

In the next drop-down field, select an operand.

Depending on whether you select Count, Minimum, Maximum, or Average in the first drop-down field, the list of the operands varies. For example, if you select Minimum, Maximum, or Average, the Response Time operand is available. This operand allows you to set the response time in milliseconds (msec). The operands available also depends on the configuration of the service itself. The number of operands varies according to whether a service has pipelines, route nodes, operations, and so on.
When you select Count, this field displays the following operands:

Property

Description

Success Ratio (%)

The ratio of messages successfully processed versus the number of errors encountered over the specified aggregation interval.

Failure Ratio (%)

The ratio of errors encountered versus the number of messages successfully processed over the specified aggregation interval.

Message count

The total number of messages processed.

Error count

The total number of erroneous messages processed. This counter is incremented when an error occurs in the transport or the message flow and is not handled by an error handler in the pipeline.

Failover count

The failover count.

Validation Error Count

The number of validation errors.

Order Processing Pipeline_request.Message Count

The number of messages processed by the request pipeline.

Order Processing Pipeline_request.Error Count

The number of erroneous messages processed by the request pipeline.

WSS Error Count

The number of Web Service Security (WSS) erroneous messages processed. This counter is only available for WSDL-based services and is updated when a WSS error is encountered.

Property	Description
Success Ratio (%)	The ratio of messages successfully processed versus the number of errors encountered over the specified aggregation interval.
Failure Ratio (%)	The ratio of errors encountered versus the number of messages successfully processed over the specified aggregation interval.
Message count	The total number of messages processed.
Error count	The total number of erroneous messages processed. This counter is incremented when an error occurs in the transport or the message flow and is not handled by an error handler in the pipeline.
Failover count	The failover count.
Validation Error Count	The number of validation errors.
Order Processing Pipeline_request.Message Count	The number of messages processed by the request pipeline.
Order Processing Pipeline_request.Error Count	The number of erroneous messages processed by the request pipeline.
WSS Error Count	The number of Web Service Security (WSS) erroneous messages processed. This counter is only available for WSDL-based services and is updated when a WSS error is encountered.

In the next field, select the desired comparison operator: =, !=, > or <.

In the next field, enter the value to compare against.

Click Add.

To define a complex expression:

Repeat steps a - e in step 2 to define a simple expression.

Repeat steps a - e again to define another simple expression.

Select the checkbox for each of the two expressions.

Click And or Or to combine the expressions into a complex expression.

Note: The Split option is available after you combine multiple expressions. This option is used to split complex expressions back into separate simple expressions.

Do one of the following:

To return to the General Configuration page, click Back.
To continue, click Next. The New Alert Rule - Define Actions [service name] page is displayed. Continue in To Define Alert Rule Actions.
To disregard changes, click Cancel.

To Define Alert Rule Actions

The New Alert Rule - Define Actions [service name] page is displayed when you click Next on the New Alert Rule - Define Conditions page. This page enables you to define actions for the alert rule.

In the Add Action field, select Send an alert via email or Send an alert to a JMS destination, then click Add action. If you selected Send an alert via email, the New Alert Rule - Define Actions: Send an alert via email page is displayed. If you selected Send an alert to a JMS destination, the New Alert Rule - Define Actions: Send an alert to a JMS destination page is displayed.

Based on the option you selected in the Add action field, do one of the following:

Action...	Complete These Steps...
Send an alert via email	1. In the Mail URI field, enter a URI in the format `mailto:name@company.com`. This format is displayed in the tooltip for this field. 2. The value for the Subject field is generated by the system and displays the text Service Bus Alert followed by the name of the Alert Rule. This is a read only field. 3. In the Mail Server address field, enter an existing SMTP server in the format `host:port`. This is a required field if you do not select a JNDI name in the Mail Session field. 4. In the Service Account field, enter a service account. A service account is an alias resource for a User ID and its associated password. 5. In the Mail Session field, select the JNDI name of a configured session. This is a required field if you do not enter an SMTP server name in the Mail Server address field. This field is not available if there are no mail sessions available. Mail sessions are configured in the WebLogic Server. To learn more, see the WebLogic Server Administration Console Online Help. 6. In the From Name field, enter a display name for the originating email account for this service. 7. In the From Address field, enter the originating email account for this service. 8. In the Reply To Name field, enter a display name for the reply to email account. 9. In the Reply To Address field, enter an email address to reply to. 10. In the Connection timeout (in milliseconds) field, enter the length of time in milliseconds at which a connection times out if no connection is established with the email server. If you enter zero, this means infinite time. 11. In the Request encoding field, accept the default `iso-8859-1` as the character set encoding for requests in Email transports, or enter a different character set encoding.
Send an alert to a JMS destination	1. In the Destination URI field, enter a URI in the format `jms://host:port/factoryJndiName/destJndiName`. This format is displayed in the tooltip for this field. 2. In the Destination Type field, select Queue or Topic. Note: The Message Type field is a read-only field. The message type is always a Bytes Message. 3. In the Request encoding field, accept the default `utf-8` as the char set encoding for requests in JMS transports, or enter a different char set encoding. Note: You must use the WebLogic Server console to set up a JMS connection factory and queue, and target both the connection factory and queue to the appropriate JMS Server.

Action...

Complete These Steps...

Send an alert via email

1. In the Mail URI field, enter a URI in the format mailto:name@company.com. This format is displayed in the tooltip for this field.

2. The value for the Subject field is generated by the system and displays the text Service Bus Alert followed by the name of the Alert Rule. This is a read only field.

3. In the Mail Server address field, enter an existing SMTP server in the format host:port. This is a required field if you do not select a JNDI name in the Mail Session field.

4. In the Service Account field, enter a service account. A service account is an alias resource for a User ID and its associated password.

5. In the Mail Session field, select the JNDI name of a configured session. This is a required field if you do not enter an SMTP server name in the Mail Server address field. This field is not available if there are no mail sessions available. Mail sessions are configured in the WebLogic Server. To learn more, see the WebLogic Server Administration Console Online Help.

6. In the From Name field, enter a display name for the originating email account for this service.

7. In the From Address field, enter the originating email account for this service.

8. In the Reply To Name field, enter a display name for the reply to email account.

9. In the Reply To Address field, enter an email address to reply to.

10. In the Connection timeout (in milliseconds) field, enter the length of time in milliseconds at which a connection times out if no connection is established with the email server. If you enter zero, this means infinite time.

11. In the Request encoding field, accept the default iso-8859-1 as the character set encoding for requests in Email transports, or enter a different character set encoding.

Send an alert to a JMS destination

1. In the Destination URI field, enter a URI in the format jms://host:port/factoryJndiName/destJndiName. This format is displayed in the tooltip for this field.

2. In the Destination Type field, select Queue or Topic.

Note: The Message Type field is a read-only field. The message type is always a Bytes Message.

3. In the Request encoding field, accept the default utf-8 as the char set encoding for requests in JMS transports, or enter a different char set encoding.

Note: You must use the WebLogic Server console to set up a JMS connection factory and queue, and target both the connection factory and queue to the appropriate JMS Server.

To add the action, click Add.

Do one of the following:

To return to the Define Conditions page, click Back.
To continue, click Next. The New Alert Rule - [service name] page is displayed. Continue in To Review Configuration.
To disregard changes, click Cancel.

To Review Configuration

The New Alert Rule - [service name] page is displayed when you click Next on the Define Actions page. This page enables you to review the configuration data that you have entered for this alert rule. If necessary, you can click Edit to make changes to the configuration before you save the alert rule.

Do one of the following:

To make a change to one of the configuration pages, click Edit for the appropriate page.
To return to the previous page, click Back.
To create the alert, click Save. The alert rule is created.

The Monitoring Configuration - [service name] page is displayed. The new alert rule is included in the list of alert rules.

To disregard changes, click Cancel.

Note: The new alert rule is saved in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the configuration is deployed to run time. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

Listing and Locating Alert Rules

The Monitoring Configuration - [service name] page enables you to view a list of alert rules. To learn more about alerts, see Alerts.

To List and Locate Alert Rules

In the Actions column, select the Manage Monitoring icon for a specific service. The Monitoring Configuration - [service name] page is displayed for the service. The page displays the following information for each alert rule. To learn more about the properties, see Viewing and Changing Alert Rule Details.

Property	Description
Alert Rule Name	The name assigned to this alert rule. The name is a link to the View Alert Details page. To learn more, see Viewing and Changing Alert Rule Details.
Description	A description of the alert rule.
Expiration Date	The date when this alert rule is no longer in effect.
Status	The status of the alert rule: Enabled or Disabled
Stop Processing	Displays Yes or No
Frequency	The frequency of this alert: Every Time Once Until Conditions Clear
Options	This column includes the following functionality: Click the arrows to reorder the alert rules. You can move individual alert rules up or down the list. You can do this only when this more than one alert rule configured for this service. Click the Delete icon to delete a specific alert rule. To learn more, see Deleting an Alert Rule.

To locate a specific alert rule for this service, scroll through the pages. Use the controls in the lower right corner. Go to a page by selecting the page number or by using the arrow buttons to go to the next, previous, first, or last page.

The Monitoring Configuration - [service name] page also enables you to do the following:

To configure monitoring for this service, see Configuring Monitoring for Specific Services.
To add a new alert rule, click Add New. To learn more, see Creating an Alert Rule.

Viewing and Changing Alert Rule Details

The View Alert Rule Details - [service name] page enables you to view and edit details of a specific alert rule. To learn more about alerts, see Alerts.

To View and Change Alert Rule Details

Locate the alert rule. To learn more, see Listing and Locating Alert Rules.

Click the alert rule name.

The View Alert Rule Details page displays the following General Configuration information:

Property

Description

Rule Name

The name of the alert rule.

Rule Description

A description of the alert rule

Start Time (HH:MM)

The start time for this alert rule

End Time (HH:MM)

The end time for this alert rule

Rule Expiration Date (MM/DD/YYYY)

The date when this alert rule no longer applies

Rule Enabled

Whether or not this alert rule is enabled

Alert Severity

The severity of the alert raised as a result of this alert rule:

Normal

Warning

Minor

Major

Critical

Fatal

Alert Frequency

The frequency of the alert:

Every Time

Once Until Conditions Clear

Stop Processing More Rules

Whether or not the alert stops processing more rules.

Include Log In Management Data Set

Whether or not the log is included in the management data set.

Include Log In Reporting Data Set

Whether or not the log is included in the reporting data set.
The page displays the following Conditions information:

Property

Description

Condition Expression

The aggregation interval for this condition, in terms of hours and minutes.

A list of one or more conditions that govern this alert rule.
The page displays the following Action Parameters information:

Property

Description

Send an alert via email

Displays the email URI if the action that occurs when this alert rule is broken is to send an alert via email.

Send an alert to a JMS destination

Displays the JMS destination URI if the action that occurs when this alert rule is broken is to send an alert to a JMS destination.

Property	Description
Rule Name	The name of the alert rule.
Rule Description	A description of the alert rule
Start Time (HH:MM)	The start time for this alert rule
End Time (HH:MM)	The end time for this alert rule
Rule Expiration Date (MM/DD/YYYY)	The date when this alert rule no longer applies
Rule Enabled	Whether or not this alert rule is enabled
Alert Severity	The severity of the alert raised as a result of this alert rule: Normal Warning Minor Major Critical Fatal
Alert Frequency	The frequency of the alert: Every Time Once Until Conditions Clear
Stop Processing More Rules	Whether or not the alert stops processing more rules.
Include Log In Management Data Set	Whether or not the log is included in the management data set.
Include Log In Reporting Data Set	Whether or not the log is included in the reporting data set.

Property	Description
Condition Expression	The aggregation interval for this condition, in terms of hours and minutes. A list of one or more conditions that govern this alert rule.

Property	Description
Send an alert via email	Displays the email URI if the action that occurs when this alert rule is broken is to send an alert via email.
Send an alert to a JMS destination	Displays the JMS destination URI if the action that occurs when this alert rule is broken is to send an alert to a JMS destination.

To make a change to the fields on the configuration pages, click Edit for the appropriate page. See Creating an Alert Rule for a description of the pages and fields.

Do one of the following:

To return to the previous page, click Back.
To update the alert rule, click Finish. The alert rule is updated.

The Monitoring Configuration - [service name] page is displayed.

To disregard changes and return to the Monitoring Configuration - [service name] page, click Cancel.

Note: The alert rule is updated in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the core configuration is updated. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

Deleting an Alert Rule

The Monitoring Configuration - [service name] page enables you to delete an alert rule. To learn more about alerts, see Alerts.

To Delete an Alert Rule

In the Actions column, select the Manage Monitoring icon for a specific service. The Monitoring Configuration - [service name] page is displayed for the service.

In the Options field of the alert rule you want to delete, click the Delete icon.

The alert rule is removed from the list.

Note: The alert rule is deleted in the current session. When you have finished making changes to this configuration, from the left navigation pane, click Activate under Change Center. The session ends and the core configuration is updated. Alternatively, click Discard at any time during the session to delete the changes you have made so far in the current session.

Monitoring

Overview of Monitoring

Alerts

Viewing the Dashboard Statistics

To Customize the Alert Summary Table

Related Topics

Listing and Locating Services

To List and Locate Services that have Monitoring Enabled

Related Topics

Configuring Monitoring for Specific Services

To Configure Monitoring for a Specific Service

Related Topics

Setting the Aggregation Interval for a Service

To Set the Aggregation Interval for a Service

Related Topics

Viewing Service Monitoring Details

To View Monitoring Details of a Service

Related Topics

Listing and Locating Servers

To List and Locate Servers

Related Topics

Customizing Your View of the Server Summary

To Customize Your View of the Server Summary

Related Topics

Viewing a Chart of Servers

Related Topics

Viewing Server Details

Related Topics

Viewing Server Log Files

To View Domain Log File Entries

Related Topics

Viewing Details of Server Log Files

To View Details of a Domain Log Entry

Related Topics

Listing and Locating Alerts

About Alerts and the Domain Log

To List and Locate Alerts

Related Topics

Viewing a Chart of Alerts

Related Topics

Customizing Your View of Alerts

To Customize Your View of the Alerts Summary

Related Topics

Viewing Alert Details

Related Topics

Creating an Alert Rule

To Configure General Information for an Alert Rule

To Define Alert Rule Conditions

To Define Alert Rule Actions

To Review Configuration

Related Topics

Listing and Locating Alert Rules

To List and Locate Alert Rules

Related Topics

Viewing and Changing Alert Rule Details

To View and Change Alert Rule Details

Related Topics

Deleting an Alert Rule

To Delete an Alert Rule

Related Topics