Класс GaugeMonitor

Все реализованные интерфейсы:
MBeanRegistration, GaugeMonitorMBean, MonitorMBean, NotificationBroadcaster, NotificationEmitter 
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).
С:
1.5

Поля

Поля, объявленные в классе javax.management.monitor.Monitor

alreadyNotified, alreadyNotifieds, capacityIncrement, dbgTag, elementCount, OBSERVED_ATTRIBUTE_ERROR_NOTIFIED, OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED, OBSERVED_OBJECT_ERROR_NOTIFIED, RESET_FLAGS_ALREADY_NOTIFIED, RUNTIME_ERROR_NOTIFIED, server

Краткое описание конструкторов

Конструктор Описание
GaugeMonitor()

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

Краткое описание методов

Модификатор и тип Метод Описание
Number getDerivedGauge()

Устарело.

С JMX 1.2, заменён на getDerivedGauge(ObjectName)

Number getDerivedGauge​(ObjectName object)

Возвращает производный измеритель указанного объекта, если этот объект содержится в наборе наблюдаемых MBeans, или null в противном случае.
long getDerivedGaugeTimeStamp()

Устарело.

С JMX 1.2, заменён на getDerivedGaugeTimeStamp(ObjectName)

long getDerivedGaugeTimeStamp​(ObjectName object)

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

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

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

Возвращает значение нижнего порога, общее для всех наблюдаемых MBeans.
MBeanNotificationInfo[] getNotificationInfo()

Возвращает объект NotificationInfo, содержащий имя класса Java уведомления и типы уведомлений, отправляемых монитором «измеритель».
boolean getNotifyHigh()

Возвращает значение переключателя уведомления о превышении верхнего порога, общее для всех наблюдаемых MBeans.
boolean getNotifyLow()

Возвращает значение переключателя уведомления о превышении нижнего порога, общее для всех наблюдаемых MBeans.
void setDifferenceMode​(boolean value)

Устанавливает значение флага режима разницы, общее для всех наблюдаемых MBeans.
void setNotifyHigh​(boolean value)

Устанавливает значение переключателя уведомления о превышении верхнего порога, общее для всех наблюдаемых MBeans.
void setNotifyLow​(boolean value)

Устанавливает значение переключателя уведомления о превышении нижнего порога, общее для всех наблюдаемых MBeans.
void setThresholds​(Number highValue, Number lowValue)

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

Запускает монитор «измеритель».
void stop()

Останавливает монитор «измеритель».

Методы, объявленные в классе javax.management.monitor.Monitor

addObservedObject, containsObservedObject, getGranularityPeriod, getObservedAttribute, getObservedObject, getObservedObjects, isActive, postDeregister, postRegister, preDeregister, preRegister, removeObservedObject, setGranularityPeriod, setObservedAttribute, setObservedObject

Методы, объявленные в классе javax.management.NotificationBroadcasterSupport

addNotificationListener, handleNotification, sendNotification

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе javax.management.monitor.MonitorMBean

addObservedObject, containsObservedObject, getGranularityPeriod, getObservedAttribute, getObservedObject, getObservedObjects, isActive, removeObservedObject, setGranularityPeriod, setObservedAttribute, setObservedObject

Методы, объявленные в интерфейсе javax.management.NotificationBroadcaster

removeNotificationListener

Методы, объявленные в интерфейсе javax.management.NotificationEmitter

removeNotificationListener

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

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
Возвращает:
массив возможных уведомлений.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.management/javax/management/monitor/GaugeMonitor.html

Spec-Zone .ru
спецификации, руководства, описания, API