Класс CounterMonitor

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] + МОДУЛЬ

Эта реализация монитора счётчика требует, чтобы наблюдаемый атрибут был типа целое число (Byte, Integer, Short, Long).

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

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

Переопределяет:

getNotificationInfo в классе NotificationBroadcasterSupport

Возвращает:

массив возможных уведомлений.