javax.management.monitor
クラス GaugeMonitor

java.lang.Object
  javax.management.NotificationBroadcasterSupport
      javax.management.monitor.Monitor
          javax.management.monitor.GaugeMonitor

すべての実装されたインタフェース:

MBeanRegistration, GaugeMonitorMBean, MonitorMBean, NotificationBroadcaster, NotificationEmitter

public class GaugeMonitor
extends Monitor
implements GaugeMonitorMBean

ゲージ属性の値を監視するように設計されたモニター MBean を定義します。

ゲージモニターは、時間の経過とともに変化する属性を監視します。ゲージモニターは、次のようにして通知を送信します。

• 属性値が大きくなり、上限値以上になると、threshold high notification が送信される。通知の上限フラグは true に設定する必要がある
  その後は、上限値を超えても、属性値が下限値以下にならないかぎり、通知は送信されない
• 属性値が小さくなり、下限値以下になると、threshold low notification が送信される。通知の下限フラグは true に設定する必要がある
  その後は、下限値を超えても、属性値が上限値以上にならないかぎり、通知は送信されない

これにより、属性値が上限または下限値の近辺で細かく増減しても、通知が繰り返しトリガされるのを防ぐヒステリシス機構が提供されます。

ゲージ差分モードを使用している場合、派生ゲージの値は、連続した 2 回の観測によって得られた 2 つのゲージ値の差分として計算されます。
派生ゲージ値 (V[t]) は、次のようにして計算されます。

• V[t] = gauge[t] - gauge[t-GP]

このゲージモニターの実装では、監視対象の属性が整数型または浮動小数点数型 (Byte、Integer、Short、Long、Float、Double) でなければなりません。

導入されたバージョン:

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

コンストラクタの概要

GaugeMonitor()
デフォルトのコンストラクタです。

メソッドの概要

Number	getDerivedGauge() 推奨されていません。 JMX 1.2 では getDerivedGauge(ObjectName) で置換されます。
Number	getDerivedGauge(ObjectName object) 指定のオブジェクトが監視対象の MBean のセットに含まれる場合、このオブジェクトの派生ゲージを取得します。
long	getDerivedGaugeTimeStamp() 推奨されていません。 JMX 1.2 では getDerivedGaugeTimeStamp(ObjectName) で置換されます。
long	getDerivedGaugeTimeStamp(ObjectName object) 指定のオブジェクトが監視対象の MBean のセットに含まれる場合、このオブジェクトの派生ゲージのタイムスタンプを取得します。
boolean	getDifferenceMode() 監視対象の MBean すべてに共通の差分モードフラグ値を取得します。
Number	getHighThreshold() 監視対象の MBean すべてに共通の上限値を取得します。
Number	getLowThreshold() 監視対象の MBean すべてに共通の下限値を取得します。
MBeanNotificationInfo[]	getNotificationInfo() 通知の Java クラス名と、ゲージモニターによって送信される通知型を含む NotificationInfo オブジェクトを返します。
boolean	getNotifyHigh() 監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の上限値を取得します。
boolean	getNotifyLow() 監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の下限値を取得します。
void	setDifferenceMode(boolean value) 監視対象の MBean すべてに共通の差分モードフラグ値を設定します。
void	setGranularityPeriod(long period) 粒度の周期をミリ秒単位で設定します。
void	setNotifyHigh(boolean value) 監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の上限値を設定します。
void	setNotifyLow(boolean value) 監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の下限値を設定します。
void	setThresholds(Number highValue, Number lowValue) 監視対象の MBean すべてに共通の上限および下限のしきい値を設定します。
void	start() ゲージモニターを開始します。
void	stop() ゲージモニターを停止します。

クラス javax.management.monitor.Monitor から継承されたメソッド

addObservedObject, containsObservedObject, getGranularityPeriod, getObservedAttribute, getObservedObject, getObservedObjects, isActive, postDeregister, postRegister, preDeregister, preRegister, removeObservedObject, 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, setObservedAttribute, setObservedObject

コンストラクタの詳細

GaugeMonitor

public GaugeMonitor()

デフォルトのコンストラクタです。

メソッドの詳細

start

public void start()

ゲージモニターを開始します。

定義:

インタフェース MonitorMBean 内の start

定義:

クラス Monitor 内の start

stop

public void stop()

ゲージモニターを停止します。

定義:

インタフェース MonitorMBean 内の stop

定義:

クラス Monitor 内の stop

setGranularityPeriod

public void setGranularityPeriod(long period)
                          throws IllegalArgumentException

粒度の周期をミリ秒単位で設定します。
デフォルトの粒度周期の値は 10 秒です。

定義:

インタフェース MonitorMBean 内の setGranularityPeriod

オーバーライド:

クラス Monitor 内の setGranularityPeriod

パラメータ:

period - 粒度周期の値

例外:

IllegalArgumentException - 粒度周期がゼロ以下の場合

関連項目:

Monitor.setGranularityPeriod(long)

