Spec-Zone.ru › OpenJDK 25

Класс GaugeMonitor

java.lang.Object
javax.management.NotificationBroadcasterSupport
javax.management.monitor.Monitor
javax.management.monitor.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

Краткое описание полей

Поля, объявленные в классе 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)
Возвращает производное значение указанного объекта, если этот объект входит в набор наблюдаемых MBean, или null в противном случае.
long getDerivedGaugeTimeStamp()
Устарел.
Начиная с JMX 1.2, заменён на getDerivedGaugeTimeStamp(ObjectName)
long getDerivedGaugeTimeStamp(ObjectName object)
Возвращает временную метку производного значения указанного объекта, если этот объект входит в набор наблюдаемых MBean, или 0 в противном случае.
boolean getDifferenceMode()
Возвращает значение флага режима разности, общее для всех наблюдаемых MBean.
Number getHighThreshold()
Возвращает верхнее пороговое значение, общее для всех наблюдаемых MBean.
Number getLowThreshold()
Возвращает нижнее пороговое значение, общее для всех наблюдаемых MBean.
MBeanNotificationInfo[] getNotificationInfo()
Возвращает объект NotificationInfo, содержащий имя Java-класса уведомления и типы уведомлений, отправляемых монитором показателя.
boolean getNotifyHigh()
Возвращает значение переключателя верхнего уведомления (вкл./выкл.), общее для всех наблюдаемых MBean.
boolean getNotifyLow()
Возвращает значение переключателя нижнего уведомления (вкл./выкл.), общее для всех наблюдаемых MBean.
void setDifferenceMode(boolean value)
Задаёт значение флага режима разности, общее для всех наблюдаемых MBean.
void setNotifyHigh(boolean value)
Задаёт значение переключателя верхнего уведомления (вкл./выкл.), общее для всех наблюдаемых MBean.
void setNotifyLow(boolean value)
Задаёт значение переключателя нижнего уведомления (вкл./выкл.), общее для всех наблюдаемых MBean.
void setThresholds(Number highValue, Number lowValue)
Задаёт верхнее и нижнее пороговые значения, общие для всех наблюдаемых MBean.
void start()
Запускает монитор показателя.
void stop()
Останавливает монитор показателя.

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

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

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

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification

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

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

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

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

Подробное описание конструкторов

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(Number, Number)

getLowThreshold

public Number getLowThreshold()
Возвращает нижнее пороговое значение, общее для всех наблюдаемых MBean.
Определено в:
getLowThreshold в интерфейсе GaugeMonitorMBean
Возвращает:
Нижнее пороговое значение.
См. также:
  • setThresholds(Number, 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
Возвращает:
массив возможных уведомлений.

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, включая концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или её аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или её аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 1993, 2025, 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/25/docs/api/java.management/javax/management/monitor/GaugeMonitor.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API