이 페이지에서는 Maven을 사용하여 뉴렐릭 자바 에이전트를 설치하는 방법을 다룹니다. Maven은 newrelic-java.zip을(를) 빌드 종속성으로 다운로드하고 압축을 해제하여 에이전트 파일을 빌드 디렉터리에 자동으로 배치합니다.
호환성 및 요구 사항
지원
- 자바 8, 11, 17, 21, 24, 25 및 26 (자바 7은 에이전트 v6.5.4 및 이전 버전에서만 지원됩니다.)
- Maven 3.x
maven-dependency-plugin3.1.1 이상-javaagent인수를 허용하는 지원되는 모든 앱 서버 또는 독립 실행형 JVM 프로세스- 지원되는 프레임워크 및 라이브러리 버전 범위는 호환성 및 요구 사항을 참조하십시오.
지원되지 않음
- 다른 APM 에이전트와 함께 실행 — 동일한 JVM에서 다른 APM 에이전트가 활성화되어 있으면 자바 에이전트의 올바른 동작을 보장할 수 없습니다.
필요한 사항
- 뉴렐릭 계정 및
- SHA-2(256비트) SSL을 지원하는 JVM
- 다음을 포함하는 Maven 프로젝트
pom.xml
설치
다운로드하도록 Maven을 구성하십시오. newrelic-java.zip
pom.xml에 자바 에이전트를 provided 종속성으로 추가하십시오. JAVA_AGENT_VERSION를 최신 자바 에이전트 버전으로 교체하십시오:
<dependency> <groupId>com.newrelic.agent.java</groupId> <artifactId>newrelic-java</artifactId> <version>JAVA_AGENT_VERSION</version> <scope>provided</scope> <type>zip</type></dependency>에이전트 압축을 해제하도록 Maven 구성
빌드 디렉터리에 에이전트 zip의 압축을 풀려면 pom.xml의 <build><plugins> 섹션에 maven-dependency-plugin을(를) 추가하십시오:
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-dependency-plugin</artifactId> <version>3.1.1</version> <executions> <execution> <id>unpack-newrelic</id> <phase>package</phase> <goals> <goal>unpack-dependencies</goal> </goals> <configuration> <includeGroupIds>com.newrelic.agent.java</includeGroupIds> <includeArtifactIds>newrelic-java</includeArtifactIds> <overWriteReleases>false</overWriteReleases> <overWriteSnapshots>false</overWriteSnapshots> <overWriteIfNewer>true</overWriteIfNewer> <outputDirectory>${project.build.directory}</outputDirectory> </configuration> </execution> </executions></plugin>mvn package을(를) 실행한 후, target/에 다음 항목이 포함된 newrelic/ 폴더가 나타납니다:
newrelic.jar— 자바 에이전트newrelic.yml— 에이전트 설정 파일newrelic-api.jar— 자바 에이전트 API jarREADME
전달하십시오 -javaagent
애플리케이션을 시작할 때 newrelic.jar을(를) 가리키는 -javaagent JVM 인수를 추가합니다. 정확한 방법은 앱 서버에 따라 다릅니다 — 서버별 지침은 서버에 대한 JVM 인수 전달을 참조하십시오.
예를 들어 Spring Boot jar의 경우 다음과 같습니다:
$java -javaagent:/path/to/target/newrelic/newrelic.jar -jar my-example-app.jar구성
target/newrelic/newrelic.yml을(를) 편집하고 두 가지 필수 값을 설정하십시오:
license_key: 'YOUR_LICENSE_KEY'app_name: 'My Application'에이전트는 시작 시 newrelic.jar과(와) 동일한 디렉터리에서 newrelic.yml을(를) 읽습니다. 또한 자바 시스템 속성을 사용하여 모든 설정을 재정의할 수 있습니다(예: -Dnewrelic.config.license_key=YOUR_KEY) 또는 환경 변수를 사용할 수도 있습니다.
사용 가능한 모든 옵션은 자바 에이전트 설정을 참조하십시오.
설치 확인
애플리케이션을 다시 시작합니다. 최소 2개의 requests를 보낸 다음 2~3분 기다리면 APM & 서비스에 앱이 표시됩니다.
5분 후에도 데이터가 나타나지 않으면 데이터가 나타나지 않음(자바)을 참조하십시오.