Java agent release notesRSS

Fixes

• Fixes Kotlin Coroutine error about third party implementation of CancellableContinuation

Deprecations

• aws-wrap-0.7.0
• java.completable-future-jdk8
• play-2.3
• netty-3.4
• Struts v1
• spring-3.0.0
• thrift-0.8
• solr-4.0.0
• solr-5.0.0
• jdbc-inet-merlia
• jdbc-inet-oranxo
• grails-1.3
• rabbit-amqp-1.7.2
• rabbit-amqp-2.4.1
• rabbit-amqp-2.5.0
• rabbit-amqp-2.7.0
• glassfish-3
• hibernate-3.3
• hibernate-3.5
• jdbc-jtds

Update to latest version

To identify which version of the Java agent you're currently using, run java -jar newrelic.jar -v. Your Java agent version will be printed to your console.

Then, to update to the latest Java agent version:

1. Back up the entire Java agent root directory to another location. Rename that directory to NewRelic_Agent#.#.#, where #.#.# is the agent version number.
2. Download the agent.
3. Unzip the new agent download file, then copy newrelic-api.jar and newrelic.jar into the original Java agent root directory.
4. Compare your old newrelic.yml with the newly downloaded newrelic.yml from the zip, and update the file if needed.
5. Restart your Java dispatcher.

If you experience issues after the Java agent update, restore from the backed-up New Relic agent directory.

Update agent config differences

We add new settings to newrelic.yml as we release new versions of the agent. You can use diff or another diffing utility to see what's changed, and add the new config settings to your old file. Make sure not to overwrite any customizations you've made to the file, such as your license key, app name, or changes to default settings.

For example, if you diff the default newrelic.yml files for Java agent versions 7.10.0 and 7.11.0, the results printed to the console will be like:

➜ 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
...

In this example, these lines were added to the default newrelic.yml in Java agent version 7.11.0. If you're moving to 7.11.0 or higher, you should add these new lines to your original newrelic.yml.

Support statement:

• New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Additionally, older releases will no longer be supported when they reach end-of-life.

新機能と改善点

• 2512に @deleonenriqueta が Java 25 サポートを追加
• 2535で@jtduffyによるLogback-1.5.20のサポートを追加
• 2490で @jtduffy によってcallおよびexec SQL パーサー正規表現の実行を無効にする設定オプションが導入されました。
• 2454で @dhilpipre による Kotlin Coroutines v1.4+ のサポートを追加しました
• 2456で @dhilpipre によって Kotlin Coroutinesの外部で生成された Kotlin Coroutinesサスペンド関数のサポートが追加されました
• @jbedell-newrelic が2508でデータストア検出中に複数のホストを設定するための設定を導入しました。
• 2509で @jtduffy によってアーティファクトスキップ機能を設定するためのシステムプロパティが追加されました
• @sharvath-newrelic によって2532で、Spring コントローラーのトランザクションにコントローラーのクラス名とメソッド名を使用して名前を付けることができる設定オプションが追加されました。
• SamplerConfig を実装し、すべてのdistributed_tracing.sampler構成をSamplerConfigに一元化します(2529 年、@jasonjkeller による)
• 2516 年に @sharvath-newrelic による W3Ct レースコンテキストのサポートを備えた最新のディストリビューティッド（分散）トレーシングAPIを使用するように、 kafka-clients-spans-0.11.0.0プロデューサー計装を更新しました。

修正

• 2497の @sharvath-newrelic によるエラークラス名の解析を修正
• @jtduffy による2498のエラーログのスタックトレースが大きすぎるために発生する潜在的なメモリ問題を修正しました。
• @sharvath-newrelic による、カスタムイベントとログイベントの無効な属性に関するログメッセージの明確化(2501)

廃止予定

次の 計装 モジュールは非推奨であり、次のメジャー リリースで削除される予定です。

• aws-wrap-0.7.0
• java.completable-future-jdk8
• play-2.3
• netty-3.4
• Struts v1
• spring-3.0.0
• thrift-0.8
• solr-4.0.0
• solr-5.0.0
• jdbc-inet-merlia
• jdbc-inet-oranxo
• grails-1.3
• rabbit-amqp-1.7.2
• rabbit-amqp-2.4.1
• rabbit-amqp-2.5.0
• rabbit-amqp-2.7.0
• glassfish-3
• hibernate-3.3
• hibernate-3.5
• jdbc-jtds

最新バージョンへのアップデート

現在使用中のJavaエージェントのバージョンを特定するには、java -jar newrelic.jar -vを実行します。Javaエージェントのバージョンがコンソールに出力されます。

次に、最新バージョンのJavaエージェントにアップデートするには、以下の手順に従います。

1. すべてのJavaエージェントのルートディレクトリを別の場所にバックアップします。そのディレクトリの名前をNewRelic_Agent#.#.#に変更します。ここで、#.#.#はエージェントのバージョン番号です。
2. エージェントをダウンロードします。
3. 新しいエージェントのダウンロードファイルを解凍し、newrelic-api.jarとnewrelic.jarを元のJavaエージェントのルートディレクトリにコピーします。
4. 古いnewrelic.ymlとzipからダウンロードした新しいnewrelic.ymlを比較し、必要に応じてファイルを更新します。
5. 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 では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。さらに、古いリリースはサポート終了になるとサポートされなくなります。

新機能と改善点

• @obekenobi による2465の MongoDB Reactive Streams 5.2.0 以降をサポート
• 2466年に@kanderson250がJedis 6をサポート

修正

