GaugeMonitor (Java Platform SE 7)

java.lang.Object
- javax.management.NotificationBroadcasterSupport
- - javax.management.monitor.Monitor
  - - javax.management.monitor.GaugeMonitor

すべての実装されたインタフェース:

MBeanRegistration, GaugeMonitorMBean, MonitorMBean, NotificationBroadcaster, NotificationEmitter
```
public class GaugeMonitor
extends Monitor
implements GaugeMonitorMBean
```
ゲージ属性の値を監視するように設計されたモニター MBean を定義します。
ゲージモニターは、時間の経過とともに変化する属性を監視します。ゲージモニターは、次のようにして通知を送信します。
- 属性値が大きくなり、上限値以上になると、threshold high notification が送信されます。通知の上限フラグは true に設定する必要があります。
  その後は、上限値を超過しても、属性値が下限値以下にならないかぎり、通知は送信されません。
- 属性値が小さくなり、下限値以下になると、threshold low notification が送信されます。通知の下限フラグは true に設定する必要があります。
  その後は、下限値を超えても、属性値が上限値以上にならないかぎり、通知は送信されません。
これにより、属性値が上限または下限値の近辺で細かく増減しても、通知が繰り返しトリガーされるのを防ぐヒステリシスメカニズムが提供されます。
ゲージ差分モードを使用している場合、派生ゲージの値は、連続した 2 回の観測によって得られた 2 つのゲージ値の差分として計算されます。
派生ゲージの値 (V[t]) は、次のようにして計算されます。
- V[t] = gauge[t] - gauge[t-GP]
このゲージモニターの実装では、監視対象の属性が整数型または浮動小数点数型 (Byte、Integer、Short、Long、Float、Double) である必要があります。
導入されたバージョン:

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

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

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

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

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

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`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`	`getHighThreshold()` 監視対象の MBean すべてに共通の上限値を取得します。
`Number`	`getLowThreshold()` 監視対象の MBean すべてに共通の下限値を取得します。
`MBeanNotificationInfo[]`	`getNotificationInfo()` ゲージモニターによって送信される通知の Java クラス名と通知タイプを含む `NotificationInfo` オブジェクトを返します。
`boolean`	`getNotifyHigh()` 監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の上限値を取得します。
`boolean`	`getNotifyLow()` 監視対象の MBean 共通の通知のオン/オフスイッチ値の下限値を取得します。
`void`	`setDifferenceMode(boolean value)` 監視対象の MBean すべてに共通の差分モードフラグ値を設定します。
`void`	`setNotifyHigh(boolean value)` 監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の上限値を設定します。
`void`	`setNotifyLow(boolean value)` 監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の下限値を設定します。
`void`	`setThresholds(Number highValue, Number lowValue)` 監視対象の MBean すべてに共通の上限および下限のしきい値を設定します。
`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

- コンストラクタの詳細
  - GaugeMonitor
```
public GaugeMonitor()
```
    デフォルトのコンストラクタです。
- メソッドの詳細
  - 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、インタフェース: GaugeMonitorMBean
    
    パラメータ:
    object - MBean の名前。
    
    戻り値:
    指定されたオブジェクトの派生ゲージ。
  - getDerivedGaugeTimeStamp
```
public long getDerivedGaugeTimeStamp(ObjectName object)
```
    指定のオブジェクトが監視対象の MBean のセットに含まれる場合、このオブジェクトの派生ゲージのタイムスタンプを取得します。そうでない場合は 0 を取得します。
    
    定義:
    
    getDerivedGaugeTimeStamp、インタフェース: GaugeMonitorMBean
    
    パラメータ:
    object - オブジェクトの名前。このオブジェクトの派生ゲージのタイムスタンプが返される。
    
    戻り値:
    指定されたオブジェクトの派生ゲージのタイムスタンプ。
  - getDerivedGauge
```
@Deprecated
public Number getDerivedGauge()
```
    非推奨。JMX 1.2 以降は、getDerivedGauge(ObjectName) に置き換えられています。
    
    監視対象の MBean のセットに含まれる最初のオブジェクトの派生ゲージを返します。
    
    定義:
    
    getDerivedGauge、インタフェース: GaugeMonitorMBean
    
    戻り値:
    派生ゲージ。
  - getDerivedGaugeTimeStamp
```
@Deprecated
public long getDerivedGaugeTimeStamp()
```
    非推奨。JMX 1.2 以降は、getDerivedGaugeTimeStamp(ObjectName) に置き換えられています。
    
    監視対象の MBean のセットに含まれる最初のオブジェクトの派生ゲージのタイムスタンプを取得します。
    
    定義:
    
    getDerivedGaugeTimeStamp、インタフェース: GaugeMonitorMBean
    
    戻り値:
    派生ゲージのタイムスタンプ。
  - getHighThreshold
```
public Number getHighThreshold()
```
    監視対象の MBean すべてに共通の上限値を取得します。
    
    定義:
    
    getHighThreshold、インタフェース: GaugeMonitorMBean
    
    戻り値:
    上限値。
    関連項目:
    setThresholds(java.lang.Number, java.lang.Number)
  - getLowThreshold
```
public Number getLowThreshold()
```
    監視対象の MBean すべてに共通の下限値を取得します。
    
    定義:
    
    getLowThreshold、インタフェース: GaugeMonitorMBean
    
    戻り値:
    下限値。
    関連項目:
    setThresholds(java.lang.Number, java.lang.Number)
  - setThresholds
```
public void setThresholds(Number highValue,
                 Number lowValue)
                   throws IllegalArgumentException
