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
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明非推奨。getDerivedGauge
(ObjectName object) 指定のオブジェクトが監視対象のMBeanのセットに含まれる場合、このオブジェクトの派生ゲージを取得します。そうでない場合はnull
を取得します。long
非推奨。JMX 1.2以降は、getDerivedGaugeTimeStamp(ObjectName)
に置き換えられています。long
getDerivedGaugeTimeStamp
(ObjectName object) 指定のオブジェクトが監視対象のMBeanのセットに含まれる場合、このオブジェクトの派生ゲージのタイムスタンプを取得します。そうでない場合は0
を取得します。boolean
監視対象のMBeanすべてに共通の差分モード・フラグ値を取得します。監視対象オブジェクトすべてに共通の初期しきい値を取得します。監視対象のMBeanすべてに共通のモジュラス値を取得します。カウンタ・モニターによって送信される通知のJavaクラス名と通知タイプを含むNotificationInfo
オブジェクトを返します。boolean
監視対象のMBeanすべてに共通の通知のオン/オフ・スイッチ値を取得します。監視対象のMBeanすべてに共通のオフセット値を取得します。非推奨。JMX 1.2以降は、getThreshold(ObjectName)
に置き換えられています。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
監視対象の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
-
stop
-
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
- オブジェクトの名前。このオブジェクトのしきい値が返される。- 戻り値:
- 指定されたオブジェクトのしきい値
- 関連項目:
-
getInitThreshold
public Number getInitThreshold()監視対象オブジェクトすべてに共通の初期しきい値を取得します。- 定義:
getInitThreshold
、インタフェースCounterMonitorMBean
- 戻り値:
- 初期しきい値
- 関連項目:
-
setInitThreshold
public void setInitThreshold(Number value) throws IllegalArgumentException 監視対象のオブジェクトすべてに共通の初期しきい値を設定します。
その結果、監視対象のMBeanのセットに含まれるすべてのオブジェクトの現在のしきい値が更新されます。- 定義:
setInitThreshold
、インタフェースCounterMonitorMBean
- パラメータ:
value
- 初期しきい値。- 例外:
IllegalArgumentException
- 指定されたしきい値がnullか、ゼロより小さい場合。- 関連項目:
-
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
@Deprecated public void setThreshold(Number value) throws IllegalArgumentException 非推奨。JMX 1.2以降は、setInitThreshold(java.lang.Number)
に置き換えられています。初期しきい値を設定します。- 定義:
setThreshold
、インタフェースCounterMonitorMBean
- パラメータ:
value
- 初期しきい値。- 例外:
IllegalArgumentException
- 指定されたしきい値がnullか、ゼロより小さい場合。- 関連項目:
-
getOffset
public Number getOffset()監視対象のMBeanすべてに共通のオフセット値を取得します。- 定義:
getOffset
、インタフェースCounterMonitorMBean
- 戻り値:
- オフセット値。
- 関連項目:
-
setOffset
public void setOffset(Number value) throws IllegalArgumentException 監視対象のMBeanすべてに共通のオフセット値を設定します。- 定義:
setOffset
、インタフェースCounterMonitorMBean
- パラメータ:
value
- オフセット値。- 例外:
IllegalArgumentException
- 指定されたオフセット値がnullか、ゼロより小さい場合。- 関連項目:
-
getModulus
public Number getModulus()監視対象のMBeanすべてに共通のモジュラス値を取得します。- 定義:
getModulus
、インタフェースCounterMonitorMBean
- 戻り値:
- モジュラス値。
- 関連項目:
-
setModulus
public void setModulus(Number value) throws IllegalArgumentException 監視対象のMBeanすべてに共通のモジュラス値を設定します。- 定義:
setModulus
、インタフェースCounterMonitorMBean
- パラメータ:
value
- モジュラス値。- 例外:
IllegalArgumentException
- 指定されたモジュラス値がnullか、ゼロより小さい場合。- 関連項目:
-
getNotify
public boolean getNotify()監視対象のMBeanすべてに共通の通知のオン/オフ・スイッチ値を取得します。- 定義:
getNotify
、インタフェースCounterMonitorMBean
- 戻り値:
- しきい値を超過したときカウンタ・モニターが通知を送る場合は
true
、そうでない場合はfalse
。 - 関連項目:
-
setNotify
public void setNotify(boolean value) 監視対象のMBeanすべてに共通の通知のオン/オフ・スイッチ値を設定します。- 定義:
setNotify
、インタフェースCounterMonitorMBean
- パラメータ:
value
- 通知のオン/オフ・スイッチ値。- 関連項目:
-
getDifferenceMode
public boolean getDifferenceMode()監視対象のMBeanすべてに共通の差分モード・フラグ値を取得します。- 定義:
getDifferenceMode
、インタフェースCounterMonitorMBean
- 戻り値:
- 差分モードを使用している場合は
true
、そうでない場合はfalse
。 - 関連項目:
-
setDifferenceMode
public void setDifferenceMode(boolean value) 監視対象のMBeanすべてに共通の差分モード・フラグ値を設定します。- 定義:
setDifferenceMode
、インタフェースCounterMonitorMBean
- パラメータ:
value
- 差分モード・フラグ値。- 関連項目:
-
getNotificationInfo
public MBeanNotificationInfo[] getNotificationInfo()カウンタ・モニターによって送信される通知のJavaクラス名と通知タイプを含むNotificationInfo
オブジェクトを返します。- 定義:
getNotificationInfo
、インタフェースNotificationBroadcaster
- 戻り値:
- 可能な通知の配列。
-
getDerivedGauge(ObjectName)
に置き換えられています。