New Relicの最新機能、追加機能、重要なセキュリティパッチを最大限に活用できるよう、Javaエージェントを最新バージョンにアップデートすることをお勧めします。特定のエージェントのアップデートの詳細については、JavaエージェントのリリースノートとJavaの互換性と要件に関するドキュメントを参照してください。
これらのアップデート手順では、New Relic Javaエージェント (newrelic.jar) を含んだエージェントのルートディレクトリの現在のコンテンツの一部を、New Relic UIから新たにダウンロードしたコンテンツと置き換える方法を解説しています。
最新バージョンへのアップデート
現在使用中のJavaエージェントのバージョンを特定するには、java -jar newrelic.jar -vを実行します。Javaエージェントのバージョンがコンソールに出力されます。
次に、最新バージョンのJavaエージェントにアップデートするには、以下の手順に従います。
entire Javaエージェントのルートディレクトリを他の場所にバックアップします。 そのディレクトリの名前を
NewRelic_Agent#.#.#に変更します。ここで、#.#.#はエージェントのバージョン番号です。新しいエージェントのダウンロードファイルを解凍し、
newrelic-api.jarとnewrelic.jarを元のJavaエージェントのルートディレクトリにコピーします。（オプション）JavaエージェントAPIやScala APIなどのエージェントAPIを使用している場合は、APIの依存関係を最新バージョンにアップグレードすることをお勧めします。新しいエージェントバージョンではAPIが引き続きサポートされますが、新しい機能が利用できなくなる可能性があります。 Mavenなどのビルドツールを使用している場合は、APIバージョンを最新にアップグレードしてください。 たとえば、JavaエージェントAPIをGradleで使用している場合は、
${agent.version}を最新バージョンに置き換えます。implementation 'com.newrelic.agent.java:newrelic-api:${agent.version}'Javaプロセスを再起動します。
Javaエージェントのアップデート後に問題が発生する場合は、バックアップしたNew Relicエージェントディレクトリから復元します。