Spec-Zone.ru › OpenJDK 24

Класс 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

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

Поля, объявленные в классе 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)
Возвращает выведенный измеритель указанного объекта, если этот объект содержится в наборе наблюдаемых 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()
Останавливает монитор «измеритель».

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

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

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

addNotificationListener, handleNotification, removeNotificationListener, removeNotificationListener, 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

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

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, 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://download.java.net/java/early_access/jdk24/docs/api/java.management/javax/management/monitor/GaugeMonitor.html

Spec-Zone.ru

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