Sun GlassFish Enterprise Server 2.1 Administration Guide

About Management Rules

Management rules enable you to automate routine administration tasks, configure self-tuning of the application server for diverse runtime condition and improve availability by preventing failures. A management rule contains an action to be taken when a specified event occurs or a set threshold is reached. You can set management rules that can automatically take corrective action, based on events that you specify.

A management rule consists of two parts — event and action:

For example, an event could be a SEVERE message logged by the EJB logger, and an action could be alerting an administrator with the log message contents. When the event happens, event data is passed as part of userData part of the javax.management.Notification.

The action specified in your rule has to be implemented as a custom MBean. Therefore, before configuring a management rule, you should deploy a custom MBean designed to receive event notifications and take appropriate action. For details on developing a custom MBean and deploying it, see Chapter 14, Developing Custom MBeans, in Sun GlassFish Enterprise Server 2.1 Developer’s Guide.

The Enterprise Server provides some useful events, which you can further extend by writing custom MBeans to emit notifications. Each event can be further customized by changing its properties.

The following event types are available: