Класс GaugeMonitor

public class GaugeMonitor
extends Monitor
implements GaugeMonitorMBean

Определяет MBean монитора, предназначенный для наблюдения за значениями атрибута шкалы.

Монитор шкалы отслеживает атрибут, который непрерывно изменяется во времени. Монитор шкалы отправляет уведомления следующим образом:

• если значение атрибута увеличивается и становится равным или больше значения верхнего порога, отправляется threshold high notification. Флаг уведомления о превышении верхнего порога должен быть установлен на true.
  Последующие пересечения верхнего порога не вызывают дальнейших уведомлений, если значение атрибута не станет меньше или равно нижнему порогу.
• если значение атрибута уменьшается и становится равным или меньше значения нижнего порога, отправляется threshold low notification. Флаг уведомления о превышении нижнего порога должен быть установлен на true.
  Последующие пересечения нижнего порога не вызывают дальнейших уведомлений, если значение атрибута не станет больше или равно верхнему порогу.

Это обеспечивает механизм гистерезиса, чтобы избежать многократного срабатывания уведомлений, когда значение атрибута совершает небольшие колебания вокруг верхнего или нижнего порога.

Если используется режим разницы шкалы, значение полученной шкалы вычисляется как разница между наблюдаемыми значениями шкалы для двух последовательных наблюдений.
Значение полученной шкалы (V[t]) вычисляется следующим образом:

• V[t] = gauge[t] - gauge[t-GP]

Эта реализация монитора шкалы требует, чтобы наблюдаемый атрибут был типа целого числа или с плавающей точкой (Byte, Integer, Short, Long, Float, Double).

Конструкторы

GaugeMonitor

public GaugeMonitor()

Конструктор по умолчанию.

Методы

start

public void start()

Запускает монитор датчиков.

Указано в:

start в интерфейсе MonitorMBean

Указано в:

start в классе Monitor

stop

public void stop()

Останавливает монитор датчиков.

Указано в:

stop в интерфейсе MonitorMBean

Указано в:

stop в классе Monitor

getDerivedGauge

public Number getDerivedGauge(ObjectName object)

Возвращает производный показатель для указанного объекта, если объект входит в набор наблюдаемых MBean, или null в противном случае.

Указано в:

getDerivedGauge в интерфейсе GaugeMonitorMBean

Параметры:

object - имя MBean.

Возвращает:

Производный показатель указанного объекта.

getDerivedGaugeTimeStamp

public long getDerivedGaugeTimeStamp(ObjectName object)

Возвращает временную метку производного показателя для указанного объекта, если этот объект содержится в наборе наблюдаемых MBean, или 0 в противном случае.

Указано в:

getDerivedGaugeTimeStamp в интерфейсе GaugeMonitorMBean

Параметры:

object - имя объекта, для которого требуется временная метка производного показателя.

Возвращает:

Временную метку производного показателя указанного объекта.

getDerivedGauge

@Deprecated
public Number getDerivedGauge()

Устаревший. Начиная с JMX 1.2, заменен на getDerivedGauge(ObjectName)

Возвращает производный показатель первого объекта в наборе наблюдаемых MBean.

Указано в:

getDerivedGauge в интерфейсе GaugeMonitorMBean

Возвращает:

Производный показатель.

getDerivedGaugeTimeStamp

@Deprecated
public long getDerivedGaugeTimeStamp()

Устаревший. Начиная с JMX 1.2, заменен на getDerivedGaugeTimeStamp(ObjectName)

Возвращает временную метку производного показателя первого объекта в наборе наблюдаемых MBean.

Указано в:

getDerivedGaugeTimeStamp в интерфейсе GaugeMonitorMBean

Возвращает:

Временную метку производного показателя.

getHighThreshold

public Number getHighThreshold()

Возвращает значение верхнего порога, общее для всех наблюдаемых MBean.

Указано в:

getHighThreshold в интерфейсе GaugeMonitorMBean

Возвращает:

Значение верхнего порога.

См. также:

setThresholds(java.lang.Number, java.lang.Number)

getLowThreshold

public Number getLowThreshold()

Возвращает значение нижнего порога, общее для всех наблюдаемых MBean.

Указано в:

getLowThreshold в интерфейсе GaugeMonitorMBean

Возвращает:

Значение нижнего порога.

См. также:

setThresholds(java.lang.Number, java.lang.Number)

setThresholds

public void setThresholds(Number highValue,
                          Number lowValue)
                   throws IllegalArgumentException

Устанавливает значения верхнего и нижнего порогов, общие для всех наблюдаемых MBean.

Указано в:

setThresholds в интерфейсе GaugeMonitorMBean

Параметры:

highValue - значение верхнего порога.

lowValue - значение нижнего порога.

Исключения:

IllegalArgumentException - Указанный верхний/нижний порог равен null, или нижний порог больше верхнего, или верхний и нижний пороги не одного типа.

См. также:

getHighThreshold(), getLowThreshold()

getNotifyHigh

public boolean getNotifyHigh()

Возвращает значение флага включения/выключения уведомлений о превышении верхнего порога, общее для всех наблюдаемых MBean.

Указано в:

getNotifyHigh в интерфейсе GaugeMonitorMBean

Возвращает:

true если монитор датчиков отправляет уведомление при превышении верхнего порога, false в противном случае.

См. также:

setNotifyHigh(boolean)

setNotifyHigh

public void setNotifyHigh(boolean value)

Устанавливает значение флага включения/выключения уведомлений о превышении верхнего порога, общее для всех наблюдаемых MBean.

Указано в:

setNotifyHigh в интерфейсе GaugeMonitorMBean

Параметры:

value - значение флага включения/выключения уведомлений о превышении верхнего порога.

См. также:

getNotifyHigh()

getNotifyLow

public boolean getNotifyLow()

Возвращает значение флага включения/выключения уведомлений о превышении нижнего порога, общее для всех наблюдаемых MBean.

Указано в:

getNotifyLow в интерфейсе GaugeMonitorMBean

Возвращает:

true если монитор датчиков отправляет уведомление при превышении нижнего порога, false в противном случае.

См. также:

setNotifyLow(boolean)

setNotifyLow

public void setNotifyLow(boolean value)

Устанавливает значение флага включения/выключения уведомлений о превышении нижнего порога, общее для всех наблюдаемых MBean.

Указано в:

setNotifyLow в интерфейсе GaugeMonitorMBean

Параметры:

value - значение флага включения/выключения уведомлений о превышении нижнего порога.

См. также:

getNotifyLow()

getDifferenceMode

public boolean getDifferenceMode()

Возвращает значение флага режима разницы, общее для всех наблюдаемых MBean.

Указано в:

getDifferenceMode в интерфейсе GaugeMonitorMBean

Возвращает:

true если используется режим разницы, false в противном случае.

См. также:

setDifferenceMode(boolean)

setDifferenceMode

public void setDifferenceMode(boolean value)

Устанавливает значение флага режима разницы, общее для всех наблюдаемых MBean.

Указано в:

setDifferenceMode в интерфейсе GaugeMonitorMBean

Параметры:

value - значение флага режима разницы.

См. также:

getDifferenceMode()

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

Возвращает объект NotificationInfo содержащий имя Java-класса уведомления и типы уведомлений, отправляемых монитором датчиков.

Указано в:

getNotificationInfo в интерфейсе NotificationBroadcaster

Переопределяет:

getNotificationInfo в классе NotificationBroadcasterSupport

Возвращает:

Массив возможных уведомлений.