Java agent release notes | New Relic Documentation

November 12, 2025

Java agent v8.25.0

이 에이전트 버전을 다운로드하세요

새로운 기능 및 개선 사항

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

에이전트 구성 차이점 업데이트

에이전트의 새 버전을 출시할 때 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 에 이러한 새 줄을 추가해야 합니다.

지지 성명:

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

September 3, 2025

Java agent v8.24.0

이 에이전트 버전을 다운로드하세요

새로운 기능 및 개선 사항

@obenkenobi가 2465년에 MongoDB Reactive Streams 5.2.0 이상을 지원했습니다.
@kanderson250이 2466년에 Jedis 6을 지원했습니다.

수정 사항

CouchBase: 이중 측정을 방지하기 위해 건너뛰기 클래스 추가, 2462에서 @jtduffy 작성
Spring WebClient 5.x: @jtduffy가 2464년에 작성한 전체 응답 대신 헤더만 래핑

사용 중단

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

에이전트 구성 차이점 업데이트

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

지지 성명:

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

August 13, 2025

Java agent v8.23.0

이 에이전트 버전을 다운로드하세요

새로운 기능 및 개선 사항

@jtduffy가 2425년에 graphql v24를 지원하기 위해 업데이트했습니다.
양상추 6.5 측정 추가, 2430년 @kanderson250 작성
@jtduffy가 2421년에 commons-lang 버전을 3.18.0으로 올렸습니다.
@kanderson250이 2423에 데이터스토어 매개변수에 lettuce dbName을 추가했습니다.
특정 애플리케이션 구현을 건너뛰려면 환경 변수를 추가합니다. 환경 변수 이름은 NEW_RELIC_STARTUP_JAVA_ARTIFACT_SKIPS 입니다. 그 값은 에이전트가 측정해서는 안 되는 주요 클래스, 실행 가능한 jar 파일 또는 יושי 기반 도구/앱의 쉼표로 구분된 목록입니다(예: NEW_RELIC_STARTUP_JAVA_ARTIFACT_SKIPS=keytool,myapp.jar,IgnoreThisClass) @jtduffy가 2433에 게시함

수정 사항

8개의 속성이 있는 SQS 메시지가 AWS로 전송되지 않는 버그를 수정했습니다. SQS 메시지는 2422년에 @obenkenobi에 의한 수출 트레이스 헤더를 전달하기 위해 8개 미만의 속성이 필요합니다.
@jbedell-newrelic가 2440년에 Azure Service Bus 클라이언트에서 토픽 이름 끝의 "구독" 비트를 잘라냈습니다.
@jasonjkeller가 2451년에 AutoConfiguredOpenTelemetrySdk 구성을 수정했습니다.

사용 중단

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

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

에이전트 구성 차이점 업데이트

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

지지 성명:

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

July 9, 2025

Java agent v8.22.0

이 에이전트 버전을 다운로드하세요

새로운 기능 및 개선 사항

Azure 서비스버스 7.15.0 측정, 도구, 작성자: @jbedell-newrelic, 2384
@jbedell-newrelic가 2399년에 Azure App Services에 대한 메타데이터 연결
@jtduffy가 2377년에 연결 오류를 SEVERE로 보고했습니다.
2388년@jtduffy에 의해 로그인 및 이벤트에 속성으로 추가된 유효하지 않은 키를 로그인 및 난독화합니다.

수정 사항

@meiao가 2383년에 IntelliJ 주석 라이브러리를 이전했습니다.
@jtduffy가 2386년에 서버 측 sampling_target 설정을 지원했습니다.
2400에서 @deleonenriqueta에 의한 잠재적인 메모리 누수를 수정하기 위해 MonoFlatMapMain 측정, 로그를 제거합니다.

사용 중단

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

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

에이전트 구성 차이점 업데이트

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

지지 성명:

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

May 29, 2025

Java agent v8.21.0

주의

알려진 문제: 이 릴리스에는 Netty Reactor의 특정 사용과 관련하여 메모리 누수를 일으킬 수 있는 알려진 문제가 있습니다. 다른 버전을 사용해 보시기 바랍니다.

이 에이전트 버전을 다운로드하세요

새로운 기능 및 개선 사항

Reactor Mono.flatMap 호출 2308에 대한 가시성을 향상시킵니다.
핵심 Kafka 클라이언트 라이브러리 2312를 사용할 때 Spring-Kafka에 대한 새로운 측정, 수신 및 수신을 추가합니다.
Kafka 3.7+ 2358에 대한 KafkaConsumerConfig 이벤트 지원을 추가합니다.

수정 사항

