Java agent release notesRSS

New features and improvements

• Adds Java 26 support 2734
• Adds Serverless mode for AWS Lambda monitoring with the Java agent 2609 2615 2625 2633 2640 2641 2647 2673 2716 2721 2735 2723 2740 2769 2782 2794 2797 2796 2806
• Adds new application_logging.forwarding.log_level_denylist config 2764
• Implements region aware event/metric ingest URIs 2749 2790 2790
• Adds support for associating logs to corresponding entity when enable_auto_app_naming is true 2627
• Add opentelemetry-sdk-extension-autoconfigure-1.59.0 instrumentation for OpenTelemetry 1.59.0+ 2786
• Adds support for associating adaptive sampler to corresponding entity when enable_auto_app_naming is true 2805
• Adds supportability metrics for each entity created when enable_auto_app_naming is true 2808
• Implements Cloud Metadata Bypass Proxy config 2791
• Adds support for multiple versions of Caffeine in the agent 2807
• Adds support for explain plans that utilize SQL arrays 2815
• Adds generic 'Queue' as a transport type 2820
• Adds support for Reactor Netty Http client calls 2817

Fixes

• Fixes an edge case where ill-formed payloads caused an NPE when accessing the sampled field on the NR payload 2762
• Expires Tokens when a Reactive Subscription is canceled 2798
• Adds logic to manually evict any dead threads from the TheadTracker cache to prevent a memory leak 2811
• Resolves a deadlock between harvest thread and JVM shutdown thread 2539

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.

새로운 기능 및 개선 사항

• 자바 하이브리드 변환기: 뉴럴릭의 심층적인 가시성과 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 에 이러한 새 줄을 추가해야 합니다.

지지 성명:

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

새로운 기능 및 개선 사항

• 2512년에 @deleonenriqueta가 25 지원을 추가했습니다.
• @jtduffy가 2535에 Logback-1.5.20에 대한 지원을 추가했습니다.
• @jtduffy가 2490년에 call 및 exec SQL 파서 정규 표현식 실행을 비활성화하는 구성 옵션을 소개합니다.
• @dhilpipre가 2454년에 Kotlin Coroutines v1.4+에 대한 지원을 추가했습니다.
• @dhilpipre가 2456년에 Kotlin Coroutines 외부에서 생성한 Kotlin Coroutines Suspend 함수에 대한 지원을 추가합니다.
• @jbedell-newrelic이 2508년에 데이터스토어를 감지하는 동안 여러 호스트에 대한 기본 설정 구성을 도입했습니다.
• @jtduffy가 2509년에 아티팩트 건너뛰기 기능을 구성하기 위한 시스템 속성을 추가합니다.
• @sharvath-newrelic이 2532년에 컨트롤러 클래스 이름과 메서드 이름을 사용하여 Spring Controller 트랜잭션의 이름을 지정할 수 있도록 하는 설정 옵션을 추가합니다.
• @jasonjkeller가 2529년에 모든 distributed_tracing.sampler 구성을 SamplerConfig 로 중앙화하여 SamplerConfig를 구현했습니다.
• 2516년@sharvath-newrelic의 W3C Trace Context 지원과 함께 현대적인 변환기 추적 API를 사용하도록 kafka-clients-spans-0.11.0.0 생산자 측정, 트랜잭션을 업데이트했습니다.

수정 사항

• 2497년@sharvath-newrelic의 오류 클래스 이름 구문 분석을 수정했습니다.
• @jtduffy가 2498년에 오류 로깅에서 지나치게 큰 스택 추적으로 인해 발생한 잠재적인 메모리 문제를 해결했습니다.
• 2501년 @sharvath-newrelic에 의한 맞춤형 대시보드 및 로깅 이벤트의 유효하지 않은 속성에 대한 로깅 메시지를 명확히 했습니다.

사용 중단

다음 측정, 계측 모듈은 더 이상 사용되지 않으며 다음 주요 릴리스에서 제거될 예정입니다.

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

지지 성명:

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