Java agent release notesRSS

New features and improvements

• Add log_level_denylist config to default yaml 2830

• Solr 9 JMX module 2821

• New centralized token counting strategy for capturing token counts from LLM Responses. 2837

• Support for capturing JDBC batch operations; specifically the addBatch() and executeBatch() methods. 2840

• XML RPC instrumentation module to replace legacy point cut 2841

• Add a new JFR specific config jfr.use_display_name. If set to true, the agent will set the JFR host name to the value in the process_host.display_name configuration. The default is false to preserve old behavior.

If jfr.use_display_name is true but the display_name config is empty, the JfrService will fallback to the old behavior for the host name.

common: &default_settings
  jfr:
    use_display_name: true

2847

• Remove unneeded segment creation in java.xmlrpc module 2853

• Update aws-bedrock-runtime-2.20 Module with a new token counting strategy for each of the models. 2845

• New license key obfuscation algorithm 2864

• Support for Micronaut Http Clients versions 3.5.0+ 2834

• Support for Apache Camel 3.9.0 and up 2896 2901

• Support for Kafka Clients 4.0.0 and up 2896

• Internal dependency Log4j Core Upgrade from 2.17.1 to 2.25.4 2833

• AWS DAX Support starting from 2.0.0 to latest 2873

• Add instrumentation for Spring AI completion and embedding clients for versions 1.0.0 and up. This adds new instrumentation modules:

spring-ai-client-chat-1.0.0
spring-ai-model-1.0.0

2842

• Core Tracing - Drop SpanEvents and Re-Parent dropped SpanLinks 2881

• Pointcut replacements

  • Remove SpringDispatcherPointCut and SpringExceptionHandlerPointCut and instead move the functionality into our Spring instrumentation modules.
  • Replace HandlerInterceptorPointCut 28712886

• Support Micronaut’s BlockingHttpClient 2860

• Add support for AI Model Context Protocol 1.0.0 to latest. 2880

Fixes

• Fix coroutines instrumentation. Fixes include:

  • Better tracking of asynchronous behavior by instrumenting gaps that were found where execution can jump to another thread.
  • Better naming on Coroutines and Continuations. Existing naming was too generic. New naming identifies according to whether it is started via runBlocking, async, withContext or launch.
  • Removed some utility methods that were no longer used 2802

• Fixes excessive number of unexpired async tokens when instrumenting Micronaut. 2792

• Resolution of Mule 4.9 IllegalAccessError 2859

• Fix a mis-recording of the Instrumented and Kept metrics for Core Tracing, as they were originally being recorded as a time metric. 2881

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

새로운 기능 및 개선 사항

• 자바 26 지원 추가 2734
• 자바 에이전트를 사용한 AWS Lambda 모니터링을 위한 Serverless 모드를 추가합니다 2609 2615 2625 2633 2640 2641 2647 2673 2716 2721 2735 2723 2740 2769 2782 2794 2797 2796 2806
• 새 application_logging.forwarding.log_level_denylist 구성을 추가합니다 2764
• 리전 인식 이벤트/메트릭 수집 URI 구현 2749 2790
• enable_auto_app_naming 이(가) true 일 때 로그를 해당 엔티티에 연결하는 기능 지원 추가 2627
• OpenTelemetry 1.59.0+용 opentelemetry-sdk-extension-autoconfigure-1.59.0 계측 추가 2786
• enable_auto_app_naming 이(가) true 일 때 Adaptive Sampler를 해당 엔티티에 연결하기 위한 지원 추가 2805
• enable_auto_app_naming 이(가) true 일 때 생성된 각 엔티티에 대한 지원 가능성 메트릭을 추가합니다 2808
• 클라우드 메타데이터 프록시 우회 설정 구현 2791
• 에이전트에서 여러 버전의 Caffeine에 대한 지원을 추가합니다 2807
• SQL 어레이를 활용하는 설명 계획에 대한 지원을 추가합니다 2815
• 일반 'Queue'를 전송 유형으로 추가 2820
• Reactor Netty Http 클라이언트 호출 지원을 추가합니다 2817

