モジュール java.management
パッケージ javax.management.monitor

クラスCounterMonitor

  • すべての実装されたインタフェース:
    MBeanRegistration, CounterMonitorMBean, MonitorMBean, NotificationBroadcaster, NotificationEmitter
    public class CounterMonitor
extends Monitor
implements CounterMonitorMBean
    カウンタ属性の値を監視するように設計されたモニターMBeanを定義します。

    カウンタ・モニターは、カウンタの値が比較レベルとして知られるしきい値以上になると、threshold notificationを送信します。 通知フラグはtrueに設定する必要があります。

    さらに、オフセット・メカニズムにより、特定のカウント間隔を検出できます。 オフセット値が0以外の場合、カウンタ値が比較レベルに達し、しきい値がトリガーされると、この比較レベルの値がオフセット値分増加します。 この処理はカウントが増加する前に瞬間的に行われます。 このため、各レベルで、オフセット値に等しい間隔でカウントが増加するたびに、しきい値によりイベント通知がトリガーされます。

    カウンタが最大値をラップできる場合、モジュラスを指定する必要があります。 モジュラスは、カウンタがゼロにリセットされる値です。

    カウンタ差分モードでは、連続した2回の観測によって検出された2つのカウンタ値の差分として、派生ゲージの値が計算されます。 この差分が負の数の場合、派生ゲージの値にモジュラス値が追加されます。 派生ゲージの値(V[t])は、次のようにして計算されます。

    • if (counter[t] - counter[t-GP]) is positive then V[t] = counter[t] - counter[t-GP]
    • if (counter[t] - counter[t-GP]) is negative then V[t] = counter[t] - counter[t-GP] + MODULUS
    このカウンタ・モニターの実装では、監視対象の属性が整数型(Byte、Integer、Short、Long)である必要があります。

    導入されたバージョン:
    1.5

    • コンストラクタの詳細

      • 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)

      • setInitThreshold

        public void setInitThreshold​(Number value)
                      throws IllegalArgumentException
        監視対象のオブジェクトすべてに共通の初期しきい値を設定します。
        その結果、監視対象のMBeanのセットに含まれるすべてのオブジェクトの現在のしきい値が更新されます。
        定義:
        setInitThreshold、インタフェースCounterMonitorMBean
        パラメータ:
        value - 初期しきい値。
        例外:
        IllegalArgumentException - 指定されたしきい値がnullか、ゼロより小さい場合。
        関連項目:
        getInitThreshold()

      • getDerivedGaugeTimeStamp

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

      • 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()
        カウンタ・モニターによって送信される通知のJavaクラス名と通知タイプを含むNotificationInfoオブジェクトを返します。
        定義:
        getNotificationInfo、インタフェースNotificationBroadcaster
        戻り値:
        可能な通知の配列。