Java agent release notes | New Relic Documentation

February 12

New features and improvements

The Java Hybrid Agent: offering a "best-of-both-worlds" experience by combining New Relic’s deep visibility with OpenTelemetry API compatibility. This release includes comprehensive support for the OpenTelemetry Tracing, Metrics, and Logs APIs, as well as standalone library and native framework instrumentation. Key enhancements like Span Links and Events on Spans are now available, ensuring seamless interoperability in mixed-mode environments.
- Update hybrid agent config based on spec changes by @jasonjkeller in 2738
- Hybrid Agent OpenTelemetry API Support by @jasonjkeller in 2711
- OTel Bridge API support by @sdaubin in 1886
Added support for prepending a comment to executed SQL that contains the entity GUID of the current application. This is used by the Query Performance Monitoring product for entity linking by @jtduffy in 2715
Enhancements to coroutine ignores by @dhilpipre in 2726
Add agent metadata action - @mvicknr in 2732 2745

Fixes

Fix broken trace propagation with w3c headers by @jasonjkeller in 2299
Fix multihost preference config @jtduffy in 2720
Fixed problem where suspend ignores was not being read by @dhilpipre in 2663

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:

Back up the entire Java agent root directory to another location. Rename that directory to NewRelic_Agent#.#.#, where #.#.# is the agent version number.
Download the agent..
Unzip the new agent download file, then copy newrelic-api.jar and newrelic.jar into the original Java agent root directory.
Compare your old newrelic.yml with the newly downloaded newrelic.yml from the zip, and update the file if needed.
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.
>       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.

January 14

Java agent v9.0.0

このエージェントのバージョンをダウンロード

新機能と改善点

起動時に古いエージェント一時 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によってデプロイメントマーカー機能が削除されました

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

エージェントの新しいバージョンをリリースする際に、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 では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。さらに、古いリリースはサポート終了になるとサポートされなくなります。

December 17, 2025

Java agent v8.25.1

このエージェントのバージョンをダウンロード

修正

サードパーティの実装に関するKotlinコルーチンエラーを修正 CancellableContinuation

廃止予定

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バージョン 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
...

サポートステートメント:

New Relic では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。さらに、古いリリースはサポート終了になるとサポートされなくなります。

November 12, 2025

Java agent v8.25.0

このエージェントのバージョンをダウンロード

新機能と改善点

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バージョン 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
...

サポートステートメント:

New Relic では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。さらに、古いリリースはサポート終了になるとサポートされなくなります。

September 3, 2025

Java agent v8.24.0

このエージェントのバージョンをダウンロード

新機能と改善点

@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バージョン 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
...

サポートステートメント:

New Relic では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。さらに、古いリリースはサポート終了になるとサポートされなくなります。

August 13, 2025

Java agent v8.23.0

このエージェントのバージョンをダウンロード

新機能と改善点

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バージョン 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
...

サポートステートメント:

New Relic では、最新の機能とパフォーマンス上のメリットを確実に得られるよう、エージェントを定期的にアップグレードすることをお勧めします。さらに、古いリリースはサポート終了になるとサポートされなくなります。

Java agent release notesRSS

New features and improvements

Fixes

Update to latest version

Update agent config differences

Support statement:

新機能と改善点

修正

撤去

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

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

サポートステートメント:

修正

廃止予定

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

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

サポートステートメント:

新機能と改善点

修正

廃止予定

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

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

サポートステートメント:

新機能と改善点

修正

廃止予定

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

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

サポートステートメント:

新機能と改善点

修正

廃止予定

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

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

サポートステートメント:

New features and improvements.css-21sua1{background:none;border:none;width:0;padding:0;}

Fixes

Update to latest version

Update agent config differences

Support statement:

新機能と改善点

修正

撤去

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

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

サポートステートメント:

修正

廃止予定

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

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

サポートステートメント:

新機能と改善点

修正

廃止予定

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

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

サポートステートメント:

新機能と改善点

修正

廃止予定

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

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

サポートステートメント:

新機能と改善点

修正

廃止予定

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

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

サポートステートメント:

New features and improvements