CounterMonitor (Java Platform SE 7)

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, 2013, Oracle and/or its affiliates. All rights reserved.

クラス 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