Gradle을 사용하여 Java 에이전트 설치

이 문서에서는 Gradle을 사용하여 Java 에이전트를 설치하는 방법을 설명합니다. Java 에이전트를 수동으로 설치하는 방법에 대한 자세한 내용 은 Java 에이전트 및 Java 에이전트 구성 설치: 구성 파일 을 참조하십시오.

Gradle을 사용하여 에이전트 패키지 설치

1. 다음 옵션 중 하나를 사용하여 New Relic Java 에이전트를 설치합니다.

   전체 에이전트 패키지 설치

   이 섹션에서는 모든 New Relic Java 에이전트 구성요소가 포함된 newrelic-java.zip 파일을 다운로드하고 압축을 풀도록 Gradle을 구성하는 방법을 설명합니다.

   • newrelic.yml (에이전트 구성 파일)

   • newrelic.jar (자바 에이전트 jar)

   • newrelic-api.jar (자바 에이전트 API jar)

   • 읽어보기

     이것을하기 위해:

   1. 에이전트를 다운로드하는 데 사용할 플러그인으로 build.gradle 파일을 구성합니다. 예를 들어:

      plugins {
          id "de.undercouch.download" version "3.4.3"
      }

      카피

   2. 에이전트를 다운로드하고 압축을 풀 작업을 추가합니다. 예를 들어:

      task downloadNewrelic(type: Download) {
          mkdir 'newrelic'
          src 'https://download.newrelic.com/newrelic/java-agent/newrelic-agent/current/newrelic-java.zip'
          dest file('newrelic')
      }
      
      task unzipNewrelic(type: Copy) {
          from zipTree(file('newrelic/newrelic-java.zip'))
          into rootDir
      }

      카피

   3. 작업을 실행하여 에이전트를 다운로드하고 압축을 풉니다. 예를 들어:

      ./gradlew downloadNewrelic
      ./gradlew unzipNewrelic

      카피

      이렇게 하면 newrelic-java.zip 파일을 newrelic/ 디렉토리에 다운로드한 다음 동일한 디렉토리에 압축을 풉니다.

      다음은 zip 파일 작업을 위한 build.gradle 파일의 예입니다.

      plugins {
          id 'java'
          id "de.undercouch.download" version "3.4.3"
      }
      
      group 'example_group'
      version '1.0-SNAPSHOT'
      
      sourceCompatibility = 1.8
      
      repositories {
          mavenCentral()
      }
      
      task downloadNewrelic(type: Download) {
          mkdir 'newrelic'
          src 'https://download.newrelic.com/newrelic/java-agent/newrelic-agent/current/newrelic-java.zip'
          dest file('newrelic')
      }
      
      task unzipNewrelic(type: Copy) {
          from zipTree(file('newrelic/newrelic-java.zip'))
          into rootDir
      }

      카피

   개별 구성 요소 설치

   이 섹션에서는 Java 에이전트의 개별 구성요소, 특히 newrelic.jar 및 newrelic-api.jar 을 다운로드하도록 Gradle을 구성하는 방법을 설명합니다.

   1. newrelic.jar 또는 newrelic-api.jar 를 다운로드하도록 build.gradle 파일을 구성합니다. 다음은 newrelic.jar 다운로드의 예입니다.

      dependencies {
          compile group: 'com.newrelic.agent.java', name: 'newrelic-agent', version: 'JAVA_AGENT_VERSION'
      }

      카피

      다음은 newrelic-api.jar 다운로드의 예입니다.

      dependencies {
          compile group: 'com.newrelic.agent.java', name: 'newrelic-api', version: 'JAVA_AGENT_VERSION'
      }

      카피

      JAVA_AGENT_VERSION 을 최신 Java 에이전트 버전 으로 바꿉니다.

   2. New Relic 계정을 만들 때 받은 newrelic.yml 파일을 찾거나 사용 중인 에이전트 버전에 맞는 파일을 다운로드하세요.

      다음은 개별 구성요소(자바 에이전트 및 API jar)로 작업하기 위한 build.gradle 의 예입니다.

      plugins {
          id 'java'
      }
      
      group 'example_group'
      version '1.0-SNAPSHOT'
      
      sourceCompatibility = 1.8
      
      repositories {
          mavenCentral()
      }
      
      dependencies {
          compile group: 'com.newrelic.agent.java', name: 'newrelic-agent', version: '4.11.0'
          compile group: 'com.newrelic.agent.java', name: 'newrelic-api', version: '4.11.0'
      }

      카피

2. JVM 인수 Dnewrelic.config.file 에서 달리 지정하지 않는 한 newrelic.yml 을 newrelic.jar 과 동일한 폴더에 배치합니다.

3. license_key 및 app_name 를 사용하여 newrelic.yml 파일 (또는 JVM 시스템 속성 )을 구성합니다.

4. 애플리케이션 서버를 실행하는 JVM에 -javaagent:/path/to/newrelic.jar 을 전달합니다.

5. 선택 사항: New Relic Java 에이전트 API 를 사용하는 경우 API jar를 애플리케이션 클래스 경로에 추가하여 컴파일 시간에 사용할 수 있도록 합니다.

앱에 대한 트래픽을 생성한 다음 APM 요약 페이지 에 데이터가 나타날 때까지 몇 분 정도 기다립니다. 아무 것도 나타나지 않으면 문제 해결 절차 를 따르십시오.