Spec-Zone.ru › OpenJDK 25

Класс 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
В этой реализации монитора счетчика атрибут, за которым ведется наблюдение, должен иметь целочисленный тип (Byte, Integer, Short, Long).
С момента:
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

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

Конструктор Описание
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(Number)
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

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

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

getInitThreshold

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

setThreshold

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

getOffset

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

setOffset

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

getModulus

public Number getModulus()
Возвращает значение модуля, общее для всех наблюдаемых MBean.
Определен в:
getModulus в интерфейсе CounterMonitorMBean
Возвращает:
Значение модуля.
См. также:
  • setModulus(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()
Возвращает значение флага режима разности, общее для всех наблюдаемых MBean.
Определен в:
getDifferenceMode в интерфейсе CounterMonitorMBean
Возвращает:
true, если используется режим разности; в противном случае — false.
См. также:
  • setDifferenceMode(boolean)

setDifferenceMode

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

Spec-Zone.ru

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