커스텀 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 속성 자체는 하나 이상의 MBean과 일치할 수 있습니다. 예를 들어 아래 줄은 하나의 MBean과만 일치합니다.

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

다음 행은 여러 MBean과 일치할 수 있습니다.

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

별표(*) 와일드카드는 JDK 1.6 이상에서만 사용할 수 있습니다.

위의 예에 나열된 세 개의 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

  에이전트는 두 번째 MBean에서 다음 속성을 가져옵니다.

• bufferSize

• maxHeaderCount

  에이전트는 세 번째 MBean에서 하나의 속성( Count )을 가져옵니다.

type 의 경우 simple 또는 monotonically_increasing 를 사용합니다. JMX YAML 파일에 type 이 지정되지 않은 경우 기본값은 monotonically_increasing 입니다.

위의 예에서 accessCount , cacheSize 및 hitsCount 속성은 simple 으로 보고됩니다. bufferSize , maxHeaderCount 및 Count 속성은 monotonically_increasing 로 보고됩니다.

• hitsCount 속성 값이 항상 5 이면 New Relic은 1분마다 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에 표시되지 않습니다.