Spec-Zone.ru › OpenJDK 17

Класс 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]) вычисляется следующим образом:

  • если (счётчик[t] - счётчик[t-GP]) положительно, то V[t] = счётчик[t] - счётчик[t-GP]
  • если (счётчик[t] - счётчик[t-GP]) отрицательно, то V[t] = счётчик[t] - счётчик[t-GP] + MODULUS
Эта реализация монитора счётчика требует, чтобы наблюдаемый атрибут был целого типа (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()
Получает значение флага режима разницы, общее для всех наблюдаемых 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
Возвращает:
массив возможных уведомлений.

© 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/CounterMonitor.html

Spec-Zone.ru

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