モジュール java.management
パッケージ 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

    • コンストラクタの詳細

      • GaugeMonitor

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

    • メソッドの詳細

      • 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、インタフェース: GaugeMonitorMBean
        パラメータ:
        object - MBeanの名前。
        戻り値:
        指定されたオブジェクトの派生ゲージ。

      • getDerivedGaugeTimeStamp

        public long getDerivedGaugeTimeStamp​(ObjectName object)
        指定のオブジェクトが監視対象のMBeanのセットに含まれる場合、このオブジェクトの派生ゲージのタイムスタンプを取得します。そうでない場合は0を取得します。
        定義:
        getDerivedGaugeTimeStamp、インタフェース: GaugeMonitorMBean
        パラメータ:
        object - オブジェクトの名前。このオブジェクトの派生ゲージのタイムスタンプが返される。
        戻り値:
        指定されたオブジェクトの派生ゲージのタイムスタンプ。

      • getDerivedGaugeTimeStamp

        @Deprecated
public long getDerivedGaugeTimeStamp()
        非推奨。
        JMX 1.2以降は、getDerivedGaugeTimeStamp(ObjectName)に置き換えられています。
        監視対象のMBeanのセットに含まれる最初のオブジェクトの派生ゲージのタイムスタンプを取得します。
        定義:
        getDerivedGaugeTimeStamp、インタフェース: GaugeMonitorMBean
        戻り値:
        派生ゲージのタイムスタンプ。

      • getNotifyHigh

        public boolean getNotifyHigh()
        監視対象のMBeanすべてに共通の通知のオン/オフ・スイッチ値の上限値を取得します。
        定義:
        getNotifyHigh、インタフェース: GaugeMonitorMBean
        戻り値:
        上限値を超過したときゲージ・モニターが通知を送る場合はtrue、そうでない場合はfalse。
        関連項目:
        setNotifyHigh(boolean)

      • setNotifyHigh

        public void setNotifyHigh​(boolean value)
        監視対象のMBeanすべてに共通の通知のオン/オフ・スイッチ値の上限値を設定します。
        定義:
        setNotifyHigh、インタフェース: GaugeMonitorMBean
        パラメータ:
        value - 通知のオン/オフ・スイッチ値の上限値。
        関連項目:
        getNotifyHigh()

      • getNotifyLow

        public boolean getNotifyLow()
        監視対象のMBean共通の通知のオン/オフ・スイッチ値の下限値を取得します。
        定義:
        getNotifyLow、インタフェース: GaugeMonitorMBean
        戻り値:
        下限値を超過したときゲージ・モニターが通知を送る場合はtrue、そうでない場合はfalse。
        関連項目:
        setNotifyLow(boolean)

      • setNotifyLow

        public void setNotifyLow​(boolean value)
        監視対象のMBeanすべてに共通の通知のオン/オフ・スイッチ値の下限値を設定します。
        定義:
        setNotifyLow、インタフェース: GaugeMonitorMBean
        パラメータ:
        value - 通知のオン/オフ・スイッチ値の下限値。
        関連項目:
        getNotifyLow()

      • getDifferenceMode

        public boolean getDifferenceMode()
        監視対象のMBeanすべてに共通の差分モード・フラグ値を取得します。
        定義:
        getDifferenceMode、インタフェース: GaugeMonitorMBean
        戻り値:
        差分モードを使用している場合はtrue、そうでない場合はfalse。
        関連項目:
        setDifferenceMode(boolean)

      • setDifferenceMode

        public void setDifferenceMode​(boolean value)
        監視対象のMBeanすべてに共通の差分モード・フラグ値を設定します。
        定義:
        setDifferenceMode、インタフェース: GaugeMonitorMBean
        パラメータ:
        value - 差分モード・フラグ値。
        関連項目:
        getDifferenceMode()

      • getNotificationInfo

        public MBeanNotificationInfo[] getNotificationInfo()
        ゲージ・モニターによって送信される通知のJavaクラス名と通知タイプを含むNotificationInfoオブジェクトを返します。
        定義:
        getNotificationInfo、インタフェース: NotificationBroadcaster
        戻り値:
        可能な通知の配列。