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

クラスCounterMonitor

java.lang.Object
javax.management.NotificationBroadcasterSupport
javax.management.monitor.Monitor
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)

    • getInitThreshold

      public Number getInitThreshold()
      監視対象オブジェクトすべてに共通の初期しきい値を取得します。
      定義:
      getInitThreshold、インタフェース: CounterMonitorMBean
      戻り値:
      初期しきい値
      関連項目:
      setInitThreshold(java.lang.Number)

    • setInitThreshold

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

    • getDerivedGauge

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

    • getDerivedGaugeTimeStamp

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

    • getThreshold

      @Deprecated public Number getThreshold()
      非推奨。
      JMX 1.2以降は、getThreshold(ObjectName)に置き換えられています。
      監視対象のMBeanのセットに含まれる最初のオブジェクトのしきい値を取得します。
      定義:
      getThreshold、インタフェース: CounterMonitorMBean
      戻り値:
      しきい値。
      関連項目:
      setThreshold(java.lang.Number)

    • setThreshold

      @Deprecatedpublic void setThreshold​(Number value) throws IllegalArgumentException
      非推奨。
      JMX 1.2以降は、setInitThreshold(java.lang.Number)に置き換えられています。
      初期しきい値を設定します。
      定義:
      setThreshold、インタフェース: CounterMonitorMBean
      パラメータ:
      value - 初期しきい値。
      例外:
      IllegalArgumentException - 指定されたしきい値がnullか、ゼロより小さい場合。
      関連項目:
      getThreshold()

    • getOffset

      public Number getOffset()
      監視対象のMBeanすべてに共通のオフセット値を取得します。
      定義:
      getOffset、インタフェース: CounterMonitorMBean
      戻り値:
      オフセット値。
      関連項目:
      setOffset(java.lang.Number)

    • setOffset

      public void setOffset​(Number value) throws IllegalArgumentException
      監視対象のMBeanすべてに共通のオフセット値を設定します。
      定義:
      setOffset、インタフェース: CounterMonitorMBean
      パラメータ:
      value - オフセット値。
      例外:
      IllegalArgumentException - 指定されたオフセット値がnullか、ゼロより小さい場合。
      関連項目:
      getOffset()

    • getModulus

      public Number getModulus()
      監視対象のMBeanすべてに共通のモジュラス値を取得します。
      定義:
      getModulus、インタフェース: CounterMonitorMBean
      戻り値:
      モジュラス値。
      関連項目:
      setModulus(java.lang.Number)

    • setModulus

      public void setModulus​(Number value) throws IllegalArgumentException
      監視対象のMBeanすべてに共通のモジュラス値を設定します。
      定義:
      setModulus、インタフェース: CounterMonitorMBean
      パラメータ:
      value - モジュラス値。
      例外:
      IllegalArgumentException - 指定されたモジュラス値がnullか、ゼロより小さい場合。
      関連項目:
      getModulus()

    • 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
      戻り値:
      可能な通知の配列。