```
    監視対象の MBean すべてに共通の上限および下限のしきい値を設定します。
    
    定義:
    
    setThresholds、インタフェース: GaugeMonitorMBean
    
    パラメータ:
    highValue - 上限値。
    lowValue - 下限値。
    
    例外:
    
    IllegalArgumentException - 上限および下限のしきい値として null が指定された場合、下限値が上限値より大きい場合、または上限値と下限値の型が異なる場合。
    関連項目:
    getHighThreshold(), getLowThreshold()
  - getNotifyHigh
```
public boolean getNotifyHigh()
```
    監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の上限値を取得します。
    
    定義:
    
    getNotifyHigh、インタフェース: GaugeMonitorMBean
    
    戻り値:
    上限値を超過したときゲージモニターが通知を送る場合は true、そうでない場合は false。
    関連項目:
    setNotifyHigh(boolean)
  - setNotifyHigh
```
public void setNotifyHigh(boolean value)
```
    監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の上限値を設定します。
    
    定義:
    
    setNotifyHigh、インタフェース: GaugeMonitorMBean
    
    パラメータ:
    value - 通知のオン/オフスイッチ値の上限値。
    関連項目:
    getNotifyHigh()
  - getNotifyLow
```
public boolean getNotifyLow()
```
    監視対象の MBean 共通の通知のオン/オフスイッチ値の下限値を取得します。
    
    定義:
    
    getNotifyLow、インタフェース: GaugeMonitorMBean
    
    戻り値:
    下限値を超過したときゲージモニターが通知を送る場合は true、そうでない場合は false。
    関連項目:
    setNotifyLow(boolean)
  - setNotifyLow
```
public void setNotifyLow(boolean value)
```
    監視対象の MBean すべてに共通の通知のオン/オフスイッチ値の下限値を設定します。
    
    定義:
    
    setNotifyLow、インタフェース: GaugeMonitorMBean
    
    パラメータ:
    value - 通知のオン/オフスイッチ値の下限値。
    関連項目:
    getNotifyLow()
  - getDifferenceMode
```
public boolean getDifferenceMode()
```
    監視対象の MBean すべてに共通の差分モードフラグ値を取得します。
    
    定義:
    
    getDifferenceMode、インタフェース: GaugeMonitorMBean
    
    戻り値:
    差分モードを使用している場合は true、そうでない場合は false。
    関連項目:
    setDifferenceMode(boolean)
  - setDifferenceMode
```
public void setDifferenceMode(boolean value)
```
    監視対象の MBean すべてに共通の差分モードフラグ値を設定します。
    
    定義:
    
    setDifferenceMode、インタフェース: GaugeMonitorMBean
    
    パラメータ:
    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.

クラス GaugeMonitor

フィールドのサマリー

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

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

メソッドのサマリー

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

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

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

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

コンストラクタの詳細

GaugeMonitor

メソッドの詳細

start

stop

getDerivedGauge

getDerivedGaugeTimeStamp

getDerivedGauge

getDerivedGaugeTimeStamp

getHighThreshold

getLowThreshold

setThresholds

getNotifyHigh

setNotifyHigh

getNotifyLow

setNotifyLow

getDifferenceMode

setDifferenceMode

getNotificationInfo