Spec-Zone.ru › OpenJDK 24

Класс CounterMonitor

java.lang.Object
javax.management.NotificationBroadcasterSupport
javax.management.monitor.Monitor
javax.management.monitor.CounterMonitor
Все реализованные интерфейсы:
MBeanRegistration, CounterMonitorMBean, MonitorMBean, NotificationBroadcaster, NotificationEmitter 
public class CounterMonitor extends Monitor implements CounterMonitorMBean
Определяет MBean монитора, предназначенного для наблюдения за значениями атрибута счётчика.

Монитор счётчика отправляет threshold notification, когда значение счётчика достигает или превышает порог, известный как уровень сравнения. Флаг уведомления должен быть установлен в true.

Кроме того, механизм смещения позволяет обнаруживать определённые интервалы подсчёта. Если значение смещения не равно нулю, всякий раз, когда порог срабатывает из-за того, что значение счётчика достигает уровня сравнения, этот уровень сравнения увеличивается на значение смещения. Это считается происходящим мгновенно, то есть до увеличения счётчика. Таким образом, для каждого уровня порог инициирует событие уведомления всякий раз, когда счётчик увеличивается на интервал, равный значению смещения.

Если счётчик может переходить к максимальному значению, необходимо указать модуль. Модуль - это значение, при котором счётчик сбрасывается до нуля.

Если используется режим разницы счётчика, значение выведенного измерителя вычисляется как разность между наблюдаемыми значениями счётчика для двух последовательных наблюдений. Если эта разность отрицательная, значение выведенного измерителя увеличивается на значение модуля. Значение выведенного измерителя (V[t]) вычисляется следующим образом:

  • если (counter[t] - counter[t-GP]) положительно, то V[t] = counter[t] - counter[t-GP]
  • если (counter[t] - counter[t-GP]) отрицательно, то V[t] = counter[t] - counter[t-GP] + MODULUS
Эта реализация монитора счётчика требует, чтобы наблюдаемый атрибут был типа integer (Byte, Integer, Short, Long).
С:
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

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

Конструктор Описание
CounterMonitor()
Конструктор по умолчанию.

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

Модификатор и тип Метод Описание
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 getInitThreshold()
Получает начальное значение порога, общее для всех наблюдаемых объектов.
Number getModulus()
Получает значение модуля, общее для всех наблюдаемых MBean.
MBeanNotificationInfo[] getNotificationInfo()
Возвращает объект NotificationInfo, содержащий имя Java-класса уведомления и типы уведомлений, отправляемых монитором счётчика.
boolean getNotify()
Получает значение переключателя уведомления включено/выключено, общее для всех наблюдаемых MBean.
Number getOffset()
Получает значение смещения, общее для всех наблюдаемых MBean.
Number getThreshold()
Устарело.
Начиная с JMX 1.2, заменено на getThreshold(ObjectName)
Number getThreshold(ObjectName object)
Получает текущее значение порога указанного объекта, если этот объект содержится в наборе наблюдаемых MBean, или null в противном случае.
void setDifferenceMode(boolean value)
Устанавливает значение флага режима разницы, общее для всех наблюдаемых MBean.
void setInitThreshold(Number value)
Устанавливает начальное значение порога, общее для всех наблюдаемых объектов.
void setModulus(Number value)
Устанавливает значение модуля, общее для всех наблюдаемых MBean.
void setNotify(boolean value)
Устанавливает значение переключателя уведомления включено/выключено, общее для всех наблюдаемых MBean.
void setOffset(Number value)
Устанавливает значение смещения, общее для всех наблюдаемых MBean.
void setThreshold(Number value)
Устарело.
Начиная с JMX 1.2, заменено на setInitThreshold(java.lang.Number)
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

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

CounterMonitor

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

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

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 в интерфейсе CounterMonitorMBean
Параметры:
object - имя объекта, производный датчик которого необходимо вернуть.
Возвращает:
Производный датчик указанного объекта.

getDerivedGaugeTimeStamp

public long getDerivedGaugeTimeStamp(ObjectName object)
Возвращает метку времени производного датчика указанного объекта, если этот объект содержится в наборе наблюдаемых MBean, или 0 в противном случае.
Указано в:
getDerivedGaugeTimeStamp в интерфейсе CounterMonitorMBean
Параметры:
object - имя объекта, метка времени производного датчика которого необходимо вернуть.
Возвращает:
Метка времени производного датчика указанного объекта.

getThreshold

public Number getThreshold(ObjectName object)
Возвращает текущее пороговое значение указанного объекта, если этот объект содержится в наборе наблюдаемых MBean, или null в противном случае.
Указано в:
getThreshold в интерфейсе CounterMonitorMBean
Параметры:
object - имя объекта, порог которого необходимо вернуть.
Возвращает:
Пороговое значение указанного объекта.
См. также:
  • CounterMonitorMBean.setThreshold(java.lang.Number)

getInitThreshold

