Spec-Zone.ru › OpenJDK 17

Класс 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()
Возвращает объект, содержащий имя класса Java уведомления и типы уведомлений, отправляемых монитором датчика.
Определено в:
getNotificationInfo в интерфейсе NotificationBroadcaster
Возвращает:
массив возможных уведомлений.

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

Spec-Zone.ru

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