软件包 javax.management.monitor

提供 monitor 类的定义。

请参见：
描述

接口摘要

CounterMonitorMBean	公开计数器监视器 MBean 的远程管理接口。
GaugeMonitorMBean	公开尺度监视器 MBean 的远程管理接口。
MonitorMBean	公开监视器 MBeans 的远程管理接口。
StringMonitorMBean	公开字符串监视器 MBean 的远程管理接口。

类摘要

CounterMonitor	定义专门用来观察计数器属性值的监视器 MBean。
GaugeMonitor	定义专门用来观察尺度属性值的监视器 MBean。
Monitor	定义所有监视器 MBeans 的公共部分。
MonitorNotification	提供对监视器 MBeans 发送的通知的定义。
StringMonitor	定义设计用于观察字符串属性值的监视器 MBean。

异常摘要

MonitorSettingException

当监视器设置在运行监视器期间变得无效时由该监视器抛出的异常。

软件包 javax.management.monitor 的描述

提供 monitor 类的定义。Monitor 是一个 MBeans，它定期观察一个或多个其他 MBeans 中的属性值。如果某个属性满足特定的条件，则 Monitor 将发出一个 MonitorNotification。

《JMX 规范》中详细叙述了监视器的具体行为。下面是有关的概述。

共有三种监视器：

• CounterMonitor 观察整数类型的属性。假定这些属性为非负数，并且单调递增（以指定的模 进行的可能回滚 除外）。每个 observed 属性都具有相关的阈值。当属性超过其阈值时将发出一个通知。

  可以指定一个偏移量 值。当被观察值超过其阈值时，该阈值应按偏移量递增，或者按偏移量的倍数递增，以使其阈值足大于新的被观察值。

  CounterMonitor 可以在不同的模式 下操作。在本模式中，与阈值比较所得的值就是对属性的两次连续观察值之间的差分。

• GaugeMonitor 观察数字类型的属性。每个被观察属性都具有相关的高阈值 和低阈值。

  当 observed 属性超过高阈值时，如果 notify high 标记为 true，则发送一个通知。在尺度值变得小于或等于低阈值之前，后续的超出高阈值的情况不会触发更多的通知。

  当 observed 属性低于低阈值时，如果 notify low 标记为 true，则发送一个通知。在尺度值变得小于或等于高阈值之前，后续的超出低阈值的情况不会触发更多的通知。

  一般情况下，仅设置 notify high 和 notify low 标志中的一个。使用其他阈值来提供滞后 机制，以避免属性值在阈值附近进行小幅度摆动时重复触发通知。

  GaugeMonitor 可以在不同的模式 操作。在本模式中，与高、低阈值相比得出的值就是对属性的两次连续观察值之间的差分。

• StringMonitor 观察类型为 String 的属性。当 observed 属性变得等于和/或不等于指定的字符串时，将发出一个通知。

包规范

• JMX API 规范，1.2 版（第 9 章, Monitoring）

从以下版本开始：

1.5