JavaTM 2 Platform
Standard Ed. 5.0

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 を定義します。

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

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

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

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

導入されたバージョン:
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
戻り値:
通知の配列

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。