Класс CounterMonitor

Все реализованные интерфейсы:
MBeanRegistration, CounterMonitorMBean, MonitorMBean, NotificationBroadcaster, NotificationEmitter
public class CounterMonitor
extends Monitor
implements CounterMonitorMBean

Определяет MBean монитора, предназначенный для наблюдения за значениями атрибута счётчика.

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

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

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

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

  • если (счётчик[t] - счётчик[t-GP]) положительное, то V[t] = счётчик[t] - счётчик[t-GP]
  • если (счётчик[t] - счётчик[t-GP]) отрицательное, то V[t] = счётчик[t] - счётчик[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)

Получает выведенную шкалу (gauge) указанного объекта, если этот объект содержится в наборе наблюдаемых MBeans, или null в противном случае.

long getDerivedGaugeTimeStamp()

Устарело.

С JMX 1.2 заменено на getDerivedGaugeTimeStamp(ObjectName)

long getDerivedGaugeTimeStamp​(ObjectName object)

Получает отметку времени выведенной шкалы (gauge) указанного объекта, если этот объект содержится в наборе наблюдаемых MBeans, или 0 в противном случае.

boolean getDifferenceMode()

Получает значение флага режима разницы, общее для всех наблюдаемых MBeans.

Number getInitThreshold()

Получает начальное значение порога, общее для всех наблюдаемых объектов.

Number getModulus()

Получает значение модуля, общее для всех наблюдаемых MBeans.

MBeanNotificationInfo[] getNotificationInfo()

Возвращает объект NotificationInfo, содержащий имя Java-класса уведомления и типы уведомлений, отправляемые монитором счётчика.

boolean getNotify()

Получает значение переключателя уведомлений (вкл/выкл), общее для всех наблюдаемых MBeans.

Number getOffset()

Получает значение смещения, общее для всех наблюдаемых MBeans.

Number getThreshold()

Устарело.

С JMX 1.2 заменено на getThreshold(ObjectName)

Number getThreshold​(ObjectName object)

Получает текущее значение порога указанного объекта, если этот объект содержится в наборе наблюдаемых MBeans, или null в противном случае.

void setDifferenceMode​(boolean value)

Устанавливает значение флага режима разницы, общее для всех наблюдаемых MBeans.

void setInitThreshold​(Number value)

Устанавливает начальное значение порога, общее для всех наблюдаемых объектов.

void setModulus​(Number value)

Устанавливает значение модуля, общее для всех наблюдаемых MBeans.

void setNotify​(boolean value)

Устанавливает значение переключателя уведомлений (вкл/выкл), общее для всех наблюдаемых MBeans.

void setOffset​(Number value)

Устанавливает значение смещения, общее для всех наблюдаемых MBeans.

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, 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

Методы, объявленные в интерфейсе javax.management.NotificationBroadcaster

removeNotificationListener

Методы, объявленные в интерфейсе javax.management.NotificationEmitter

removeNotificationListener

Конструкторы

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, 2020, 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/11/docs/api/java.management/javax/management/monitor/CounterMonitor.html

Spec-Zone .ru
спецификации, руководства, описания, API