public Number getInitThreshold()
Возвращает начальное пороговое значение, общее для всех наблюдаемых объектов.
Указано в:
getInitThreshold в интерфейсе CounterMonitorMBean
Возвращает:
Начальный порог.
См. также:
  • setInitThreshold(java.lang.Number)

setInitThreshold

public void setInitThreshold(Number value) throws IllegalArgumentException
Устанавливает начальное пороговое значение, общее для всех наблюдаемых объектов.
Текущий порог каждого объекта в наборе наблюдаемых MBean обновляется соответственно.
Указано в:
setInitThreshold в интерфейсе CounterMonitorMBean
Параметры:
value - Начальное пороговое значение.
Исключения:
IllegalArgumentException - Указанный порог имеет значение null или значение порога меньше нуля.
См. также:
  • getInitThreshold()

getDerivedGauge

@Deprecated public Number getDerivedGauge()
Устарело.
Начиная с JMX 1.2, заменено на getDerivedGauge(ObjectName)
Возвращает производный датчик первого объекта в наборе наблюдаемых MBean.
Указано в:
getDerivedGauge в интерфейсе CounterMonitorMBean
Возвращает:
Производный датчик.

getDerivedGaugeTimeStamp

@Deprecated public long getDerivedGaugeTimeStamp()
Устарело.
Начиная с JMX 1.2, заменено на getDerivedGaugeTimeStamp(ObjectName)
Возвращает метку времени производного датчика первого объекта в наборе наблюдаемых MBean.
Указано в:
getDerivedGaugeTimeStamp в интерфейсе CounterMonitorMBean
Возвращает:
Метка времени производного датчика.

getThreshold

@Deprecated public Number getThreshold()
Устарело.
Начиная с JMX 1.2, заменено на getThreshold(ObjectName)
Возвращает пороговое значение первого объекта в наборе наблюдаемых MBean.
Указано в:
getThreshold в интерфейсе CounterMonitorMBean
Возвращает:
Пороговое значение.
См. также:
  • setThreshold(java.lang.Number)

setThreshold

@Deprecated public void setThreshold(Number value) throws IllegalArgumentException
Устарело.
Начиная с JMX 1.2, заменено на setInitThreshold(java.lang.Number)
Устанавливает начальное пороговое значение.
Указано в:
setThreshold в интерфейсе CounterMonitorMBean
Параметры:
value - Начальное пороговое значение.
Исключения:
IllegalArgumentException - Указанный порог имеет значение null или значение порога меньше нуля.
См. также:
  • getThreshold()

getOffset

public Number getOffset()
Возвращает значение смещения, общее для всех наблюдаемых MBean.
Указано в:
getOffset в интерфейсе CounterMonitorMBean
Возвращает:
Значение смещения.
См. также:
  • setOffset(java.lang.Number)

setOffset

public void setOffset(Number value) throws IllegalArgumentException
Устанавливает значение смещения, общее для всех наблюдаемых MBean.
Указано в:
setOffset в интерфейсе CounterMonitorMBean
Параметры:
value - Значение смещения.
Исключения:
IllegalArgumentException - Указанное смещение имеет значение null или значение смещения меньше нуля.
См. также:
  • getOffset()

getModulus

public Number getModulus()
Возвращает значение модуля, общее для всех наблюдаемых MBean.
Указано в:
getModulus в интерфейсе CounterMonitorMBean
Возвращает:
Значение модуля.
См. также:
  • setModulus(java.lang.Number)

setModulus

public void setModulus(Number value) throws IllegalArgumentException
Устанавливает значение модуля, общее для всех наблюдаемых MBean.
Указано в:
setModulus в интерфейсе CounterMonitorMBean
Параметры:
value - Значение модуля.
Исключения:
IllegalArgumentException - Указанный модуль имеет значение null или значение модуля меньше нуля.
См. также:
  • getModulus()

getNotify

public boolean getNotify()
Возвращает значение переключателя включения/выключения уведомлений, общее для всех наблюдаемых MBean.
Указано в:
getNotify в интерфейсе CounterMonitorMBean
Возвращает:
true если монитор счётчика уведомляет о превышении порога, false в противном случае.
См. также:
  • setNotify(boolean)

setNotify

public void setNotify(boolean value)
Устанавливает значение переключателя включения/выключения уведомлений, общее для всех наблюдаемых MBean.
Указано в:
setNotify в интерфейсе CounterMonitorMBean
Параметры:
value - Значение переключателя включения/выключения уведомлений.
См. также:
  • getNotify()

getDifferenceMode

public boolean getDifferenceMode()
Получает значение флага режима разницы, общее для всех наблюдаемых MBeans.
Определяется:
getDifferenceMode в интерфейсе CounterMonitorMBean
Возвращает:
true, если используется режим разницы, false в противном случае.
См. также:
  • setDifferenceMode(boolean)

setDifferenceMode

public void setDifferenceMode(boolean value)
Устанавливает значение флага режима разницы, общее для всех наблюдаемых MBeans.
Определяется:
setDifferenceMode в интерфейсе CounterMonitorMBean
Параметры:
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/CounterMonitor.html

Spec-Zone.ru

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