복합 유형 JMX 속성 수집

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

JMXFetch

에이전트에서 다음 통합 yaml 파일은 모두 JMXFetch에서 읽힙니다.

JMXFetch 속성

JMXFetch가 수집할 수 있는 JMX 속성에는 두 유형이 있습니다(단순형과 복합형).

단순 속성

단순 속성에는 integer, float, double, long, boolean 등이 있습니다.

참고: 부울 값이 참일 경우에는 1, 거짓일 경우에는 0입니다. 지원되는 유형 목록 확인

현재 JMX 통합에서 무엇을 수집 중인지 알아보려면 list 명령을 사용하세요. 다음은 단순 속성을 보여 주는 코드 조각 예시이니 참고하세요.

Matching: x/350. Bean name: java.lang - Attribute name: attribute_1 - Attribute type: java.lang.Integer

그러면 다음 속성이 나타납니다.

- include:
     domain: java.lang
     attribute:
       attribute_1:
         metric_type: counter
         alias: java.lang.Integer

JMXFetch는 속성 값을 직접 추출해 메트릭 값으로 사용합니다. 수집하는 방법을 배우려면 JMX 설명서를 참고하세요.

복합 속성

복합 속성은 배열, 해시맵, 또는 ‘단순’ 속성으로 구성된 개체일 수 있습니다.

Matching: x/350. Bean name: java.lang - Attribute name: HeapMemoryUsage - Attribute type: javax.management.openmbean.CompositeData

이 경우, JMXFetch에 이 ‘복합’ 속성을 사용해 메트릭 숫자 값을 생성하는 방법에 관한 상세 정보를 추가해야 합니다.

그러려면 구성 요소를 지정할 때 .를 사용하세요.

- include:
    domain: java.lang
    type: Memory
    attribute:
      HeapMemoryUsage.used:
        alias: jvm.heap_memory
        metric_type: gauge
      HeapMemoryUsage.committed:
        alias: jvm.heap_memory_committed
        metric_type: gauge

      # (...)

복합 속성의 다음 단계를 보려면 어떻게 해야 하나요?

최적의 방법은 JMXterm을 사용하는 것입니다(아래 참고).

java -jar /opt/datadog-agent/agent/checks/libs/jmxterm-1.0-DATADOG-uber.jar -l localhost:<PORT> -u <USER> -p <PASSWORD>

참고로 에이전트 v5.32.8 이상에서는 jmxterm JAR이 함께 제공되지 않습니다. jmxterm을 다운로드하고 사용하려면 업스트림 프로젝트를 참고하세요.

그 후 get 명령을 사용해 특정 메트릭을 가져옵니다.