Java 에이전트: YAML을 통한 사용자 지정 JMX 계측

Java SE 플랫폼에는 JMX(Java Management Extensions)가 포함되어 있습니다. JMX는 애플리케이션, 장치 및 서비스를 모니터링하고 관리하는 방법입니다. 일반적으로 애플리케이션 서버에는 모니터링할 수 있는 내장 JMX 메트릭이 있습니다.

New Relic의 Java 에이전트는 사용자 정의 계측 YAML 파일 을 사용하여 코드를 수정하지 않고도 애플리케이션의 MBean 및 속성에서 특정 메트릭을 모니터링하는 기능을 제공합니다. Java 에이전트는 시작 시 YAML 파일을 읽고 특정 메트릭을 기록합니다.

요구 사항 및 액세스

Java 에이전트는 현재 JVM에 있는 MBean의 메트릭만 봅니다. MBean이 원격으로 액세스 중이거나 별도의 JVM에 존재하는 경우 New Relic Java 에이전트에서 MBean을 사용할 수 없습니다.

맞춤 JMX 데이터는 APM차트에 표시되지 않지만 데이터를 쿼리 하고 이를 사용하여 맞춤 차트를 만들 수 있습니다.

이 통합은 단순한 숫자 값만 보고합니다. 다른 유형의 값을 보고하려면 Infrastructure JMX 통합 을 사용할 수 있습니다.

파일 구조 규칙

사용자 정의 계측 파일은 YAML 형식 이어야 합니다. New Relic의 Java 에이전트와 함께 파일을 사용하기 전에 YAML 유효성 검사기를 사용하여 구문이 정확한지 확인하고 다음 규칙을 따르세요.

• YAML 파일은 대소문자를 구분합니다.
• 모든 들여쓰기는 두 문자씩 증가합니다. 파일의 동일한 섹션에 있는 데이터는 동일한 수준의 들여쓰기를 사용해야 합니다. 두 개의 추가 공백을 사용하여 하위 섹션을 들여씁니다.
• 변경 사항을 적용하려면 JVM 호스트 프로세스를 다시 시작해야 합니다.

사용 가능한 속성

다음은 JMX 파일의 각 속성에 대한 요약입니다. 자세한 정보는 사용자 정의 JMX YAML 예 를 참조하십시오.

YAML 파일 위치

Java 에이전트는 프로세스 시작 시 YAML 파일을 읽습니다. YAML 파일 위치를 지정하는 방법에는 두 가지가 있습니다.

파일을 읽었는지 확인

에이전트가 YAML 파일을 읽었는지 확인하려면:

1. newrelic.yml 구성 파일을 엽니다.

2. 로그 수준 속성을 log_level: finer 으로 변경합니다.

3. 응용 프로그램을 시작합니다.

4. logs/newrelic_agent.log 파일에 파일을 읽었음을 나타내는 문이 포함되어 있는지 확인합니다.

   Reading custom extension file /path/to/file/file.yml

   카피

5. 이 명령문을 찾을 수 없으면 YAML 파일의 위치를 확인하십시오. 또한 프로세스에 파일에 대한 읽기 액세스 권한이 있는지 확인하십시오.

6. 파일에 다음 명령문이 포함되어 있는지 확인합니다.

   Adding extension with name NAME_FROM_YAML and version VERSION_FROM_YAML

   카피

7. 이 명령문을 찾을 수 없으면 문서가 올바르게 구문 분석되었는지 확인하십시오. 또한 동일한 이름과 더 높은 버전 번호를 가진 다른 확장 파일이 있는지 확인하십시오.

JMX 데이터 쿼리 및 차트 작성

JMX 데이터 쿼리를 실행하고 이를 사용하여 사용자 정의 차트를 생성할 수 있습니다. 이러한 종류의 데이터 쿼리에 대한 자세한 내용은 쿼리 APM 메트릭 을 참조하십시오.

YAML 파일에 설정된 대로 JMX 또는 카운터에 대한 직접 경로를 검색하는 방법은 다음과 같습니다.

name: TomcatCustom
  version: 1.0
  enabled: true
  jmx:
    - object_name: java.nio:type=BufferPool,name=*
      metrics:
        - attributes: Count
          type: monotonically_increasing

JMX/java.nio/BufferPool/direct/Count
JMX/java.nio/BufferPool/mapped/Count

메트릭의 이름을 지정하고 저장하는 방법에 대한 자세한 내용은 Custom JMX YAML examples 를 참조하십시오.