新機能と改善点
- 起動時に古いエージェント一時 jar を削除する設定を @jtduffy が2676に追加
- 2638で選択的にインストゥルメントされたアプリケーション @jtduffy の除外設定を補完する「inclusion」オプションを追加しました。
- この機能を使用するには、環境変数
NEW_RELIC_STARTUP_JAVA_ARTIFACT_INCLUDESまたはシステム プロパティnewrelic.config.startup_java_artifact_includesを設定します。インストゥルメントされるアーティファクトをカンマ区切りのリストとして指定します。
- この機能を使用するには、環境変数
修正
- 2503で @jtduffy が S3AsyncClient_Instrumentation からラッパー クラスを移動して IllegalAccessError を解決しました。
- @jasonjkeller による logback-classic-1.5.20 のログイベントの誤ったラベルの計装バージョンを修正(2594)
- 2680で @jeffalder による最大属性値のログメッセージを修正しました
- 2583で @jtduffy によってトレース比サンプラーの優先順位が修正されました
撤去
- 2572で @obenkenobi によって非推奨の jdbc-inet-* モジュールが削除されました
- 非推奨の java.completable-future-jdk8 を削除します計装 by @obenkenobi in 2562
- 2567 年に @obenkenobi による AWS ラップ計装を削除
- 2614で @obenkenobi によって jdbc-sybase-6 モジュールが削除されました
- 2568 年に @obenkenobi による play 2.3 計装を削除
- 非推奨のthrift-0.8を削除します2569の@obenkenobiによるモジュール
- @obenkenobi によって2570で非推奨の Solr 4.0 および 5.0 モジュールが削除されました
- 非推奨モジュール grails-1.3 を削除します@obenkenobi による2573
- 非推奨モジュール hibernate-3.3 を削除します@obenkenobi による2574
- 2620 年に @sharvath-newrelic によって非推奨のフッター インジェクションAPIを削除
- @obenkenobi による2561の非推奨 Struts 1 ポイントカットを削除します
- 2575で@sharvath-newrelicによって非推奨のモジュールglassfish-3が削除されました
- @obenkenobi によって、 2571で非推奨の Rabbit-amqp モジュール 2.5.0、2.4.1、1.7.2 が削除されました。
- 2589年に@jtduffyによってデプロイメントマーカー機能が削除されました
最新バージョンへのアップデート
現在使用中のJavaエージェントのバージョンを特定するには、java -jar newrelic.jar -vを実行します。Javaエージェントのバージョンがコンソールに出力されます。
次に、最新バージョンのJavaエージェントにアップデートするには、以下の手順に従います。
- すべてのJavaエージェントのルートディレクトリを別の場所にバックアップします。そのディレクトリの名前を
NewRelic_Agent#.#.#に変更します。ここで、#.#.#はエージェントのバージョン番号です。 - エージェントをダウンロードします。
- 新しいエージェントのダウンロードファイルを解凍し、
newrelic-api.jarとnewrelic.jarを元のJavaエージェントのルートディレクトリにコピーします。 - 古い
newrelic.ymlとzipからダウンロードした新しいnewrelic.ymlを比較し、必要に応じてファイルを更新します。 - Javaディスパッチャを再起動します。
Javaエージェントのアップデート後に問題が発生する場合は、バックアップしたNew Relicエージェントディレクトリから復元します。
エージェント設定の差分のアップデート
エージェントの新しいバージョンをリリースする際に、newrelic.ymlに新しい設定を追加します。diffまたは別の差分ユーティリティを使用して変更内容を確認してから、新しい設定を古いファイルに追加できます。ライセンスキー、アプリ名、デフォルト設定の変更など、ファイルに対して行ったカスタマイズを上書きしないようにしてください。
たとえば、 Javaバージョン 7.10.0 および 7.11.0 のデフォルトのnewrelic.ymlファイルをdiffすると、コンソールに表示される結果は次のようになります。
➜ diff newrelic_7.10.0.yml newrelic_7.11.0.yml...107a108,119> # Whether the log events should include context from loggers with support for that.> include_context_data:>> # When true, application logs will contain context data.> enabled: false>> # A comma separated list of attribute keys whose values should be sent to New Relic.> #include:>> # A comma separated list of attribute keys whose values should not be sent to New Relic.> #exclude:>125a138>128c141< enabled: false---> enabled: true...この例では、これらの行はJavaエージェント バージョン 7.11.0 のデフォルトのnewrelic.ymlに追加されました。 7.11.0 以降に移行する場合は、これらの新しい行を元のnewrelic.ymlに追加する必要があります。
サポートステートメント:
- New Relic では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。さらに、古いリリースはサポート終了になるとサポートされなくなります。