저항 에이전트는 많은 인기 있는 서버, 프레임워크, 라이브러리 및 데이터 저장소에서 자동으로 데이터를 수집하는 완전한 기능을 갖춘 라이브러리입니다(전체 목록은 호환성 및 요구 사항 참조). 또한 중요한 기능 세트도 있습니다. 그러나 새로운 라이브러리의 기능 및 계측에 대한 추가 요청은 항상 있습니다. 이 용도로 에이전트는 extension modules 제공합니다.
확장 모듈은 세 가지 일반 범주로 나뉩니다.
인큐베이터 계측 모듈 : 특정 라이브러리에서 데이터 수집을 위한 실험적 새로운 지원보관된 계측 모듈 : 원래 회사 또는 작성자가 더 이상 유지 관리하거나 업데이트하지 않는 라이브러리용 계측입니다.기능 확장 모듈 : 특정 라이브러리와 관계없이 에이전트에 새로운 동작을 추가하는 코드입니다.라이브러리가 자동 계측 또는 계측 모듈의 적용을 받지 않는 경우에도 사용자 지정 계측 을 사용하여 데이터를 수집할 수 있습니다.
팁 이 계측에 대한 피드백, 질문 또는 문제가 있는 경우 New Relic의 지원 포럼 에 게시물을 작성하고 게시물에 java_incubator
태그를 지정하십시오.
확장 모듈 설치 확장 모듈을 설치하기 전에 최신 Java 에이전트 버전으로 업데이트하는 것이 좋습니다. 확장 모듈을 설치하려면:
아래 모듈 목록에서 적절한 .jar
파일을 다운로드합니다. newrelic.jar
및 newrelic.yml
파일이 포함된 디렉토리를 찾습니다. 해당 디렉터리에 extensions
라는 하위 디렉터리를 만듭니다(아직 없는 경우).다운로드한 .jar
확장 모듈을 extensions
디렉토리에 복사합니다. 기능 확장 모듈의 경우 기능별 구성으로 newrelic.yml
을 업데이트합니다. 서버를 다시 시작하십시오. 기능 또는 계측을 실행할 서버 또는 호스트에 일부 트래픽을 보냅니다. 기능 확장 모듈 확장 모듈은 일반적으로 요청되는 기능을 추가하는 추가 라이브러리입니다.
확장 모듈을 사용하려면 다운로드하여 Extensions Directory 에 넣으십시오.
클래스 히스토그램 클래스 히스토그램 확장 프로그램은 jmap 을 주기적으로 실행하고 쿼리 및 차트 작성이 가능한 ClassHistogramRowEvent
및 ClassHistogramStatsEvent
데이터를 생성합니다. 이 데이터를 쿼리하면 시간이 지남에 따라 값을 볼 수 있으므로 메모리 누수 문제를 해결할 때 유용할 수 있습니다.
환경 변수, 시스템 속성 또는 newrelic.yml
을 사용하여 Java 에이전트를 구성하는 것과 동일한 방식으로 클래스 히스토그램 확장을 구성합니다. 다음은 기본값과 함께 사용 가능한 속성입니다.
classes_per_histogram : 50
delay_between_calls_seconds : 60
인큐베이터 계측 모듈 인큐베이터 모듈은 미래에 에이전트의 자동 계측에 구축할 수 있는 실험적 계측입니다.
현재 사용 가능한 인큐베이터 모듈은 다음과 같습니다.
아파치 카멜 2.12 이 계측 모듈은 다음을 가로챕니다.
org . apache . camel . component . http . CamelServlet . resolve
웹 트랜잭션이 Camel 서블릿 이름보다 세분화된 이름을 갖도록 트랜잭션 이름을 지정하려면 다음을 사용합니다.
org . apache . camel . component . http . HttpConsumer . getPath ( )
바이트코드를 보려면 다음 터미널 명령을 사용하십시오.
$ javap -verbose -cp camel-2.12-FILENAME.jar org.apache.camel.component.http.CamelServlet
C3P0 데이터베이스 연결 풀 이 계측 모듈은 C3P0 연결 풀을 샘플링하고 다음으로 시작하는 메트릭의 사용 중 및 유휴 수를 보고합니다.
Custom/Database Connection/C3P0/METRIC_NAME
측정 항목 탐색기를 사용하여 측정 항목을 볼 수 있습니다.
코다 헤일의 메트릭스 2 이 계측 모듈은 MetricRegistry
와 통합되고 매분 등록된 측정항목 샘플링을 시작합니다. 보고된 측정항목에는 다음과 같은 접두사가 붙습니다.
Custom/CodaHale/Metrics2/METRIC_NAME
측정 항목 탐색기를 사용하여 측정 항목을 볼 수 있습니다.
코다 헤일의 메트릭스 3 이 계측 모듈은 MetricRegistry
와 통합되고 매분 등록된 측정항목 샘플링을 시작합니다. 보고된 측정항목에는 다음과 같은 접두사가 붙습니다.
Custom/CodaHale/Metrics3/METRIC_NAME
측정 항목 탐색기를 사용하여 측정 항목을 볼 수 있습니다.
HikariCP 2.3.0 - 2.3.8 이 계측 모듈은 HikariCP 데이터베이스 연결 풀을 샘플링하고 다음으로 시작하는 메트릭에서 사용 중 및 유휴 수를 보고합니다.
Custom/Database Connection/HikariCP/METRIC_NAME
측정 항목 탐색기를 사용하여 측정 항목을 볼 수 있습니다.
HikariCP 2.4.0 이상 중요 이 인큐베이터 모듈은 더 이상 사용되지 않습니다. 에이전트에 계측 모듈로 추가되었습니다.
이 계측 모듈은 HikariCP 데이터베이스 연결 풀을 샘플링하고 다음으로 시작하는 메트릭에서 사용 중 및 유휴 수를 보고합니다.
Custom/Database Connection/HikariCP/METRIC_NAME
측정 항목 탐색기를 사용하여 측정 항목을 볼 수 있습니다.
Ratpack 1.6.0 이상 이 계측 모듈은 Ratpack의 실행 기본 요소의 비동기 연결에 대한 지원을 추가합니다. 또한 핸들러 실행을 모니터링합니다. Java 에이전트 API 를 사용하여 트랜잭션의 이름을 수동으로 지정해야 합니다.
Ratpack Http 클라이언트 1.4.0 이상 이 계측은 Ratpack의 HTTP 클라이언트 요청 및 응답을 캡처합니다.
보관된 계측 모듈 보관된 모듈은 원래 회사나 작성자가 더 이상 유지 관리하지 않는 라이브러리를 위한 도구입니다. 대상 라이브러리가 업데이트되지 않기 때문에 아카이브된 모듈에 대한 지원에 지정된 종료 날짜가 있습니다.
현재 사용 가능한 보관된 모듈은 다음과 같습니다.
아카 [2.0] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.22.1 이상
지원 종료일
2019년 12월
이 모듈은 메시지를 보내고 받는 행위자 간의 링크 계측을 제공합니다. 또한 액터에 의해 브로드캐스트되거나 액터에게 전달된 메시지를 추적합니다. 과도한 계측을 피하기 위해 이 계측은 트랜잭션을 시작하지 않습니다. 지정된 액터 호출이 트랜잭션의 시작을 표시하도록 하려면 @Trace(dispatcher=true)
주석이나 다른 형식의 맞춤 계측 을 사용하세요.
아카 [2.1] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.22.1 이상
지원 종료일
2019년 12월
이 모듈은 메시지를 보내고 받는 행위자 간의 링크 계측을 제공합니다. 또한 액터에 의해 브로드캐스트되거나 액터에게 전달된 메시지를 추적합니다. 과도한 계측을 피하기 위해 이 계측은 트랜잭션을 시작하지 않습니다. 지정된 액터 호출이 트랜잭션의 시작을 표시하도록 하려면 @Trace(dispatcher=true)
주석이나 다른 형식의 맞춤 계측 을 사용하세요.
아카 HTTP [1.0] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.24.1 이상
지원 종료일
2019년 12월
이 모듈은 Akka HTTP 호출에서 트랜잭션 을 생성합니다. 또한 Akka 액터 간의 핸드오프와 Akka에서 다른 데이터베이스 및 서비스로의 호출을 계측합니다.
호출 시스템의 경우 이 계측은 애플리케이션 간 추적을 수집합니다. 지원되는 Akka 버전을 사용하는 경우 액터 시스템을 통해 트랜잭션에서 Akka HTTP 앱의 활동을 볼 수 있습니다.
아카 HTTP [2.0 – 2.4.1] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.24.1 이상
지원 종료일
2019년 12월
이 모듈은 Akka HTTP 호출에서 트랜잭션 을 생성합니다. 또한 Akka 액터 간의 핸드오프와 Akka에서 다른 데이터베이스 및 서비스로의 호출을 계측합니다.
호출 시스템의 경우 이 계측은 애플리케이션 간 추적을 수집합니다. 지원되는 Akka 버전을 사용하는 경우 액터 시스템을 통해 트랜잭션에서 Akka HTTP 앱의 활동을 볼 수 있습니다.
아카 HTTP [2.4.2 – 2.4.4] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.24.1 이상
지원 종료일
2019년 12월
이 모듈은 Akka HTTP 호출에서 트랜잭션 을 생성합니다. 또한 Akka 액터 간의 핸드오프와 Akka에서 다른 데이터베이스 및 서비스로의 호출을 계측합니다.
호출 시스템의 경우 이 계측은 애플리케이션 간 추적을 수집합니다. 이 도구를 Akka에 대해 이전에 출시된 지원과 함께 사용하여 트랜잭션에서 액터 시스템에 이르기까지 Akka HTTP 앱의 활동을 볼 수 있습니다.
히스트릭스 [1.0.2 – 1.1.7] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.23.0 이상
지원 종료일
2019년 12월
이 모듈은 각 Hystrix 명령과 관련된 타이밍 정보를 제공합니다. 에이전트는 연결된 Hystrix 명령을 하나의 트랜잭션 으로 연결합니다.
히스트릭스 [1.2.0 – 1.2.18] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.23.0 이상
지원 종료일
2019년 12월
이 모듈은 각 Hystrix 명령과 관련된 타이밍 정보를 제공합니다. 에이전트는 연결된 Hystrix 명령을 하나의 트랜잭션 으로 연결합니다.
히스트릭스 [1.3.0 – 1.3.13] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.23.0 이상
지원 종료일
2019년 12월
이 모듈은 각 Hystrix 명령과 관련된 타이밍 정보를 제공합니다. 에이전트는 연결된 Hystrix 명령을 하나의 트랜잭션 으로 연결합니다.
플레이 [2.0] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.24.1 이상
지원 종료일
2019년 12월
이 모듈은 Play 컨트롤러 클래스를 기반으로 트랜잭션 을 생성하고 이름을 지정합니다.
재생 [2.1] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.24.1 이상
지원 종료일
2019년 12월
이 모듈은 Play 컨트롤러 클래스를 기반으로 트랜잭션 을 생성하고 이름을 지정합니다.
재생 [2.2] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.24.1 이상
지원 종료일
2019년 12월
이 모듈은 Play 컨트롤러 클래스를 기반으로 트랜잭션 을 생성하고 이름을 지정합니다.
솔러 [3.1.0 – 3.4.0] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.34.0 이상
지원 종료일
2019년 12월
이 모듈은 Solr 서버에 대한 데이터베이스 호출을 계측하고 Solr 서버 자체에 대한 자세한 정보를 수집합니다. 또한 트랜잭션 추적 및 느린 쿼리 추적 에 표시되는 쿼리에 대한 데이터베이스 서버 및 데이터베이스 이름을 제공합니다.
솔러 [3.5.0] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.34.0 이상
지원 종료일
2019년 12월
이 모듈은 Solr 서버에 대한 데이터베이스 호출을 계측하고 Solr 서버 자체에 대한 자세한 정보를 수집합니다. 또한 트랜잭션 추적 및 느린 쿼리 추적 에 표시되는 쿼리에 대한 데이터베이스 서버 및 데이터베이스 이름을 제공합니다.
솔러 [3.6.0 – 3.6.2] 다운로드 링크
모듈 다운로드
자바 에이전트 버전
3.34.0 이상
지원 종료일
2019년 12월
이 모듈은 Solr 서버에 대한 데이터베이스 호출을 계측하고 Solr 서버 자체에 대한 자세한 정보를 수집합니다. 또한 트랜잭션 추적 및 느린 쿼리 추적 에 표시되는 쿼리에 대한 데이터베이스 서버 및 데이터베이스 이름을 제공합니다.