• CouchBase: 2462 @jtduffy による二重計装を防ぐスキップ クラスを追加
• Spring WebClient 5.x: レスポンス全体ではなくヘッダーのみをラップする(2464) @jtduffy

廃止予定

• aws-wrap-0.7.0
• java.completable-future-jdk8
• play-2.3
• netty-3.4
• Struts v1

最新バージョンへのアップデート

現在使用中のJavaエージェントのバージョンを特定するには、java -jar newrelic.jar -vを実行します。Javaエージェントのバージョンがコンソールに出力されます。

次に、最新バージョンのJavaエージェントにアップデートするには、以下の手順に従います。

1. すべてのJavaエージェントのルートディレクトリを別の場所にバックアップします。そのディレクトリの名前をNewRelic_Agent#.#.#に変更します。ここで、#.#.#はエージェントのバージョン番号です。
2. エージェントをダウンロードします。
3. 新しいエージェントのダウンロードファイルを解凍し、newrelic-api.jarとnewrelic.jarを元のJavaエージェントのルートディレクトリにコピーします。
4. 古いnewrelic.ymlとzipからダウンロードした新しいnewrelic.ymlを比較し、必要に応じてファイルを更新します。
5. 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 では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。さらに、古いリリースはサポート終了になるとサポートされなくなります。

新機能と改善点

• 2425年に@jtduffyがgraphqlのv24をサポートするように更新しました
• レタス6.5計装追加 by @kanderson250 in 2430
• @jtduffy が2421 年に commons-lang バージョンを 3.18.0 にアップグレードしました
• 2423で @kanderson250 が、データストア パラメータに lettuce dbName を追加できるようになりました。
• 特定のアプリケーションの実装をスキップするための環境変数を追加します。環境変数名はNEW_RELIC_STARTUP_JAVA_ARTIFACT_SKIPSです。その値は、エージェントが計量すべきではないメインクラス、実行可能 jar ファイル、またはJavaベースのツール/アプリのカンマ区切りのリストです (例: NEW_RELIC_STARTUP_JAVA_ARTIFACT_SKIPS=keytool,myapp.jar,IgnoreThisClass )、@jtduffy による2433 年

修正

• 8 つの属性を持つ SQS メッセージが AWS に送信されないバグを修正しました。2422 年の @obenkenobi によるディストリビューティッド（分散）トレーシング ヘッダーを渡すには、SQS メッセージに 8 未満のプロパティが必要です
• 2440の @jbedell-newrelic による Azure Service Bus クライアントのトピック名の末尾の「サブスクリプション」部分を削除します
• 2451の @jasonjkeller による AutoConfiguredOpenTelemetrySdk 設定を修正

廃止予定

次の 計算モジュールは非推奨であり、次のメジャー リリースで削除されます。

• aws-wrap-0.7.0
• java.completable-future-jdk8
• play-2.3
• netty-3.4
• Struts v1

最新バージョンへのアップデート

現在使用中のJavaエージェントのバージョンを特定するには、java -jar newrelic.jar -vを実行します。Javaエージェントのバージョンがコンソールに出力されます。

次に、最新バージョンのJavaエージェントにアップデートするには、以下の手順に従います。

1. すべてのJavaエージェントのルートディレクトリを別の場所にバックアップします。そのディレクトリの名前をNewRelic_Agent#.#.#に変更します。ここで、#.#.#はエージェントのバージョン番号です。
2. エージェントをダウンロードします。
3. 新しいエージェントのダウンロードファイルを解凍し、newrelic-api.jarとnewrelic.jarを元のJavaエージェントのルートディレクトリにコピーします。
4. 古いnewrelic.ymlとzipからダウンロードした新しいnewrelic.ymlを比較し、必要に応じてファイルを更新します。
5. 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 では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。さらに、古いリリースはサポート終了になるとサポートされなくなります。

新機能と改善点

• Azure サービスバス 7.15.0\@jbedell-newrelic による計装 ( 2384)
• 2399年に@jbedell-newrelicがAzure App Servicesのメタデータをリンクする
• 2377 年に @jtduffy によって接続エラーが SEVERE でログに記録されるようになりました
• 2388 年に @jtduffy によってログとイベントにプロパティとして追加された無効なキーをログに記録し、難読化します

修正

• @meiao による IntelliJ アノテーション ライブラリの再配置(2383)
• 2386で @jtduffy によるサーバー側サンプリングターゲット設定をサポート
• 2400 年に @deleonenriqueta によって潜在的なメモリ リークを修正するために MonoFlatMapMain 計装を削除

廃止予定

次の 計算モジュールは非推奨であり、次のメジャー リリースで削除されます。

• aws-wrap-0.7.0
• java.completable-future-jdk8
• play-2.3
• netty-3.4
• Struts v1

最新バージョンへのアップデート

現在使用中のJavaエージェントのバージョンを特定するには、java -jar newrelic.jar -vを実行します。Javaエージェントのバージョンがコンソールに出力されます。

次に、最新バージョンのJavaエージェントにアップデートするには、以下の手順に従います。

1. すべてのJavaエージェントのルートディレクトリを別の場所にバックアップします。そのディレクトリの名前をNewRelic_Agent#.#.#に変更します。ここで、#.#.#はエージェントのバージョン番号です。
2. エージェントをダウンロードします。
3. 新しいエージェントのダウンロードファイルを解凍し、newrelic-api.jarとnewrelic.jarを元のJavaエージェントのルートディレクトリにコピーします。
4. 古いnewrelic.ymlとzipからダウンロードした新しいnewrelic.ymlを比較し、必要に応じてファイルを更新します。
5. 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 では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。さらに、古いリリースはサポート終了になるとサポートされなくなります。