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

Javaエージェントは、コードを自動インストゥルメントするため、モニタリングアプリケーションを起動できます。ランチャーを使用、または本ドキュメントの説明に従って基本的なJavaエージェントのインストレーションを実行できます。

1. インストールの前に

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

• New Relicアカウントにサインアップしていることを確認します。永久無料です。
• 互換性と要件を確認します。
• 環境で追加または代わりのインストールステップが必要かどうかチェックします。

2. エージェントの取得

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

3. エージェントの設定

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

Javaエージェントでは、スタートアップ時に、license_keyとapp_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 を使用して、デプロイの前後に設定を検証することをお勧めします。

次のステップ

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

• Dockerについての質問に関しては、Docker用New Relic Javaエージェントのインストールを参照してください。
• New Relicでアプリを表示し、ユーザーインタフェースに慣れます。
• APMに関するドキュメントをお読みください。たとえば、概要ページ、JVMメトリクスページ、トランザクションページ、およびその他のパフォーマンスモニター機能を読んでください。
• NRQL（New Relic Query Language）を使用して、データをクエリします。
• デフォルトで監視されないアプリケーションのアクティビティに対するカスタムインストゥルメンテーションおよび非同期インストゥルメンテーションの設定方法を学びます。