Java agent release notesRSS

New features and improvements

• Adds Java 25 Support by @deleonenriqueta in 2512
• Adds support for Logback-1.5.20 by @jtduffy in 2535
• Introduces a config option to disable the execution of the call and exec SQL parser regular expressions by @jtduffy in 2490
• Adds support for Kotlin Coroutines v1.4+ by @dhilpipre in 2454
• Adds support for Kotlin Coroutines Suspend Functions generated outside of Kotlin Coroutines by @dhilpipre in 2456
• Introduces a preference config for multiple hosts during datastore detection by @jbedell-newrelic in 2508
• Adds a system property to configure the artifact skip function by @jtduffy in 2509
• Adds a configuration option allowing Spring Controller transactions to be named using the controller class name and method name by @sharvath-newrelic in 2532
• Implements SamplerConfig, centralizing all distributed_tracing.sampler configs into the SamplerConfig by @jasonjkeller in 2529
• Updates kafka-clients-spans-0.11.0.0 producer instrumentation to use modern distributed tracing API’s with W3C Trace Context support by @sharvath-newrelic in 2516

Fixes

• Fixes parsing of error class names by @sharvath-newrelic in 2497
• Fixes a potential memory issue caused by excessively large stack traces in error logging by @jtduffy in 2498
• Clarify logging messages for invalid attributes on custom events and logging events by @sharvath-newrelic in 2501

Deprecations

• 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

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

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.

새로운 기능 및 개선 사항

• @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

최신 버전으로 업데이트

현재 사용 중인 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.
>       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
...

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

지지 성명:

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

새로운 기능 및 개선 사항

• @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

최신 버전으로 업데이트

현재 사용 중인 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.
>       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
...

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

지지 성명:

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

새로운 기능 및 개선 사항

• 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

최신 버전으로 업데이트

현재 사용 중인 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.
>       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
...

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

지지 성명:

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

새로운 기능 및 개선 사항

• 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

최신 버전으로 업데이트

현재 사용 중인 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.
>       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
...

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

지지 성명:

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