GradleによるJavaエージェントのインストール

このドキュメントでは、Gradle を使用して Java エージェントをインストールする方法を説明します。Java エージェントを手動でインストールする方法については、 Java エージェントのインストール および Java エージェントの設定 を参照してください。コンフィグファイル.

Gradleによるエージェントパッケージのインストール

1. 以下のいずれかの方法で、New Relic Java エージェントをインストールします。

   完全なエージェントパッケージのインストール

   ここでは、New Relic Java エージェントの全コンポーネントが含まれている newrelic-java.zip ファイルをダウンロードして解凍するための Gradle の設定方法を説明します。

   • newrelic.yml (エージェント設定ファイル)

   • newrelic.jar (Java agent jar)

   • newrelic-api.jar (Java agent API jar)

   • READMEをご覧ください

     そのためには

   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エージェントの個々のコンポーネントをダウンロードするためにGradleを設定する方法を説明します。具体的には、 newrelic.jar と newrelic-api.jar をダウンロードします。

   1. build.gradle ファイルを設定して、 newrelic.jar または newrelic-api.jar をダウンロードします。以下は、 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 ファイルを探すか、使用しているエージェントの バージョン のものをダウンロードします。

      これは、個々のコンポーネント（Javaエージェントおよび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. newrelic.yml を newrelic.jar と同じフォルダーに置きます。JVM arg で特に指定しない限り、 Dnewrelic.config.file と同じフォルダーに置きます。

3. newrelic.yml ファイル (または JVM system properties) に、 license_key と app_name を設定します。

4. -javaagent:/path/to/newrelic.jar をアプリケーションサーバが動作しているJVMに渡します。

5. オプション： New Relic Java agent API を使用する場合は、アプリケーションクラスパスに API jar を追加して、コンパイル時に利用できるようにします。

アプリのトラフィックを生成し、 APM Summary page にデータが表示されるまで数分待ちます。何も表示されない場合は、 トラブルシューティングの手順に従ってください 。