getDerivedGauge

public Number getDerivedGauge(ObjectName object)

指定のオブジェクトが監視対象の MBean のセットに含まれる場合、このオブジェクトの派生ゲージを取得します。そうでない場合は null を取得します。

定義:

インタフェース GaugeMonitorMBean 内の getDerivedGauge

パラメータ:

object - MBean の名前

戻り値:

指定されたオブジェクトの派生ゲージ

getDerivedGaugeTimeStamp

public long getDerivedGaugeTimeStamp(ObjectName object)

指定のオブジェクトが監視対象の MBean のセットに含まれる場合、このオブジェクトの派生ゲージのタイムスタンプを取得します。そうでない場合は null を取得します。

定義:

インタフェース GaugeMonitorMBean 内の getDerivedGaugeTimeStamp

パラメータ:

object - MBean の名前

戻り値:

指定されたオブジェクトの派生ゲージのタイムスタンプ

getDerivedGauge

@Deprecated
public Number getDerivedGauge()

推奨されていません。 JMX 1.2 では getDerivedGauge(ObjectName) で置換されます。

監視対象の MBean のセットに含まれる最初のオブジェクトの派生ゲージを返します。

定義:

インタフェース GaugeMonitorMBean 内の getDerivedGauge

戻り値:

派生ゲージ

getDerivedGaugeTimeStamp

@Deprecated
public long getDerivedGaugeTimeStamp()

推奨されていません。 JMX 1.2 では getDerivedGaugeTimeStamp(ObjectName) で置換されます。

監視対象の MBean のセットに含まれる最初のオブジェクトの派生ゲージのタイムスタンプを取得します。

定義:

インタフェース GaugeMonitorMBean 内の getDerivedGaugeTimeStamp

戻り値:

派生ゲージのタイムスタンプ

getHighThreshold

public Number getHighThreshold()

監視対象の MBean すべてに共通の上限値を取得します。

定義:

インタフェース GaugeMonitorMBean 内の getHighThreshold

戻り値:

上限値

getLowThreshold

public Number getLowThreshold()

監視対象の MBean すべてに共通の下限値を取得します。

定義:

インタフェース GaugeMonitorMBean 内の getLowThreshold

戻り値:

下限値

setThresholds

public void setThresholds(Number highValue,
                          Number lowValue)
                   throws IllegalArgumentException

監視対象の MBean すべてに共通の上限および下限のしきい値を設定します。

定義:

インタフェース GaugeMonitorMBean 内の setThresholds

パラメータ:

highValue - 上限値

lowValue - 下限値

例外:

IllegalArgumentException - 上限および下限のしきい値として null が指定された場合、下限値が上限値より大きい場合、または上限値と下限値の型が異なる場合

getNotifyHigh

public boolean getNotifyHigh()

監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の上限値を取得します。

定義:

インタフェース GaugeMonitorMBean 内の getNotifyHigh

戻り値:

上限値を超過したときゲージモニターが通知を送る場合は true、そうでない場合は false

関連項目:

setNotifyHigh(boolean)

setNotifyHigh

public void setNotifyHigh(boolean value)

監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の上限値を設定します。

定義:

インタフェース GaugeMonitorMBean 内の setNotifyHigh

パラメータ:

value - 通知のオン/オフスイッチ値の上限値

関連項目:

getNotifyHigh()

getNotifyLow

public boolean getNotifyLow()

監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の下限値を取得します。

定義:

インタフェース GaugeMonitorMBean 内の getNotifyLow

戻り値:

下限値を超過したときゲージモニターが通知を送る場合は true、そうでない場合は false

関連項目:

setNotifyLow(boolean)

setNotifyLow

public void setNotifyLow(boolean value)

監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の下限値を設定します。

定義:

インタフェース GaugeMonitorMBean 内の setNotifyLow

パラメータ:

value - 通知のオン/オフスイッチ値の下限値

関連項目:

getNotifyLow()

getDifferenceMode

public boolean getDifferenceMode()

監視対象の MBean すべてに共通の差分モードフラグ値を取得します。

定義:

インタフェース GaugeMonitorMBean 内の getDifferenceMode

戻り値:

差分モードを使用している場合は true、そうでない場合は false

関連項目:

setDifferenceMode(boolean)

setDifferenceMode

public void setDifferenceMode(boolean value)

監視対象の MBean すべてに共通の差分モードフラグ値を設定します。

定義:

インタフェース GaugeMonitorMBean 内の setDifferenceMode

パラメータ:

value - 差分モードフラグ値

関連項目:

getDifferenceMode()

getNotificationInfo

public MBeanNotificationInfo[] getNotificationInfo()

通知の Java クラス名と、ゲージモニターによって送信される通知型を含む NotificationInfo オブジェクトを返します。

定義:

インタフェース NotificationBroadcaster 内の getNotificationInfo

オーバーライド:

クラス NotificationBroadcasterSupport 内の getNotificationInfo

戻り値:

通知の配列