|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--javax.management.NotificationBroadcasterSupport | +--javax.management.monitor.Monitor | +--javax.management.monitor.GaugeMonitor
Defines a monitor MBean designed to observe the values of a gauge attribute.
A gauge monitor observes an attribute that is continuously variable with time. A gauge monitor sends notifications as follows:
threshold high notification
is sent. The notify high flag must be
set to true
Subsequent crossings of the high threshold
value do not cause further notifications unless the attribute value
becomes equal to or less than the low threshold value.threshold low notification
is sent. The notify low flag must be set
to true
. Subsequent crossings of the low threshold value do
not cause further notifications unless the attribute value becomes equal
to or greater than the high threshold value.This provides a hysteresis mechanism to avoid repeated triggering of notifications when the attribute value makes small oscillations around the high or low threshold value.
If the gauge difference mode is used, the value of the derived gauge is calculated as the difference between the observed gauge values for two successive observations. The derived gauge value (V[t]) is calculated using the following method:
This implementation of the gauge monitor requires the observed attribute to be
of the type integer or floating-point
(Byte,Integer,Short,Long,Float,Double).
Fields inherited from class javax.management.monitor.Monitor |
alreadyNotified,
dbgTag,
OBSERVED_ATTRIBUTE_ERROR_NOTIFIED,
OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED,
OBSERVED_OBJECT_ERROR_NOTIFIED,
RESET_FLAGS_ALREADY_NOTIFIED,
RUNTIME_ERROR_NOTIFIED,
server |
Constructor Summary | |
GaugeMonitor()
Default constructor. |
Method Summary | |
java.lang.Number |
getDerivedGauge()
Gets the derived gauge. |
long |
getDerivedGaugeTimeStamp()
Gets the derived gauge timestamp. |
boolean |
getDifferenceMode()
Gets the difference mode flag value. |
java.lang.Number |
getHighThreshold()
Gets the high threshold value. |
java.lang.Number |
getLowThreshold()
Gets the low threshold value. |
MBeanNotificationInfo[] |
getNotificationInfo()
Returns a NotificationInfo object containing the name of the Java class of the notification and the notification types sent by the counter monitor. |
boolean |
getNotifyHigh()
Gets the high notification's on/off switch value. |
boolean |
getNotifyLow()
Gets the low notification's on/off switch value. |
void |
setDifferenceMode(boolean value)
Sets the difference mode flag value. |
void |
setNotifyHigh(boolean value)
Sets the high notification's on/off switch value. |
void |
setNotifyLow(boolean value)
Sets the low notification's on/off switch value. |
void |
setThresholds(java.lang.Number highValue,
java.lang.Number lowValue)
Sets the high and the low threshold values. |
void |
start()
Starts the gauge monitor. |
void |
stop()
Stops the gauge monitor. |
Methods inherited from class javax.management.monitor.Monitor |
getGranularityPeriod,
getObservedAttribute,
getObservedObject,
isActive,
postDeregister,
postRegister,
preDeregister,
preRegister,
setGranularityPeriod,
setObservedAttribute,
setObservedObject |
Methods inherited from class javax.management.NotificationBroadcasterSupport |
addNotificationListener,
removeNotificationListener,
sendNotification |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait |
Constructor Detail |
public GaugeMonitor()
Method Detail |
public java.lang.Number getDerivedGauge()
public long getDerivedGaugeTimeStamp()
public boolean getDifferenceMode()
public MBeanNotificationInfo[] getNotificationInfo()
public boolean getNotifyHigh()
public boolean getNotifyLow()
public java.lang.Number getHighThreshold()
public java.lang.Number getLowThreshold()
public void setDifferenceMode(boolean value)
value
- The difference mode flag value.public void setNotifyHigh(boolean value)
value
- The high notification's on/off switch value.public void setNotifyLow(boolean value)
value
- The low notification's on/off switch value.public void setThresholds(java.lang.Number highValue, java.lang.Number lowValue) throws java.lang.IllegalArgumentException
highValue
- The high threshold value.lowValue
- The low threshold value.public void start()
public void stop()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |