Javaエージェントのアップデート

New Relicの最新機能、追加機能、重要なセキュリティパッチを最大限に活用できるよう、Javaエージェントを最新バージョンにアップデートすることをお勧めします。特定のエージェントのアップデートの詳細については、Javaエージェントのリリースノートを参照してください。

これらのアップデート手順では、New Relic Javaエージェント（newrelic.jar）を含むエージェントのルートディレクトリの現在のコンテンツの一部を、New Relic UIから新たにダウンロードされたコンテンツと置き換える方法を説明します。

エージェント設定の差分のアップデート

2つのバージョン間の差分がお使いのアプリケーションのカスタマイゼーションに関連していない場合は、最新のアップデートを進めるのに使用するnewrelic.ymlをNew Relicのデフォルトnewrelic.ymlに合わせます。

たとえば、Javaエージェントバージョン3.29.0と3.30.0に対してデフォルトのnewrelic.ymlファイルのdiffを実行した場合、コンソールに出力される結果は、以下のようになります。

➜ diff newrelic_3.29.0.yml newrelic_3.30.0.yml
254a255,265
> # Classes loaded by classloaders in this list will not be instrumented.
> # This is a useful optimization for runtimes which use classloaders to
> # load dynamic classes which the agent would not instrument.
> classloader_excludes:
> groovy.lang.GroovyClassLoader$InnerLoader,
> org.codehaus.groovy.runtime.callsite.CallSiteClassLoader,
> com.collaxa.cube.engine.deployment.BPELClassLoader,
> org.springframework.data.convert.ClassGeneratingEntityInstantiator$ObjectInstantiatorClassGenerator,
> org.mvel2.optimizers.impl.asm.ASMAccessorOptimizer$ContextClassLoader,
> gw.internal.gosu.compiler.SingleServingGosuClassLoader,
>

これらの行は、Javaエージェントバージョン3.30.0のデフォルトのnewrelic.ymlに追加されました。Javaエージェントバージョン3.30.0以降を実行したい場合、これらの行を必ずnewrelic.ymlに含めるようにしてください。

Javaエージェントのバージョンには未対応

販売終了通知：2015年1月26日をもって、New Relicは3.6.0より前のJavaエージェントバージョンからのデータを受け付けなくなります（ただし、バージョン2.21.7を除く）。

これらのエージェントのバージョンは、New Relicのデータ収集サービスと通信する際に期限切れプロトコルを使用しています。また、こうしたバージョンの多くは、重要なデータを誤ってNew Relicコレクターに送信するという、潜在的なセキュリティ上の問題も抱えています。

サポート対象外のバージョンのエージェントのアップデート

重要

メジャーバージョンのアップデートなど、以前のバージョンのエージェントからアップデートしている場合は、機能変更の以下のリストを見直してください。

移行	コメント
5.0.0	リリースノート：Javaエージェント5.0.0 セルフインストーラ： New Relic Javaエージェントのセルフインストーラは、ユーザー体験をより一貫したものとするために削除されました。Javaエージェントをインストールするには、`newrelic.jar`へのフルパスを、JVMオプションの`-javaagent`フラグに追加します。詳細については、Docker、Maven、Gradleなど、特定のアプリケーションサーバーでのエージェントのインストールについてのドキュメントをご覧ください。非推奨のインストゥルメンテーション：以下のインストゥルメンテーションモジュールは、デフォルトのJavaエージェントから移動されました。これらのモジュールは、現在別のダウンロードとして提供されています。これらのモジュールを引き続き使用するには、New Relicフォルダにあるエージェントの拡張機能ディレクトリ、または拡張機能ディレクトリが設定されている場所に追加します。非推奨のモジュールには、以下が含まれます。 Akka 2.0 Akka 2.1 Akka-http 1.0 Akka-http 2.0～2.4.1 Akka-http 2.4.2～2.4.4 Hystrix 1.2 Hystrix 1.3 Play 1：Play-1.xのインストゥルメンテーションは、拡張機能としては使用できません。 Play 2.0 Play 2.1 Play 2.2 Solr 3.1～3.4 Solr 3.5 Solr 3.6
4.12.0	リリースノート：Javaエージェント4.12.0 非推奨のAPI：カスタムトランスポートチャネルAPIは、ディストリビューティッド（分散）トレーシングAPIを使用するようになったため、非推奨となっています。 `@Trace`アノテーションの`skipTransactionTrace`属性は、非推奨となりました。代わりに、`excludeFromTransactionTrace`属性を使用します。非推奨のインストゥルメンテーション： JetS3t：JetS3tの組み込みインストゥルメンテーションは削除。エージェントは引き続き、JetS3ｔクライアントで作成された外部呼び出しをレポートします。
4.4.0	リリースノート：Javaエージェント4.4.0 Java 6サポートを削除： 4.3以下のバージョンを使用する必要があります。 EUデータセンター： EUデータセンターでの使用に必要な最低バージョン。 SSL設定オプションを削除： SSLは、常に、New Relic Serversとの通信に使用されるようになりました。`newrelic.yml` ssl設定および`-Dnewrelic.config.ssl`システムプロパティは使用されていません。いずれかの値を`true`以外に設定すると、ログで警告が発生します。
レガシーエージェント 2.21.7	リリースノート：Javaエージェント2.21.7 Java SE 5.0：これは、エージェントのレガシーJava SE 5.0のバグ修正リリースです。Java SE5を使用している場合を除き、最新バージョンのNew Relic Javaエージェントを使用してください。これにより、以下に影響が生じます。 Linux、Solaris、Windows、OS X用Oracle Hotspot JVMバージョン5.0 Oracle JRockit（1.6.0_50まで）

その他のヘルプ

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

Explorers Hubでは、コミュニティからのサポートを受けたり、ディスカッションに参加したりすることができます。
当社サイトで答えを見つけて、サポートポータルの使用方法を確認してください。
Linux、Windows、およびmacOS向けトラブルシューティングツールであるNew Relic Diagnosticsを実行してください。
New Relicのとandドキュメント