パッケージ javax.management.monitor
モニター・クラスを定義します。 Monitorは、1つ以上のその他のMBeanに含まれる属性の値を定期的に観測するMBeanです。 属性が特定の条件を満たす場合、MonitorはMonitorNotification
を発行します。 モニターMBeanが監視中の属性の値を取得するためにgetAttribute
を周期的に呼び出す場合、呼出し側Monitor.start()
のアクセス制御コンテキスト内でこれを実行します。
監視する値は、複合型の内部に含まれた単純な値にすることができます。 たとえば、java.lang.management
内で定義されたMemoryMXBean
は、MemoryUsage
型のHeapMemoryUsage
属性を持ちます。 MemoryUsage
のused
プロパティで示されるusedメモリーの量を監視するには、HeapMemoryUsage.used
を監視します。 この文字列が、setObservedAttribute
の引数になります。
HeapMemoryUsage.used
などのObservedAttribute
を解釈するための規則は、次のようになります。 文字列がA.e (この例では、AがHeapMemoryUsage
、eがused
)であるものとします。
最初に、属性Aの値が取得されます。 これをvとします。 次のようにして、vから値xが抽出されます。
- vが
CompositeData
で、かつv.get
(e)が値を返す場合、xはその値です。 - vが配列で、かつeが文字列
length
である場合、xは配列の長さです。 - 前述の規則で値が生成されない場合、およびvのクラス(v.
getClass()
)のイントロスペクションによって(Introspector.getBeanInfo
を呼び出すときと同様に)、名前eを含むプロパティが識別される場合、そのプロパティ値が読み取られた結果はxになります。
3番目の規則について考えましょう。たとえば、属性HeapMemoryUsage
がMemoryUsage
である場合、HeapMemoryUsage.used
を監視すると、MemoryUsage.getUsed()
が呼び出されて監視対象の値が取得されます。
ConnectionPool.connectionStats.length
のようにObservedAttribute
に、複数のピリオドが含まれる場合、前述の規則が繰返し適用されます。 ここで、vは初期状態では属性ConnectionPool
の値になります。xは、eとconnectionStats
を等価にして前述の規則を適用することで得られます。 次に、vがこのxに設定されます。新しいxは、eとlength
を等価にして規則を再度適用することで得られます。
属性名は、有効なJava識別子にすることが推奨されていますが、HeapMemoryUsage.used
にすることも可能です。 このため、ObservedAttribute
がHeapMemoryUsage.used
であるとすると、監視対象の値がその名前の属性である場合と、HeapMemoryUsage
という名前の属性内部のused
プロパティである場合とが考えられます。 互換性を維持するため、ObservedAttribute
にピリオド(.
)が含まれる場合、モニターは、名前が完全なObservedAttribute
文字列(この例ではHeapMemoryUsage.used
)である属性が存在するかどうかをチェックします。 具体的には、監視対象のMBeanに対してgetMBeanInfo
を呼び出し、中に含まれる指定した名前のMBeanAttributeInfo
を検索します。 検索しているものが見つかった場合、それが監視対象です。 監視対象のMBeanが複数存在し、HeapMemoryUsage.used
属性を保持するものと保持しないものがある場合、動作は未定義になります。 このため、この場合、実装により、1つのMBeanに対してのみgetMBeanInfo
が呼び出されることがあります。 モニターがアクティブである間に検査結果が変更される場合にも、動作は未定義になります。
モニターの厳密な動作の詳細は、『JMX仕様』に記載されています。 次に、概要を示します。
次の3種類のMonitorがあります。
-
CounterMonitor
は、整数型の属性を監視します。 属性は、負の数ではないと想定され、指定されたモジュラスでロールオーバーが起こらなければ、その値は単調に増加します。 監視対象の各属性には、しきい値が関連付けられています。 属性がしきい値を超過すると、通知が送信されます。オフセット値を指定できます。 監視対象の値がしきい値を超過すると、しきい値はオフセット分、またはしきい値が新しい監視値より大きい値になるために必要なオフセットの倍数分大きくなります。
CounterMonitor
は差分モードで動作できます。 このモードでは、しきい値に対して比較される値は、2回の連続する属性の観測値の差分になります。 -
GaugeMonitor
は、数値型の属性を監視します。 監視対象の各属性には、上限値と下限値が関連付けられています。監視対象の属性の値が上限値を超過したとき、上限通知フラグの値がtrueであれば、通知が送信されます。 その後は、上限値を超過しても、ゲージ値が下限値以下になるまで通知は送信されません。
監視対象の属性の値が下限値を超過したとき、下限通知フラグの値がtrueであれば、通知が送信されます。 その後は、下限値を超過しても、ゲージ値が上限値以上になるまで通知は送信されません。
通常、設定されるのは上限通知または下限通知のいずれかです。 その他のしきい値は、属性値がしきい値の近辺で細かく増減しても、通知が繰返しトリガーされるのを防ぐヒステリシス・メカニズムを提供するために使用されます。
GaugeMonitor
は差分モードで動作できます。 このモードでは、上限値および下限値に対して比較される値は、2回の連続する属性の観測値の差分になります。 -
StringMonitor
は、String
型の属性を監視します。 監視対象の属性が指定された文字列と等しくなったり、等しくなくなったりすると、通知が送信されます。
- 導入されたバージョン:
- 1.5
- 関連項目:
- JMX仕様、バージョン1.4
-
インタフェースのサマリー インタフェース 説明 CounterMonitorMBean カウンタ・モニターMBeanのリモート管理インタフェースを公開します。GaugeMonitorMBean ゲージ・モニターMBeanのリモート管理インタフェースを公開します。MonitorMBean モニターMBeanのリモート管理インタフェースを公開します。StringMonitorMBean 文字列モニターMBeanのリモート管理インタフェースを公開します。 -
クラスのサマリー クラス 説明 CounterMonitor カウンタ属性の値を監視するように設計されたモニターMBeanを定義します。GaugeMonitor ゲージ属性の値を監視するように設計されたモニターMBeanを定義します。Monitor すべてのモニターMBeanに共通な部分を定義します。MonitorNotification モニターMBeanによって送信される通知を定義します。StringMonitor 文字列属性の値を監視するように設計されたモニターMBeanを定義します。 -
例外のサマリー 例外 説明 MonitorSettingException モニターの実行中にモニター設定が無効になった場合に、モニターからスローされる例外です。