JMX レポートの有効化 › プライマリ キーの変換を使用した JMX メトリックの簡素化

プライマリ キーの変換を使用した JMX メトリックの簡素化

メトリックが JMX ノードの下に表示される順序を必要に応じて設定できます。 エージェント プロファイルでプライマリ キーを定義できます。 プライマリ キーは、MBean の ObjectName を識別します。

プライマリ キーの変換を設定しない場合、CA Introscope® は JMX データの変換を行います。 デフォルト変換では、メトリックは、Investigator の JMX ノードの下にアルファベット順に一覧表示されます。 JMX データをメトリックに変換するこの方法により、簡素化されたメトリック名が作成されます。 生成されたメトリックのキー/値のペアの情報の順序を制御します。

動作は、エージェント プロファイルの introscope.agent.jmx.name.primarykeys プロパティで設定されます。 primarykeys プロパティの値は、一意に MBean を識別する MBeans JMX ObjectName の部分を指定します。 たとえば、WebLogic MBean の ObjectName には以下のキーが含まれます。

• MBean の種類を指定する Type キー。
• MBean が示すリソースの名前を指定する Name キー。

ObjectName のキー/値のペアは、MBean のタイプに応じてさまざまです。

CA Introscope® は、以下の規則に従って、introscope.agent.jmx.name.primarykeys プロパティの値で識別される MBean を変換および表示します。

• 表示されるのはキー値情報だけです。キー名は表示されません。
• 値は primarykeys プロパティで定義された順になります。
• 値の大文字と小文字が区別されます。

たとえば、WebLogic MBean に以下の特性があるとします。

• ドメイン名： WebLogic
• MBean ObjectName のキーと値のペア： category=server、type=jdbc
• メトリック名： connections

以下のように設定するとします。

introscope.agent.jmx.name.primarykeys=type,category connections 属性は、以下の構造で Investigator ツリーに表示されます。

<Introscope ドメイン>|<ホスト>|<プロセス>|<エージェント>|JMX|Weblogic|jdbc|server:connections

注： WebLogic 9.0 には普遍的に利用できるプライマリ キーがありません。 デフォルトの変換方法にある、メトリックのキー/値のペアの名前付け規則を使用します。 このため、WebLogic 9.0 の JMX Metric ツリーは異なる構造を持ちます。

詳細：

デフォルトの JMX メトリック変換プロセス