Monitoring Alert Service

ActiveVOS Server User’s Guide

Monitoring Alert Service

ActiveVOS server provides engine monitoring, and if desired, you can trigger an alert to notify an administrator when an engine stops running or when a monitored property has a warning or error condition.

When you configure engine monitoring properties in the ActiveVOS server Administration Console, the ActiveVOS server can instantiate a monitoring alert service, which can then invoke some action, such as notifying an administrator that an error condition exists. For details on sending an email, see Email Service.

You can design a BPEL process to serve as the monitoring alert service. The process must be based on a WSDL file named monitorAlert.wsdl.

In essence, the WSDL defines the handleAlert operation, which receives information from the server regarding engine status and engine properties being monitored, their monitoring level, threshold and value.

An input message sent to a BPEL process would have the following parts, shown in the example:

<ns:handleAlertRequest xmlns:ns="http://www.activebpel.org/

monitor/2007/08/monitor/monitorAlert.wsdl">

   <ns:engineDetail>

       <ns:name>string</ns:name>

       <ns:state>created</ns:state>

       <ns:monitoringStatus>normal</ns:monitoringStatus>

       <ns:errorMessage>string</ns:errorMessage>

       <ns:startDateTime>2007-09-10T19:15:15.868Z

           </ns:startDateTime>

       <ns:id>1</ns:id>

       <ns:numCPU>1</ns:numCPU>

       <ns:deploymentGroupId>1</ns:deploymentGroupId>

       <ns:deploymentGroup>string</ns:deploymentGroup>

   </ns:engineDetail>

   <ns:troubleItems>

     <ns:troubleItem>

       <ns:monitorName>string</ns:monitorName>

       <ns:level>1</ns:level>

       <ns:statistic>avg</ns:statistic>

       <ns:operator>eq</ns:operator>

       <ns:threshold>1.0</ns:threshold>

       <ns:displayName>string</ns:displayName>

       <ns:value>1.0</ns:value>

       <ns:timestamp>2007-09-10T19:15:15.868Z</ns:timestamp>

     </ns:troubleItem>

   </ns:troubleItems>

</ns:handleAlertRequest>

Here are some general steps to consider when creating a monitoring alert BPEL process.

To create an monitoring alert-service BPEL process:

In the Project Explorer, create a new project.
Select File>New>BPEL Process.
Name the process and click Next.
On the Process Template page, select the Monitor Alert process template.
A new file opens on the Process Editor canvas with a ReceiveAlertMessage activity. The receive activity is based on the handleAlert operation.
Finish building the process, adding the programming logic that you wish to occur when a monitored property reaches a warning or error level.
Launch the Deployment Descriptor wizard and on the Partner Links page, do the following:

Select the MonitorAlertPL My Role partner link.
Type in a Service Name for the My Role partner link.

Start up the ActiveVOS server and deploy the process to the server. Note that in the BPR, there are no WSDL or XSD. They are already deployed and available on the server.
In the ActiveVOS server console, add the Monitor Alert service. See the ActiveVOS Console Online Help for details.