distributed_tracing.sampler 구성 2330을수정합니다.
Scala 2.12 및 JDK 11을 사용할 때 발생할 수 있는 불법 액세스 오류를 수정합니다. 에이전트가 Scala 2.12를 감지할 수 없는 경우(이를 위해 시스템 클래스 로더를 확인합니다. 특히 sbt는 Scala 클래스를 사용자 정의 Scala 로더에 로드합니다) 시스템 속성 -Dnewrelic.config.class_transformer.illegal_access_fix=true 2334를통해 수동으로 수정을 활성화하는 기능 플래그도 있습니다.
Netty '알 수 없음' 트랜잭션 2274 2355수정
- 이 수정 사항은 이전의 Netty 측정 및 계측 변경 사항을 기능 플래그 뒤로 옮겨서 HTTP2 트랜잭션과 관련된 일부 경우에 추가 가시성을 제공합니다. 이 세분성을 다시 활성화하려면(알 수 없는 거래가 표시될 수 있는 가능성이 있음) 다음 구성 설정을 사용하세요.
```
netty:
    http2:
      frame_read_listener:
        start_transaction: true
```
- 8.20의 에이전트 구성에 논리 오류가 있으므로 해당 수정 사항은 에이전트 버전 8.21 이상에서만 공식적으로 적용됩니다.
SQS 메시지에 대한 분산 트레이스 헤더를 추가하는 시기에 대한 제한을 추가합니다. 이는 메시지 내용의 바이트 크기와 속성 크기에 따라 결정됩니다. 크기가 251KB보다 크거나 속성이 9개 이상인 메시지는 분산 트레이스 헤더 추가에서 제외됩니다 . 2353
고객 환경과의 충돌을 방지하기 위해 org.crac JAR을 숨길 수 있습니다. 2344
PR #1927에서 NullPointerExceptions 이 이전 버전의 vertx-core 측정으로 이동하는 것을 방지하기 위해 백포트 변경 사항을 적용했습니다. 계측 2327
HttpUrlConnection 메서드 호출로 인해 과도한 트랜잭션 세그먼트가 생성되는 것을 방지합니다(예: getInputStream) 외부 호출과 연관되지 않은 경우. 이 동작은 다음 구성 옵션으로 제어할 수 있습니다: NEW_RELIC_CLASS_TRANSFORMER_COM_NEWRELIC_INSTRUMENTATION_HTTPURLCONNECTION_VERBOSE=false, sys prop -Dnewrelic.config.class_transformer.com.newrelic.instrumentation.httpurlconnection.verbose=false 또는 newrelic.yml 의 동등한 절. 기본 설정은 true 입니다(즉 외부가 아닌 getInputStream 및 기타 응답 처리기 메서드는 이전과 같이 보고됩니다. 2365

보안

무한 추적 2339로 보안을 강화하기 위해 com.newrelic.agent.java:infinite-tracing-protobuf 을 업그레이드합니다.
보안 취약점 2333을해결하기 위해 snakeyaml com.konloch:safeyaml 로 바꿉니다.

사용 중단

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

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

IAST

CSEC 버전 1.7.0 2348 업데이트 변경 사항: https://github.com/newrelic/csec-java-agent/releases/tag/1.7.0

에이전트 구성 차이점 업데이트

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

지지 성명:

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

Java agent release notesRSS

새로운 기능 및 개선 사항

수정 사항

사용 중단

최신 버전으로 업데이트

에이전트 구성 차이점 업데이트

지지 성명:

새로운 기능 및 개선 사항

수정 사항

사용 중단

최신 버전으로 업데이트

에이전트 구성 차이점 업데이트

지지 성명:

새로운 기능 및 개선 사항

수정 사항

사용 중단

최신 버전으로 업데이트

에이전트 구성 차이점 업데이트

지지 성명:

새로운 기능 및 개선 사항

수정 사항

사용 중단

최신 버전으로 업데이트

에이전트 구성 차이점 업데이트

지지 성명:

주의

새로운 기능 및 개선 사항

수정 사항

보안

사용 중단

IAST

최신 버전으로 업데이트

에이전트 구성 차이점 업데이트

지지 성명:

새로운 기능 및 개선 사항.css-21sua1{background:none;border:none;width:0;padding:0;}

수정 사항

사용 중단

최신 버전으로 업데이트

에이전트 구성 차이점 업데이트

지지 성명:

새로운 기능 및 개선 사항

수정 사항

사용 중단

최신 버전으로 업데이트

에이전트 구성 차이점 업데이트

지지 성명:

새로운 기능 및 개선 사항

수정 사항

사용 중단

최신 버전으로 업데이트

에이전트 구성 차이점 업데이트

지지 성명:

새로운 기능 및 개선 사항

수정 사항

사용 중단

최신 버전으로 업데이트

에이전트 구성 차이점 업데이트

지지 성명:

주의

새로운 기능 및 개선 사항

수정 사항

보안

사용 중단

IAST

최신 버전으로 업데이트

에이전트 구성 차이점 업데이트

지지 성명:

새로운 기능 및 개선 사항