An alert destination resource captures a list of recipients that can receive alert notifications from the AquaLogic Service Bus. In typical system monitoring contexts, alerts generated by ALSB bear significance to a finite set of users. In ALSB, you can configure each alert destination resource to include a set of recipients according to a given context. Alert destinations are used by Alert actions configured in the message flow, and also by SLA alert rules. An alert destination can include one or more of the following types of destinations: console (default), Reporting Data stream, SNMP trap, e-mail, JMS queue, or JMS topic. In the case of e-mail and JMS destinations, a destination resource can include a list of e-mail addresses or JMS URIs, respectively.
You can re-use alert destinations across alert configurations for services. See Adding Alert Actions.
Locating Alert Destinations
You can view a list of alert destinations in the Summary of Alert Destinationspage. If you have not yet created an alert destination, and want to do so, create a new alert Destination resource from the Project Explorer. To learn how, see Adding Alert Destinations.
Select Resource Browser > Alert Destinations. The Summary of Alert Destinations page displays the information shown in Table 5-1.
To restrict the number of items in the list, you can filter by name, path, or both. In the Name and Path fields, enter the name and path of the search target(s), then click Search.
The path is the project name and the name of the folder in which the alert destination resides.
Click View All to remove the search filters and display all alert destinations.
Table 5-1 Alert Destination Details
Property
Description
Name
The name of the alert destination resource. The name is a link to the View an Alert Destination - Configuration page. See Editing Alert Destinations.
Path
The path is the project name and the name of the folder in which the alert destination resides. It is a link to the project or folder that contains this resource. See Qualifying Resource Names Using Projects and Folders.
An alert destination is a destination address for alert notifications in ALSB. You can create alert destination resources in the Create Alert Destination page.
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 Project Explorer, then select a project or folder in which to add the alert destination. The Project/Folder View page is displayed.
From the Create Resource drop-down list, select Alert Destination to display the Create Alert Destination page.
In the Resource Name field, enter a unique name for this alert destination. This is a required field.
In the Resource Description field, enter a description for the alert destination.
Select any or all of the following destinations to be included in this alert destination resource.
Note:
By default, all alerts are sent to the ALSB console at run time. These alerts can be viewed under Operations > Dashboard.
SNMP Trap: If you specify SNMP Trap, alerts are sent as SNMP traps, and can be processed by any third-party enterprise monitoring systems (ESM).
Reporting: If you specify Reporting, alerts are sent to the ALSB Reporting module and can be captured using a custom Reporting Provider that can developed using the Reporting APIs provider by AquaLogic Service Bus. This allows third-parties to receive and process alerts in custom Java code.
Add an e-mail recipient to the alert destination resource definition. See Adding E-Mail Recipients.
Add a JMS Destination to the alert destination resource definition. See Adding JMS Destinations.
Click Save. The new alert destination is saved in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Adding E-Mail and JMS Recipients
You can add multiple e-mail and JMS recipients to an alert destination.
Before you add an e-mail destination, you must configure an SMTP Server (see Adding SMTP Servers), or a JavaMail session in WebLogic Server (see Configure access to JavaMail in Administration Console Online Help). If there are no SMTP Server resources or JavaMail sessions available, configured, you cannot configure an e-mail recipient.
Select Send an alert via e-mail from the drop-down list and click Add to display the Add E-mail Recipient page.
In the Mail Recipients field, enter an e-mail recipient in the format: mailto:username@hostname
This is a required field.
You can specify multiple e-mail recipients by entering the user names and hostnames in a comma-separated list. For example, mailto:username@hostname [,username_1@hostname_1]...[,username_n@hostname_n]
Only the first mail recipient needs to be prefixed with the text “mailto:”.
In the SMTP Server field, select the name of the SMTP Server for the outgoing e-mail. This field is not required if a mail session is selected in the next step.
In the Mail Session field, select an available mail session. This field is not required if an SMTP Server is selected in the previous step.
In the From Name field, provide a sender’s name for the alert notification. This field is optional.
In the From Address field, provide a valid e-mail address. This field is required if a value for “From Name” field is specified.
In the Reply To Name field, provide a name to which a reply may be addressed. This field is optional.
In the Reply To Address field, provide an e-mail address to which a reply may be sent. This field is required if a value for “Reply To Name” field is specified.
In the Connection Timeout field, enter the number of seconds a connection must wait for a response from the server before timing out. The default value is 0.
In the Request Encoding field, enter a character set encoding value. The default encoding value is iso-8859-1.
Click Save. The e-mail recipient is added to the list of e-mail recipients for this alert destination and saved in the current session.
Adding JMS Destinations
Select Send an alert to a JMS Destination from the drop-down list and click Add to display the Add JMS Destination page.
In the destination URI field, enter a JMS destination URI in the format: jms://host:port/factoryJndiName/destJndiName
This is a required field.
In the Destination Type field, select Queue or Topic.
In the Message Type field, select Bytes or Text.
In the Request Encoding field, enter a character set encoding value. The default encoding value is UTF-8.
Click Save. The JMS destination is added to the list of JMS destinations to be included for this alert destination and saved in the current session.
Editing Alert Destinations
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.
Click the alert destination name. The View Alert Destination - Configuration page displays the information shown in Table 5-2.
Table 5-2 Alert Destination Configuration Details
Property
Description
Last Modified By
The user who created or edited this alert destination.
Last Modified On
The date and time that the user created or edited this alert destination. Click the date and time link to view the change history of this resource. See View Change History page.
References
The number of objects that this alert destination references. If such references exist, click the numeric link to view a list of the objects. See Viewing References to Resources.
Referenced by
The number of objects that reference this alert destination. If such references exist, click the numeric link to view a list of the objects. See Viewing References to Resources.
Description
A description of this alert destination, if one exists.
General Configuration
SNMP Trap: Yes or No, to indicate whether the SNMP Trap option was specified as a destination for this alert when it was configured.
Reporting: Yes or No, to indicate whether the Reporting option was specified as a destination for this alert when it was configured.
E-mail & JMS: Displays a list of e-mail recipients or JMS destinations, or both, if they were configured.
You can change your selection of the SNMP Trap or Reporting setting.
To edit or delete an e-mail recipient or JMS destination, click Edit at the bottom of the page.
To edit the e-mail recipient, in E-mail click the Edit icon under Options, for the e-mail recipient you want to edit. Use the Edit E-mail Recipient page to make changes to the e-mail recipient information. See Adding E-Mail Recipients.
To edit the JMS destination, in JMS click the Edit icon under Options, for the JMS destination you want to edit. Use the Edit JMS Destination page to make changes to the JMS destination information. See Adding JMS Destinations.
To delete one or all e-mail recipients or JMS destinations, click the Delete icon under Options, for the e-mail recipients or JMS destinations you want to delete.
Click Save to commit the updates in the current session.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Deleting Alert Destinations
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 Resource Browser > Alert Destinations to display the Summary of Alert Destinations page.
Click the Delete icon in the Options field of the alert destination you want to delete. The alert destination is deleted in the current session. 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.
To delete particular e-mail recipients or JMS destinations configured within an alert destination, see Editing Alert Destinations.
To end the session and deploy the configuration to the run time, click Activate under Change Center.
Edit icon under Options, for the e-mail recipient you want to edit. Use the Edit E-mail Recipient page to make changes to the e-mail recipient information. See Adding E-Mail Recipients. 
Delete icon under Options, for the e-mail recipients or JMS destinations you want to delete.
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.
