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

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

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

팁

Infrastructure JMX 통합 으로 JMX를 모니터링할 수도 있습니다.

요구 사항 및 액세스

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

사용자 정의 JMX 데이터는 하지만 데이터를 쿼리하고 이를 사용하여 사용자 지정 차트를 만들 수 있습니다.

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

파일 구조 규칙

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

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

사용 가능한 속성

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

값	정의
`name`	YAML 사용자 정의 계측 파일을 식별하는 기본 설명 이름입니다. `name` 속성 앞에 공백 하나를 포함합니다.
`version`	확장 파일의 버전입니다. 두 확장의 이름이 같은 경우 가장 높은 버전의 확장만 사용됩니다. 버전 속성이 `name` 과 다른 줄에 있는지 확인하십시오. 버전 속성 앞에 공백을 하나 포함하십시오.
`enabled`	`true` 이면 Java 에이전트가 확장을 읽습니다. `false` 인 경우 Java 에이전트는 확장을 무시합니다. `enabled` 속성 앞에 공백 하나를 포함합니다.
`jmx`	속성 `jmx` 뒤에 오는 값이 없습니다. 속성 앞에 공백을 사용하지 마십시오.
`object_name`	특정 MBean의 객체와 일치합니다. JDK 버전 1.6 이상을 사용하는 경우 `object_name` 에 별표(*)가 포함될 수 있습니다. 대시 앞에 두 개의 공백을 포함하고 대시와 `object_name` 사이에 하나의 공백을 포함합니다.
`root_metric_name`	New Relic의 Java 에이전트 버전 3.7.0 이상에서 사용 가능합니다. New Relic에서 사용되는 메트릭의 이름을 지정하는 기능을 제공하는 선택적 속성입니다. `object_name` 속성 값을 사용하려면 대괄호( `{}` )에 속성 키를 지정합니다. New Relic은 JMX로 지정된 `root_metric_name` 에 자동으로 접두사를 붙이고 메트릭 끝에 속성 이름을 추가합니다. `root_metric_name` 앞에 4개의 공백을 포함합니다.
`metrics`	메트릭 라인에 값이 없습니다. 측정항목 앞에 공백 4개를 포함합니다.
`attributes`	MBean 속성의 쉼표로 구분된 목록입니다. 속성 이름은 정확히 일치해야 합니다. 대시 앞에 6개의 공백을 포함하고 대시와 `attributes` 키워드 사이에 1개의 공백을 포함합니다.
`type`	`simple` 이면 각 값이 New Relic 수집기에 보고됩니다. `monotonically_increasing` (기본값)이면 양수 차이가 New Relic 수집기에 보고됩니다.

YAML 파일 위치

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

주의

에이전트와 동일한 폴더에 둘 이상의 YAML 파일이 있는 경우 사용자 지정 메트릭이 작동하지 않습니다. 사용자 정의할 때 백업 및 복사본을 다른 폴더로 이동합니다.

파일을 읽었는지 확인

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

newrelic.yml 구성 파일을 엽니다.
로그 수준 속성을 log_level: finer 으로 변경합니다.
응용 프로그램을 시작합니다.
logs/newrelic_agent.log 파일에 파일을 읽었음을 나타내는 문이 포함되어 있는지 확인합니다.
```
Reading custom extension file /path/to/file/file.yml
```
이 명령문을 찾을 수 없으면 YAML 파일의 위치를 확인하십시오. 또한 프로세스에 파일에 대한 읽기 액세스 권한이 있는지 확인하십시오.
파일에 다음 명령문이 포함되어 있는지 확인합니다.
```
Adding extension with name NAME_FROM_YAML and version VERSION_FROM_YAML
```
이 명령문을 찾을 수 없으면 문서가 올바르게 구문 분석되었는지 확인하십시오. 또한 동일한 이름과 더 높은 버전 번호를 가진 다른 확장 파일이 있는지 확인하십시오.

JMX 데이터 쿼리 및 차트 작성

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

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

예제 YAML 파일

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

메트릭 탐색기 에서 다음에 대해 검색하여 예제 YAML 파일의 개체에서 카운터를 찾을 수 있습니다.

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

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

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

팁

요구 사항 및 액세스

파일 구조 규칙

사용 가능한 속성

YAML 파일 위치

확장 디렉토리 생성

기존 확장 디렉토리 지정

주의

파일을 읽었는지 확인

JMX 데이터 쿼리 및 차트 작성

카운터에 대한 직접 경로 검색

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

팁

요구 사항 및 액세스 .css-21sua1{background:none;border:none;width:0;padding:0;}

파일 구조 규칙

사용 가능한 속성

YAML 파일 위치

기존 확장 디렉토리 지정

주의

파일을 읽었는지 확인

JMX 데이터 쿼리 및 차트 작성

카운터에 대한 직접 경로 검색

요구 사항 및 액세스