Javaエージェントをインストール

当社のJavaエージェントは、コードを自動インストゥルメントするので、モニタリングアプリケーションを開始できます。基本的なJavaエージェントのインストールを完了する方法は、こちらに示されています。

エージェントをインストールするには、ランチャーを使用するか、以下の説明に従います。

1. インストールの前に

次の点をチェックします:

2. エージェントを取得する

curlまたはInvoke-WebRequest (PowerShell)、New Relic UIを使用して、newrelic-java.zipをダウンロードします:

curlを使用してダウンロードする

次の項目を完了します:

  1. コマンドラインセッションを開始します。
  2. zipファイルをダウンロードできる一時ディレクトリに変更します。
  3. このcurlコマンドを実行します:
     curl -O https://download.newrelic.com/newrelic/java-agent/newrelic-agent/current/newrelic-java.zip
  4. Unzip newrelic-java.zip
Invoke-WebRequest (PowerShell) を使用してダウンロード

次の項目を完了します:

  1. PowerShellセッションを開始します。
  2. zipファイルをダウンロードできる一時ディレクトリに変更します。
  3. このPowerShellコマンドを実行します:
     Invoke-WebRequest -Uri https://download.newrelic.com/newrelic/java-agent/newrelic-agent/current/newrelic-java.zip -OutFile newrelic-java.zip
  4. newrelic-java.zipを解凍します:
     Expand-Archive -Path newrelic-java.zip -DestinationPath DESTINATION_PATH 
New Relic UIからダウンロードする

次の項目を完了します:

  1. New Relicにサインインします。

  2. New Relic UIのアカウントドロップダウンからAccount settingsを選択します。

  3. Most recentの下にある右側のサイドバーでJavaエージェントを選択し、newrelic-java.zipを一時ディレクトリに保存します。

  4. Unzip newrelic-java.zip.

3. エージェントの設定

newrelic.ymlでエージェント設定を使用して基本的なセットアップを行う方法は次のとおりです。

高度なインストールについては、環境変数Javaシステムプロパティサーバーサイドコンフィグレーションにより設定を渡すことができます。この設定の優先順位について理解するには、Javaエージェント設定: Configファイルをご覧ください。

Javaエージェントでは、スタートアップ時に、license_keyapp_nameの設定が必要です。その他すべての設定はオプションで、Javaエージェント設定: Configファイルで確認できます。

解凍したインストールファイルに移動し、newrelic サブディレクトリ内でnewrelic.ymlを編集します:

  1. license_keyのある行を検索します。
  2. '<%= license_key %>'を、お使いのライセンスに変更します。例えば:

    license_key: 456n20n1367ov2s174v51nvn789d21s67v26NRAL
  3. app_nameのある行を検索します。
  4. My Applicationを、アプリケーションの特定に役立つ名前に変更します。例えば:
     app_name: Tax Calculator

    アプリケーションの命名法についてのヒントが必要な場合、アプリケーションに名前を付けるをご覧ください。

  5. エージェントロギングディストリビューティッド(分散)トレーシングなどのオプション設定を追加(または後で追加)します。
  6. newrelic.ymlを保存して終了します。

4. エージェントのインストール

Javaエージェントのインストールでは、解凍したすべてのNew Relicファイルを、アプリケーションサーバー/コンテナのディレクトリ構成にコピーします。たとえば、/opt/newrelicディレクトリを作成できますが、ファイルを他の場所に置きたい場合、次の点を確認してください。

  • ディレクトリ内の.jarファイルは、クラスパスには置けません。
  • .jarファイルは、java.endorsed.dirsで指定されたディレクトリには入れられません。

Javaエージェントをインストールするには:

  1. アプリケーションサーバー/コンテナディレクトリで、New Relicファイルのディレクトリ(例としては/opt/newrelic)を作成します。
  2. すべてのNew Relicファイルを、解凍したnewrelicディレクトリから新たなディレクトリにコピーします。
  3. Javaの開始時に、アプリケーションサーバー/コンテナにこのオプションが含まれることを確認します(ツールまたはフレームワークを使用してこれを実行する方法のヒントについては、JVM引数をご覧ください):
     -javaagent:/full/path/to/newrelic.jar
  4. アプリケーションサーバー/コンテナを起動、または再起動します。

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

5. インストール後のタスク

newrelic.ymlを使用して設定を行っている場合、次の点を考慮します:

  • 当社は、newrelic.ymlファイルのパーミッションをデフォルトの値からアプリケーションサーバープロセスのオーナーのみ読み取り/書き込み可能な値に変更することをお勧めします。
  • その他の重要なファイルについては、newrelic.ymlがバックアップルーチンの一部となっていることを確認してください。
  • New Relic Diagnostics を使用して、デプロイの前後に設定を検証することをお勧めします。

次のステップ

考慮する追加のトピックは次のとおりです。

その他のヘルプ

さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください: