Spec-Zone.ru › OpenJDK 27

Класс 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
Модификатор и тип Поле Описание
protected int alreadyNotified
Устарело.
эквивалентно Monitor.alreadyNotifieds[0].
protected int[] alreadyNotifieds
Выбранные ошибки монитора, о которых уже отправлены уведомления.
protected static final int capacityIncrement
Величина, на которую автоматически увеличивается емкость массивов монитора, когда их размер превышает емкость.
protected String dbgTag
Устарело.
Замены нет.
protected int elementCount
Количество допустимых элементов в векторе наблюдаемых объектов.
protected static final int OBSERVED_ATTRIBUTE_ERROR_NOTIFIED
Флаг, указывающий, что после изменения наблюдаемого атрибута было отправлено уведомление.
protected static final int OBSERVED_ATTRIBUTE_TYPE_ERROR_NOTIFIED
Флаг, указывающий, что после изменения наблюдаемого объекта или наблюдаемого атрибута было отправлено уведомление.
protected static final int OBSERVED_OBJECT_ERROR_NOTIFIED
Флаг, указывающий, что после изменения наблюдаемого объекта было отправлено уведомление.
protected static final int RESET_FLAGS_ALREADY_NOTIFIED
Этот флаг используется для сброса атрибута монитора alreadyNotifieds.
protected static final int RUNTIME_ERROR_NOTIFIED
Флаг, указывающий, что после изменения наблюдаемого объекта или наблюдаемого атрибута было отправлено уведомление.
protected MBeanServer server
Ссылка на сервер MBean.

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

Конструктор Описание
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
Модификатор и тип Метод Описание
void addObservedObject(ObjectName object)
Добавляет указанный объект в набор наблюдаемых MBean, если этот объект еще не присутствует в наборе.
boolean containsObservedObject(ObjectName object)
Проверяет, входит ли указанный объект в набор наблюдаемых MBean.
long getGranularityPeriod()
Возвращает период дискретизации (в миллисекундах).
String getObservedAttribute()
Возвращает наблюдаемый атрибут.
ObjectName getObservedObject()
Устарело.
Начиная с JMX 1.2 заменен методом Monitor.getObservedObjects()
ObjectName[] getObservedObjects()
Возвращает массив, содержащий наблюдаемые объекты.
boolean isActive()
Проверяет, активен ли MBean монитора.
void postDeregister()
Позволяет MBean монитора выполнить необходимые действия после его отмены регистрации сервером MBean.
void postRegister(Boolean registrationDone)
Позволяет MBean монитора выполнить необходимые действия после его регистрации на сервере MBean или после неудачной попытки регистрации.
void preDeregister()
Позволяет MBean монитора выполнить необходимые действия перед отменой его регистрации сервером MBean.
ObjectName preRegister(MBeanServer server, ObjectName name)
Позволяет MBean монитора выполнить необходимые действия перед его регистрацией на сервере MBean.
void removeObservedObject(ObjectName object)
Удаляет указанный объект из набора наблюдаемых MBean.
void setGranularityPeriod(long period)
Устанавливает период дискретизации (в миллисекундах).
void setObservedAttribute(String attribute)
Устанавливает наблюдаемый атрибут.
void setObservedObject(ObjectName object)
Устарело.
Начиная с JMX 1.2 заменен методом Monitor.addObservedObject(ObjectName)

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

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, sendNotification
Модификатор и тип Метод Описание
void addNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)
Добавляет прослушиватель.
protected void handleNotification(NotificationListener listener, Notification notif, Object handback)
Этот метод вызывается методом sendNotification для каждого прослушивателя, чтобы отправить ему уведомление.
void removeNotificationListener(NotificationListener listener)
Удаляет прослушиватель из этого MBean.
void removeNotificationListener(NotificationListener listener, NotificationFilter filter, Object handback)
Удаляет прослушиватель из этого MBean.
void sendNotification(Notification notification)
Отправляет уведомление.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли какой-либо другой объект этому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API может быть удален в будущей версии.
Финализация устарела и может быть удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо истечения заданного промежутка реального времени.

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

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, 2026, 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.

Spec-Zone.ru

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