수정 사항

• NR 페이로드의 sampled 필드에 액세스할 때 잘못된 형식의 페이로드로 인해 NPE가 발생하는 엣지 케이스를 수정합니다 2762
• Reactive 구독이 취소될 때 토큰을 만료합니다 2798
• 메모리 누수를 방지하기 위해 TheadTracker 캐시에서 데드 스레드를 수동으로 제거하는 로직을 추가합니다 2811
• 수집 스레드와 JVM 종료 스레드 간의 교착 상태를 해결합니다 2539

최신 버전으로 업데이트

현재 사용 중인 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 또는 다른 diffing 유틸리티를 사용하여 변경된 사항을 확인하고 이전 파일에 새 구성 설정을 추가할 수 있습니다.라이센스 키, 앱 이름 또는 기본 설정 변경 사항과 같이 파일에 대해 수행한 사용자 정의를 덮어쓰지 않도록 하십시오.

예를 들어, יאני 버전 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.
>       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
...

이 예에서 이러한 줄은 יאם 버전 7.11.0의 기본 newrelic.yml 에 추가되었습니다. 7.11.0 이상으로 이동하는 경우 원래 newrelic.yml 에 이러한 새 줄을 추가해야 합니다.

지지 성명:

• 뉴렐릭은 에이전트를 정기적으로 업그레이드하여 최신 기능과 성능 이점을 얻을 것을 권장합니다. 또한, 이전 릴리스는 지원 종료 시점 에 더 이상 지원되지 않습니다.

새로운 기능 및 개선 사항

• 자바 하이브리드 변환기: 뉴럴릭의 심층적인 가시성과 OpenTelemetry API 호환성을 결합하여 "두 가지 장점을 모두 갖춘" 경험을 제공합니다. 이번 릴리스에는 OpenTelemetry Tracing, 지표, 로그 API는 물론 독립 실행형 라이브러리 및 네이티브 프레임워크 측정, 로그 API에 대한 포괄적인 지원이 포함되어 있습니다. 스팬 링크 및 스팬 이벤트와 같은 주요 개선 사항이 이제 제공되어 혼합 모드 환경에서 원활한 상호 운용성을 보장합니다.
  • @jasonjkeller가 2711번 이슈에서 발표한 하이브리드 에이전트 OpenTelemetry API 지원
• @dhilpipre가 2726버전에서 코루틴 무시 기능을 개선했습니다.
• 에이전트 메타데이터 추가 작업 - @mvicknr 2732 2745

수정 사항

• @jasonjkeller가 2299에서 w3c 헤더를 사용하여 깨진 트랜스 전파를 수정했습니다.
• 2720버전에서 @jtduffy 님이 멀티호스트 환경설정 구성을 수정했습니다.
• 2663 버전에서 @dhilpipre가 suspend ignores를 읽지 못하는 문제를 수정했습니다.

최신 버전으로 업데이트

현재 사용 중인 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 또는 다른 diffing 유틸리티를 사용하여 변경된 사항을 확인하고 이전 파일에 새 구성 설정을 추가할 수 있습니다.라이센스 키, 앱 이름 또는 기본 설정 변경 사항과 같이 파일에 대해 수행한 사용자 정의를 덮어쓰지 않도록 하십시오.

예를 들어, יאני 버전 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.
>       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
...

이 예에서 이러한 줄은 יאם 버전 7.11.0의 기본 newrelic.yml 에 추가되었습니다. 7.11.0 이상으로 이동하는 경우 원래 newrelic.yml 에 이러한 새 줄을 추가해야 합니다.

지지 성명:

• 뉴렐릭은 에이전트를 정기적으로 업그레이드하여 최신 기능과 성능 이점을 얻을 것을 권장합니다. 또한, 이전 릴리스는 지원 종료 시점 에 더 이상 지원되지 않습니다.

새로운 기능 및 개선 사항

