CounterMonitor (Java Platform SE 8)

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

フィールドのサマリー
- クラス 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

コンストラクタのサマリー

コンストラクタ
コンストラクタ説明

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

コンストラクタ
コンストラクタ	説明
`CounterMonitor()`	デフォルトのコンストラクタです。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド非推奨メソッド
修飾子と型	メソッド	説明
`Number`	`getDerivedGauge()`	非推奨。 JMX 1.2以降は、`getDerivedGauge(ObjectName)`に置き換えられています。
`Number`	`getDerivedGauge(ObjectName object)`	指定のオブジェクトが監視対象のMBeanのセットに含まれる場合、このオブジェクトの派生ゲージを取得します。そうでない場合は`null`を取得します。
`long`	`getDerivedGaugeTimeStamp()`	非推奨。 JMX 1.2以降は、`getDerivedGaugeTimeStamp(ObjectName)`に置き換えられています。
`long`	`getDerivedGaugeTimeStamp(ObjectName object)`	指定のオブジェクトが監視対象のMBeanのセットに含まれる場合、このオブジェクトの派生ゲージのタイムスタンプを取得します。そうでない場合は`0`を取得します。
`boolean`	`getDifferenceMode()`	監視対象のMBeanすべてに共通の差分モード・フラグ値を取得します。
`Number`	`getInitThreshold()`	監視対象オブジェクトすべてに共通の初期しきい値を取得します。
`Number`	`getModulus()`	監視対象のMBeanすべてに共通のモジュラス値を取得します。
`MBeanNotificationInfo[]`	`getNotificationInfo()`	カウンタ・モニターによって送信される通知のJavaクラス名と通知タイプを含む`NotificationInfo`オブジェクトを返します。
`boolean`	`getNotify()`	監視対象のMBeanすべてに共通の通知のオン/オフ・スイッチ値を取得します。
`Number`	`getOffset()`	監視対象のMBeanすべてに共通のオフセット値を取得します。
`Number`	`getThreshold()`	非推奨。 JMX 1.2以降は、`getThreshold(ObjectName)`に置き換えられています。
`Number`	`getThreshold(ObjectName object)`	指定のオブジェクトが監視対象のMBeanのセットに含まれる場合、このオブジェクトの現在のしきい値を取得します。そうでない場合は`null`を取得します。
`void`	`setDifferenceMode(boolean value)`	監視対象のMBeanすべてに共通の差分モード・フラグ値を設定します。
`void`	`setInitThreshold(Number value)`	監視対象のオブジェクトすべてに共通の初期しきい値を設定します。
`void`	`setModulus(Number value)`	監視対象のMBeanすべてに共通のモジュラス値を設定します。
`void`	`setNotify(boolean value)`	監視対象のMBeanすべてに共通の通知のオン/オフ・スイッチ値を設定します。
`void`	`setOffset(Number value)`	監視対象のMBeanすべてに共通のオフセット値を設定します。
`void`	`setThreshold(Number value)`	非推奨。 JMX 1.2以降は、`setInitThreshold(java.lang.Number)`に置き換えられています。
`void`	`start()`	カウンタ・モニターを開始します。
`void`	`stop()`	カウンタ・モニターを停止します。

クラス javax.management.monitor.Monitorから継承されたメソッド
addObservedObject, containsObservedObject, getGranularityPeriod, getObservedAttribute, getObservedObject, getObservedObjects, isActive, postDeregister, postRegister, preDeregister, preRegister, removeObservedObject, setGranularityPeriod, 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, setGranularityPeriod, setObservedAttribute, setObservedObject

- コンストラクタの詳細
  - 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
```
@Deprecated
public 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
    
    オーバーライド:
    
    getNotificationInfo、クラスNotificationBroadcasterSupport
    
    戻り値:
    
    可能な通知の配列。

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスCounterMonitor

フィールドのサマリー

クラス javax.management.monitor.Monitorから継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

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

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

クラス java.lang.Objectから継承されたメソッド

インタフェース javax.management.monitor.MonitorMBeanから継承されたメソッド

コンストラクタの詳細

CounterMonitor

メソッドの詳細

start

stop

getDerivedGauge

getDerivedGaugeTimeStamp

getThreshold

getInitThreshold

setInitThreshold

getDerivedGauge

getDerivedGaugeTimeStamp

getThreshold

setThreshold

getOffset

setOffset

getModulus

setModulus

getNotify

setNotify

getDifferenceMode

setDifferenceMode

getNotificationInfo