JMX 통합 을 통해 사용자는 JMX로 메트릭을 노출하는 모든 애플리케이션을 모니터링할 수 있습니다. 통합에는 JVM에서 주요 메트릭을 자동으로 수집하는 기본 수집 파일이 포함됩니다. YAML 파일로 메트릭 컬렉션을 사용자 지정하여 메트릭 하위 집합을 수집할 수도 있습니다.
통합을 설치하고 수집하는 데이터를 보려면 계속 읽으십시오.
호환성 및 요구 사항
우리의 통합은 Java 8 이상과 호환됩니다. PATH 에 구성된 것과 다른 Java 버전을 사용해야 하는 경우 GitHub에서 New Relic의 구성 문서를 따르세요.
통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.
New Relic 계정. 하나가 없습니까? 무료 가입! 신용 카드가 필요하지 않습니다.
JMX가 Kubernetes 또는 Amazon ECS에서 실행되고 있지 않으면 JMX를 실행하는 호스트에 인프라 에이전트를 설치 해야 합니다. 그렇지 않으면:
이 통합은 IIOP 프로토콜을 지원하지 않습니다.
설치 및 활성화
JMX 통합을 설치하려면 환경에 대한 지침을 따르십시오.
' '
추가 참고 사항:
- 고급: 통합은 패키지 관리자 외부에 설치할 수 있도록 tarball 형식 으로도 제공됩니다.
- 인프라 에이전트는
nri-jmx바이너리를 실행할 때 경로를PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin로 설정합니다. Java 바이너리는 이러한 경로 중 하나에 있어야 합니다. nrjmx및jmx은 루트 사용자에 대한PATH가 아닌PATH시스템에 있어야 하며/root/.bashrc에서PATH환경 변수를 변경해도 영향을 받지 않습니다. PATH 시스템 변수를 변경하는 방법에 대해 자세히 읽어보십시오.- 호스트 내 통합은 자동으로 업데이트되지 않습니다. 최상의 결과를 얻으 려면 통합 패키지 및 인프라 에이전트 를 정기적으로 업데이트하십시오.
데이터 이름 지정에 대한 팁
메트릭은 샘플 형태로 전송 및 저장됩니다. 메트릭 데이터 및 메타데이터를 포함하는 키-값 쌍의 목록입니다. 각 샘플은 데이터베이스에 이벤트 로 저장됩니다.
New Relic에 보고된 JMX 데이터를 만들고 이름을 지정하는 것은 귀하의 책임입니다. 이러한 이유로 New Relic은 이벤트 유형의 이름을 지정할 때 이러한 규칙을 따를 것을 강력히 권장합니다. 일관된 명명 체계를 유지하려면 다음을 수행하십시오.
- 낙타 케이스를 사용하십시오.
- 어떤 데이터가 포함되어 있는지 명확하게 식별할 수 있는 이름을 사용하십시오.
예시: MyorgApplicationSample
권장 사항: 서로 다른 애플리케이션에서 유사한 메트릭에 대해 동일한 이름 지정 체계를 사용합니다.
데이터 찾기 및 사용
이 서비스의 데이터는 통합 대시보드 에 보고됩니다.
JMX 데이터는 구성 파일 에 지정된 사용자 정의 이벤트 유형 에 첨부됩니다. 예를 들어 JMX 통합을 사용하여 Tomcat을 모니터링하는 데 관심이 있는 경우 TomcatSample }이라는 event_type 를 정의하고 해당 이벤트 유형을 쿼리합니다 .
문제 해결을 위해 이 데이터를 쿼리 하거나 사용자 지정 차트 및 대시보드를 만들 수 있습니다.
데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.
측정항목 데이터
통합에 의해 생성된 메트릭에는 수집하는 MBean 과 관련된 메타데이터가 포함됩니다. NRQL 쿼리 에서 이 메타데이터를 사용하여 쿼리가 원하는 빈에 대한 데이터만 반환하도록 데이터를 필터링하고 패싯할 수 있습니다. 또한 메트릭 이름이 모든 Bean 간에 고유하지 않아도 되므로 메트릭을 고유하게 식별하는 데 사용할 수도 있습니다.
각 이벤트에는 다음 메타데이터가 포함됩니다.
이름 | 설명 |
|---|---|
| 이러한 메트릭에 대한 JMX 도메인 이름입니다. |
| 엔티티 유형 "domain:"이 추가된 이러한 메트릭의 JMX 도메인 이름입니다. |
| 메트릭이 수집되는 JMX 호스트입니다. |
| 이러한 측정항목을 수집하는 데 사용되는 쿼리입니다. |
| 이러한 메트릭이 수집된 속성의 Bean입니다. |
| Bean 이름의 각 키에 대해 Bean 키 값과 함께 |
NRQL 쿼리 예
다음은 수집된 모든 JVM 가비지 수집기를 모니터링하는 메타데이터를 활용하는 NRQL 쿼리의 예입니다.
SELECT latest(CollectionTime)FROM JVMSampleFACET `key:name`WHERE `key:type` = 'GarbageCollector'측정항목 데이터 속성
JMX 통합은 다음 메트릭 데이터 속성을 수집합니다.
이름 | 설명 |
|---|---|
| 사용된 총 Java 힙 메모리입니다. |
| 사용하도록 커밋된 총 Java 힙 메모리입니다. |
| 할당된 초기 Java 힙 메모리입니다. |
| 사용 가능한 최대 Java 힙 메모리입니다. |
| 사용된 총 Java 비힙 메모리입니다. |
| 사용하도록 커밋된 전체 Java 비힙 메모리입니다. |
| 할당된 초기 Java 비힙 메모리입니다. |
| 사용 가능한 최대 Java 비힙 메모리입니다. |
| 라이브 스레드 수입니다. |
| 발생한 총 가비지 컬렉션 수입니다. |
| 대략적인 누적 가비지 수집 시간이 경과했습니다. |
인벤토리 데이터
JMX 통합은 JMX 통합의 구성 매개변수를 캡처합니다. 데이터는 config/jmx 소스 아래의 인벤토리 페이지 에서 사용할 수 있습니다. 인벤토리 데이터에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.
문제점 해결
문제 해결 팁:
' '
' '
소스 코드 확인
이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.