• @jtduffy가 2676번 이슈에서 추가한, 시작 시 오래된 에이전트 임시 JAR 파일을 삭제하는 설정 추가
• 2638에서 선택적으로 제작된 @jtduffy에 대한 제외 설정을 보완하기 위해 "inclusion" 옵션을 추가합니다.
  • 이 기능을 사용하려면 환경 변수 NEW_RELIC_STARTUP_JAVA_ARTIFACT_INCLUDES 또는 시스템 속성 newrelic.config.startup_java_artifact_includes 을 설정하십시오. 계측해야 할 아티팩트를 쉼표로 구분된 목록으로 지정하십시오.

수정 사항

• @jtduffy가 2503에서 S3AsyncClient_Instrumentation에서 래퍼 클래스를 제거하여 IllegalAccessError를 해결했습니다.
• 2594의 @jasonjkeller가 logback-classic-1.5.20에서 로그 이벤트에 대한 잘못 레이블이 지정된 측정, 로그 이벤트 버전을 수정했습니다.
• @jeffalder 님이 2680버전에서 최대 속성 값에 대한 로깅 메시지를 수정했습니다.
• @jtduffy가 2583에서 수정한 트레이스 비율 샘플러 우선순위

이사

• @obenkenobi가 2572버전에서 더 이상 사용되지 않는 jdbc-inet-* 모듈을 제거했습니다.
• 더 이상 사용되지 않는 java.completable-future-jdk8을 제거합니다. 측정, 2562년 @obenkenobi 작성
• 2567년@obenkenobi의 AWS 랩 측정, 로그 제거
• @obenkenobi가 2614에서 jdbc-sybase-6 모듈을 제거했습니다.
• 2568년@obenkenobi의 play 2.3 측정, 리소스 제거
• 더 이상 사용되지 않는 thrift-0.8을 제거합니다. @obenkenobi가 2569에 만든 모듈
• @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 포인트컷을 제거합니다.
• @sharvath-newrelic이 2575버전에서 더 이상 사용되지 않는 모듈 glassfish-3을 제거합니다.
• @obenkenobi가 2571버전에서 더 이상 사용되지 않는 rabbit-amqp 모듈 2.5.0, 2.4.1, 1.7.2를 제거했습니다.
• @jtduffy가 2589버전에서 배포 마커 기능을 제거했습니다.

최신 버전으로 업데이트

현재 사용 중인 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 또는 다른 diffing 유틸리티를 사용하여 변경된 사항을 확인하고 이전 파일에 새 구성 설정을 추가할 수 있습니다.라이센스 키, 앱 이름 또는 기본 설정 변경 사항과 같이 파일에 대해 수행한 사용자 정의를 덮어쓰지 않도록 하십시오.

예를 들어, יאני 버전 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.
>       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
...

이 예에서 이러한 줄은 יאם 버전 7.11.0의 기본 newrelic.yml 에 추가되었습니다. 7.11.0 이상으로 이동하는 경우 원래 newrelic.yml 에 이러한 새 줄을 추가해야 합니다.

지지 성명:

• 뉴렐릭은 에이전트를 정기적으로 업그레이드하여 최신 기능과 성능 이점을 얻을 것을 권장합니다. 또한, 이전 릴리스는 지원 종료 시점 에 더 이상 지원되지 않습니다.

수정 사항

• 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 에이전트 버전을 식별하려면 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 또는 다른 diffing 유틸리티를 사용하여 변경된 사항을 확인하고 이전 파일에 새 구성 설정을 추가할 수 있습니다.라이센스 키, 앱 이름 또는 기본 설정 변경 사항과 같이 파일에 대해 수행한 사용자 정의를 덮어쓰지 않도록 하십시오.

예를 들어, יאני 버전 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.
>       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
...

이 예에서 이러한 줄은 יאם 버전 7.11.0의 기본 newrelic.yml 에 추가되었습니다. 7.11.0 이상으로 이동하는 경우 원래 newrelic.yml 에 이러한 새 줄을 추가해야 합니다.

지지 성명:

• 뉴렐릭은 에이전트를 정기적으로 업그레이드하여 최신 기능과 성능 이점을 얻을 것을 권장합니다. 또한, 이전 릴리스는 지원 종료 시점 에 더 이상 지원되지 않습니다.