Java agent release notesRSS

New features and improvements

• Java 27 support 3095
• AI Monitoring - Support for AWS Converse APIs 2995 3003
• Support Quarkus: rest-3.0.0 3009
• Support Quarkus resteasy 2.14 3018
• Support Spring Boot Actuator v4 3040
• Support for Ktor Http Clients, Http Server and Utils (Pipelines) 2892 2894 2895
• Support for Redisson 3.28.0 and up 3050
• Adobe AEM (Sling) browser script injection modules 2863
• Oracle explain plan support 3080

Enhancements

• Add (limited) Hybrid Agent proxy support 3013
• Hybrid Agent - Logging - Allow empty message body when context attributes are present 3042
• Add hybrid audit logging 3059
• Enhance gRPC-Netty support 3063
• Enable Hybrid Agent OTLP metric retry logic 3084
• Add collector connection TTL and recovery tests 3081
• Make weave related task thread count configurable 3103
• Report Cluster Ids in Kafka Metrics 3054

Fixes

• Properly handle exceptions thrown from the normalizer flow 3037
• Resolve Micronaut duplicate transactions/lost custom attributes issues 3085

IAST

• Bump CSEC agent version to v1.8.0 3065 Changelog: https://github.com/newrelic/csec-java-agent/releases#release-1.8.0

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.

새로운 기능 및 개선 사항

• log4j-2.11 모듈에서 연결 메타데이터 blob @NewFields 을(를) 제거했습니다 2917
• lettuce-6.0 및 lettuce-6.5 모듈에서 클러스터 모드에 대한 지원을 추가했습니다 2922
• Vert.x를 위한 새로운 계측 모듈을 추가했습니다 웹 및 코어 5.x 2920
• 구형 포인트 컷을 대체하기 위해 새로운 자바 Server Faces 계측 모듈을 추가했습니다 2944
• 구형 포인트 컷을 대체하기 위해 새로운 Portlet 모듈을 추가했습니다 2953
• 섀도우 플러그인을 com.github.johnrengelman 에서 com.gradleup (으)로 마이그레이션했습니다 2945
• HandlerMethodInvoker3PointCut 포인트컷을 위한 위브 클래스 계측 대체를 추가했습니다 2967
• jdbc-generic 모듈에서 @NewField 어노테이션을 제거했습니다 2963
• HandlerMethodInvokerPointCut 포인트컷을 제거했습니다 2977
• SpringPointCut 포인트 컷을 제거했습니다 2990
• 모든 외부 HTTP 스팬에 새로운 http.request.method 속성을 추가했습니다 2985 3010
• (자바 에이전트에서 구성된 대로) APM 레이블로 JFR 데이터를 데코레이팅하기 위한 지원을 추가했습니다 3007
• [하이브리드 에이전트] 연결 응답의 otlp_resource_attributes (으)로 OpenTelemetry 차원 메트릭을 데코레이트했습니다 2956

수정 사항

• apache-log4j-2.11 module 에서 MDC 누수 문제를 수정했습니다 2926
• java.rmi 네임스페이스 예외를 제거했습니다 2932
• wildfly-27 모듈에서 Jakarta 서블릿 예외 속성을 사용했습니다 2929
• 파일 파이프가 기록되지 않은 경우 이제 Serverless 모드에서 페이로드를 콘솔로 전송합니다 2975
• ForceRestartException 로그를 INFO (으)로 변경했습니다 2989
• 섀도우 처리된 jspecify 라이브러리 @NullMarked 클래스에서 문제가 되는 enum 값을 제거하기 위해 새로운 빌드 타임 Patcher 인스턴스를 추가했습니다 2982
• Netty Reactor HTTP 호출에 대한 세그먼트 인스턴스를 정리했습니다 3004
• 일부 비동기 작업 중 트랜잭션 연결 메타데이터를 수정했습니다 3006

최신 버전으로 업데이트

현재 사용 중인 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 에 이러한 새 줄을 추가해야 합니다.

지지 성명:

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

새로운 기능 및 개선 사항

• 기본 yaml에 log_level_denylist 구성 추가 2830

• Solr 9 JMX 모듈 2821

• LLM 응답에서 토큰 수를 수집하기 위한 새로운 중앙 집중식 토큰 카운팅 전략. 2837

• JDBC 일괄 작업 캡처 지원, 특히 addBatch() 및 executeBatch() 메서드. 2840

• 구형 point cut을 대체하는 XML RPC 계측 모듈 2841

• 새로운 JFR 전용 구성 jfr.use_display_name을(를) 추가합니다. true로 설정된 경우, 에이전트는 JFR 호스트 이름을 process_host.display_name 설정의 값으로 설정합니다. 기존 동작을 유지하기 위해 기본값은 false입니다.

jfr.use_display_name이 true이지만 display_name 설정이 비어 있는 경우, JfrService는 호스트 이름에 대해 이전 동작으로 폴백합니다.

common: &default_settings
  jfr:
    use_display_name: true

2,847

• java.xmlrpc 모듈에서 불필요한 세그먼트 생성 제거 2853

• 각 모델에 대한 새로운 토큰 계산 전략으로 aws-bedrock-runtime-2.20 모듈을 업데이트합니다. 2845

• 새로운 라이선스 키 난독화 알고리즘 2864

• Micronaut Http 클라이언트 버전 3.5.0 이상 지원 2834

• 아파치 Camel 3.9.0 이상 지원 2896 2901

• Kafka 클라이언트 4.0.0 이상 지원 2896

• 내부 종속성 Log4j Core 2.17.1에서 2.25.4로 업그레이드 2833

• 2.0.0부터 최신 버전까지 AWS DAX 지원 2873

• 버전 1.0.0 이상의 Spring AI completion 및 embedding 클라이언트에 대한 계측을 추가합니다. 새로운 계측 모듈을 추가합니다:

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

2,842

• 코어 트레이싱 - SpanEvents 삭제 및 삭제된 SpanLinks 상위 재지정 2881

• 포인트컷 대체

  • SpringDispatcherPointCut 및 SpringExceptionHandlerPointCut을 제거하고 대신 해당 기능을 당사의 Spring 계측 모듈로 이동합니다.
  • HandlerInterceptorPointCut 교체 2871 2886

• Micronaut의 BlockingHttpClient 지원 2860

• 최신 버전에 AI 모델 컨텍스트 프로토콜 1.0.0 지원을 추가합니다. 2880

수정 사항

• 코루틴 계측 수정. 수정 사항에는 다음이 포함됩니다:

  • 실행이 다른 스레드로 이동할 수 있는 곳에서 발견된 간극을 계측하여 비동기 동작을 더 잘 추적합니다.
  • Coroutines 및 Continuations에 대한 더 나은 명명. 기존 네이밍은 너무 일반적이었습니다. 새로운 명명은 runBlocking, async, withContext 또는 출시를 통해 시작되었는지 여부에 따라 식별합니다.
  • 더 이상 사용되지 않는 일부 유틸리티 메서드를 제거했습니다 2802

• Micronaut이 계측된 경우 만료되지 않은 비동기 토큰이 과도하게 발생하는 문제를 수정합니다. 2792

• Mule 4.9 IllegalAccessError 해결 2859

• Core Tracing의 계측된 및 유지된 메트릭이 원래 시간 메트릭으로 잘못 기록되던 문제를 수정했습니다. 2881

최신 버전으로 업데이트

현재 사용 중인 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 에 이러한 새 줄을 추가해야 합니다.

지지 성명:

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

새로운 기능 및 개선 사항

• 자바 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 에 이러한 새 줄을 추가해야 합니다.

지지 성명:

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