• /
  • EnglishEspañolFrançais日本語한국어Português
  • 로그인지금 시작하기

Java agent release notesRSS

May 28
Java agent v9.3.0

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

새로운 기능 및 개선 사항

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

지지 성명:

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

April 8
Java agent v9.2.0

새로운 기능 및 개선 사항

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

지지 성명:

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

February 12
Java agent v9.1.0

새로운 기능 및 개선 사항

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

지지 성명:

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

January 14
Java agent v9.0.0

새로운 기능 및 개선 사항

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

지지 성명:

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

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 에이전트 버전을 식별하려면 java -jar newrelic.jar -v 을 실행합니다. Java 에이전트 버전이 콘솔에 인쇄됩니다.

그런 다음 최신 Java 에이전트 버전으로 업데이트하려면 다음을 수행합니다.

  1. 전체 Java 에이전트 루트 디렉터리 를 다른 위치에 백업합니다. 해당 디렉토리의 이름을 NewRelic_Agent#.#.# 으로 바꿉니다. 여기서 #.#.# 은 에이전트 버전 번호입니다.
  2. 에이전트를 다운로드하세요.
  3. 새 에이전트 다운로드 파일의 압축을 푼 다음 newrelic-api.jarnewrelic.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 에 이러한 새 줄을 추가해야 합니다.

지지 성명:

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

Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.