カスタム JMX YAML の例

- object_nameで始まる YAML の各行は、MBean を表します。たとえば、次の行は、最初の MBean からプルされる情報を記述しています。

- object_name: Catalina:type=Cache,host=localhost,path=/examples
  metrics:
    - attributes: accessCount, cacheSize, hitsCount
      type: simple

object_nameプロパティは、1つまたは複数のMBeanにマッチします。例えば、以下の行は1つのMBeanにのみマッチします。

- object_name: Catalina:type=Cache,host=localhost,path=/examples

次の行は、複数のMBeansにマッチする可能性があります。

- object_name: java.nio:type=BufferPool,name=*

アスタリスク (*) ワイルドカードは、JDK 1.6 以降でのみ使用できます。

上の例で挙げた3つのMBeanは、以下のようなオブジェクト名を持っています。

Catalina:type=Cache,host=localhost,path=/examples
Catalina:type=Connector,port=8009
java.nio:type=BufferPool,name=*

JMX の例では、3 つの MBean から 6 つの異なる属性を取得しています。New Relic の Java エージェントは、これらの属性を最初の MBean から取得します。

• accessCount

• cacheSize

• hitsCount

  エージェントはこれらの属性を2つ目のMBeanから取り出します。

• bufferSize

• maxHeaderCount

  エージェントは、3 番目の MBean から 1 つの属性 ( Count ) をプルします。

typeには、 simpleまたはmonotonically_increasingを使用します。JMX YAML ファイルでtypeが指定されていない場合、デフォルトでmonotonically_increasingになります。

上記の例では、属性accessCount 、 cacheSize 、およびhitsCountはsimpleとして報告されます。属性bufferSize 、 maxHeaderCount 、およびCountはmonotonically_increasingとして報告されます。

• hitsCount属性値が常に5の場合、New Relic は毎分5を報告します。
• Count属性値が常に5である場合、New Relic はその値に対して毎分0を報告します。
• Count属性値が5から7に変化した場合、New Relic はその分について2を報告します。

プロパティroot_metric_nameを使用せずにカスタム ダッシュボード メトリックを選択する場合は、すべてのカスタム JMX メトリックに対して次の形式を使用します。

JMX/beginning_of_object_name/type/any_properties_in_object_name/attribute_name

構成ファイルはroot_metric_nameを使用しないため、次のメトリックが作成されます:

JMX/Catalina/Cache/localhost/examples/accessCount
JMX/Catalina/Cache/localhost/examples/cacheSize
JMX/Catalina/Cache/localhost/examples/hitsCount
JMX/Catalina/Connector/8009/bufferSize
JMX/Catalina/Connector/8009/maxHeaderCount
JMX/java.nio/BufferPool/direct/Count
JMX/java.nio/BufferPool/mapped/Count

プロパティroot_metric_nameを使用している場合、メトリックはルート メトリック名の前に JMX を付け、その後に属性の名前を付けたものになります。括弧{}の間のroot_metric_nameにオブジェクト名キーを指定することにより、オブジェクト名の値を使用できます。例えば：

設定ファイルの一部。

- object_name: Catalina:type=Cache,host=localhost,path=/examples
  root_metric_name: Tomcat/{host}
  metrics:
    - attributes: accessCount, cacheSize, hitsCount
      type: simple
- object_name: mbean:type=Sample,host=localhost,path=*
  root_metric_name: SampleMBean
  metrics:
    - attributes: attOne, attTwo
      type: simple

メトリクス名。

JMX/Tomcat/localhost/accessCount
JMX/Tomcat/localhost/cacheSize
JMX/Tomcat/localhost/hitsCount
JMX/SampleMBean/attOne
JMX/SampleMBean/attTwo

属性が実際にMBean上に存在しない場合、そのメトリックはNew Relicに表示されません。