Java agent release notesRSS

New features and improvements

• Add config to delete stale agent temp jars on startup by @jtduffy in 2676
• Add "inclusion" option to compliment the exclude configuration for selectively instrumenting applications @jtduffy in 2638
  • To use this feature, set the environment variable NEW_RELIC_STARTUP_JAVA_ARTIFACT_INCLUDES or system property newrelic.config.startup_java_artifact_includes. Specify the artifacts that should be instrumented as a comma-separated list.

Fixes

• Resolve IllegalAccessError by moving wrapper class out of S3AsyncClient_Instrumentation by @jtduffy in 2503
• Fix mislabeled instrumentation version on log events in logback-classic-1.5.20 by @jasonjkeller in 2594
• Fixed logging message for max attribute value by @jeffalder in 2680
• Corrected Trace Ratio sampler priorities by @jtduffy in 2583

Removals

• Removes deprecated jdbc-inet-* modules by @obenkenobi in 2572
• Removes deprecated java.completable-future-jdk8 instrumentation by @obenkenobi in 2562
• Removes aws wrap instrumentation by @obenkenobi in 2567
• Removes jdbc-sybase-6 module by @obenkenobi in 2614
• Removes play 2.3 instrumentation by @obenkenobi in 2568
• Removes deprecated thrift-0.8 module by @obenkenobi in 2569
• Removes deprecated solr 4.0 & 5.0 modules by @obenkenobi in 2570
• Removes deprecated module grails-1.3 by @obenkenobi in 2573
• Removes deprecated module hibernate-3.3 by @obenkenobi in 2574
• Removes deprecated footer injection API by @sharvath-newrelic in 2620
• Removes deprecated Struts 1 pointcuts by @obenkenobi in 2561
• Removes deprecated module glassfish-3 by @sharvath-newrelic in 2575
• Removes deprecated rabbit-amqp modules 2.5.0, 2.4.1, 1.7.2 by @obenkenobi in 2571
• Removes deployment marker function by @jtduffy in 2589

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.

수정 사항

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

지지 성명:

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

새로운 기능 및 개선 사항

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

지지 성명:

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

새로운 기능 및 개선 사항

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

지지 성명:

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