Node.js agent release notesRSS

Bug fixes

Fixed Azure functions crashing when they include response headers (#4070) (c88d2b7)

Documentation

Updated compatibility report (#4067) (0ae24b8)

Support statement

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date.

See the New Relic Node.js agent EOL policy for information about agent releases and support dates.

Notes

Documentation

• Removed outdated Next.js documentation in repo (#4060) (185bb66)
• Updated compatibility report (#4047) (25cbd38)

Miscellaneous chores

• Added proxy config support to OTEL metrics (#4041) (6c04b8a)
• Added supportability metrics to OTEL metrics export (#4051) (db6e4e3)
• Updated min version of @opentelemetry 0.x packages to ^0.219.0 (#4065) (3f58ad0)

Support statement:

We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

See the New Relic Node.js agent EOL policy for information about agent releases and support dates. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

특징

• 하이브리드 에이전트를 통한 네이티브 Next.js OTEL 계측 지원을 추가했습니다(#4040) (1944f39)

버그 수정

• 객체 키의 빈 값을 처리하도록 레이블 파서를 업데이트했습니다 (#4004) (73c00d7)

코드 리팩토링

• @hapi/hapi 및 @hapi/vision 을(를) 구독자 기반으로 마이그레이션 (#3995) (54c60a8)
• 발생한 이벤트를 구독하도록 koa 계측을 리팩터링했습니다 (#4016) (e1f6c27)
• 이전에 저장된 오류가 있는 경우에만 오류를 처리된 것으로 표시하도록 MiddlewareWrapper maybeHandleError 을(를) 업데이트했습니다 (#4032) (1b21cc8)

선적 서류 비치

• 계측이 에이전트에 병합됨에 따라 @newrelic/apollo-server-plugin 에 대한 링크를 제거했습니다 (#4003) (9afd9cb)
• apollo-server 문서를 문서 웹사이트로 이동했습니다 (#3994) (11ca2ae)
• 호환성 보고서 업데이트 (#4028) (b16ad6e) (#4014) (3efa1ff) (#4002) (33a8236)

잡일

• instrumentLoadedModule API 사용 중단 (#4034) (306ff86)

• OTEL 메트릭에 대한 감사 로깅 추가 (#4018) (494c836)

• Prisma 7을 지원하는 OTEL 규칙을 추가했습니다 (#4013) (c142c60)

• OTEL 규칙 순서 수정 (#4025) (150476a)

• OTEL 변환 규칙 리팩터링 (#3999) (48ff739)

• CI 워크플로우에서 node-version 수정 (#4042) (dd05ea9)

• codecov action 업데이트 (#4039) (31b9c84)

• 로거의 audit 메서드를 사용하도록 remote-method 업데이트 (#4038) (0e4507e)

• Claude 봇에 대한 기준 지침을 추가했습니다 (#4036) (c8f6649)

• 업데이트된 종속성

  • 사용하지 않는 개발 종속성 제거(#4005) (e00f7d3)
  • @apm-js-collab/tracing-hooks 을(를) 0.9.1 (으)로 업데이트했습니다 (#4043) (f05e5d4)
  • commander 을(를) 최신 버전으로 업데이트했습니다 (#4021) (83b1d58)
  • nock 을(를) 최신 버전으로 업데이트했습니다 (#4022) (9bf79ab)
  • sinon 을(를) 최신 버전으로 업데이트했습니다 (#4020) (0ced304)
  • protobufjs 을(를) 최신 버전으로 업데이트했습니다 (#4006) (45c61f3)
  • glob 을(를) 13으로 업그레이드했습니다 (#4008) (3053545)
  • got 및 rimraf 을(를) 최신 버전으로 업그레이드했습니다 (#4007) (b967593)

테스트

• AWS 테스트 에이전트 설정이 smithy >=4.7.3에서 작동하도록 안정적인 http.request shim 추가 (#4010) (c5fd80a)
• 자체 서명된 인증서 및 undici.Agent 사용 시 동작을 확인하는 undici 버전 테스트를 추가했습니다 (#4026) (27507bc)
• >=4.1.4 을(를) 테스트하도록 mongodb-esm 테스트 리팩터링 (#4023) (d85767f)
• glob 에 대한 의존성을 제거하고 fs.glob (으)로 대체했습니다 (#4019) (204f124)
• 버전 <5.2.0에서는 지원되지 않으므로 사용자 지정 디스패처 사용을 건너뛰도록 undici.Agent 버전별 테스트를 업데이트했습니다 (#4029) (08cd079)

지지 성명:

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 Node.js 에이전트 EOL 정책을 참조하세요. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

⚠ 주요 변경 사항

이 버전의 Node.js 에이전트는 SemVer 주요 업데이트이며 다음과 같은 중요한 변경 사항이 포함되어 있습니다. 관리자에 따르면 주요 버전은 사용 수명이 종료된 언어 런타임에 대한 지원을 중단할 수 있습니다. 또한 주요 버전에서는 특정 측정, 계측에 대한 지원이 중단되거나 제거될 수 있습니다. 이러한 변경 사항에 대한 자세한 내용은 마이그레이션 가이드를 참조하세요.

• Node.js 20 지원 중단
• @apollo/sever 계측을 플러그인(@newrelic/apollo-server-plugin)에서 기존 계측으로 마이그레이션했습니다
• 크로스 애플리케이션 추적(CAT) 기능 제거
• 라이선스, 애플리케이션 및 보안 정책(LASP) 지원 제거
• -에 대한 계측 제거 koa-route
• -에 대한 계측 제거 koa-router
• 로직이 이전에 트랜잭션이 종료될 때로 이동되었으므로 shim.prefixRouteParameters 을(를) 제거했습니다.
• MySQL Pool#query 세그먼트 생성 제거됨
• 제거됨 shim.argsToArray
• @nestjs/cli 및 @nestjs/core 의 최소 지원 버전을 다음으로 업데이트했습니다. 10.0.0
• next 의 최소 지원 버전을 14로 업데이트했습니다
• bluebird 의 최소 지원 버전을 다음으로 업데이트 3.0.0
• mysql2 의 최소 지원 버전을 다음으로 업데이트 3.0.0
• cassandra-driver 의 최소 지원 버전을 다음으로 업데이트 4.0.0
• fastify 3.x에 대한 지원을 중단했습니다.
• config.distributed_tracing.exclude_newrelic_header 이(가) 기본적으로 true (으)로 설정되도록 업데이트되었습니다.

특징

• fastify 3.x 지원 중단 (#3980) (720979b)
• Node.js 20 지원 중단 (#3980) (5306223)
• @apollo/sever 계측을 플러그인(@newrelic/apollo-server-plugin)에서 기존 계측으로 마이그레이션했습니다 (#3980) (736e0a4)
• shim.argsToArray 제거 (#3980) (9183d29)
• 로직이 이전에 트랜잭션이 종료될 때로 이동되었으므로 shim.prefixRouteParameters 을(를) 제거했습니다(#3980)(9f1408e)
• MySQL Pool#query 세그먼트 생성 제거 (#3980) (1d5a6dd)
• 크로스 애플리케이션 추적(CAT) 기능을 제거했습니다 (#3980) (a87ed4d)
• koa-route 에 대한 계측 제거 (#3980) (40c10d9)
• koa-router 에 대한 계측을 제거했습니다 (#3980) (038ecc7)
• 라이선스, 애플리케이션 및 보안 정책(LASP) 지원 제거(#3980) (bc09485)
• 기본적으로 true (으)로 설정되도록 config.distributed_tracing.exclude_newrelic_header 을(를) 업데이트했습니다 (#3980) (774ce08)
• cassandra-driver 의 최소 지원 버전을 4.0.0 (으)로 업데이트했습니다 (#3980) (419337a)
• @nestjs/cli 및 @nestjs/core 의 최소 지원 버전을 10.0.0 (으)로 업데이트했습니다 (#3980) (120e6de)
• bluebird 의 최소 지원 버전을 3.0.0 (으)로 업데이트했습니다 (#3980) (369f920)
• mysql2 의 최소 지원 버전을 3.0.0 (으)로 업데이트했습니다 (#3980) (2861406)
• next 의 최소 지원 버전을 14로 업데이트했습니다 (#3980) (80c5c0c)

코드 리팩토링

• 독점 시간 및 트레이스 총 시간이 계산되는 방식을 업데이트했습니다 (#3980) (b227ed6)
• 핫 패스에서 성능을 개선하기 위해 tracer.bindFunction 의 인스턴스를 tracer.runInContext (으)로 업데이트했습니다 (#3811) (5d77085)

선적 서류 비치

• 호환성 보고서 업데이트 (#3990) (f3bb380)

잡일

• git hooks로 대체하여 husky 을(를) 제거하고, npm install 에 보안 강화 옵션을 추가했습니다 (#3988) (e3a7dda)
• 프로덕션 종속성을 최신 버전으로 업데이트했습니다 (#3996) (b710bac)

테스트

• 호환성 보고서에서 @nestjs/core 을(를) 지원함을 보여주기 위해 nest js 버전 테스트 package.json에 minSupported 을(를) 추가했습니다 (#3982) (bfa4aa1)
• prisma 7 테스트 추가 (#3980) (116ee9c)
• 버전이 지정된 테스트 러너 코드를 @newrelic/test-utilties 에서 에이전트로 이동했습니다 (#3980) (d4f9a0c)
• @newrelic/test-utilities 제거 (#3980) (1751147)
• 스모크 유사 esm 테스트의 샘플 크기 감소 (#3986) (40669fb)
• test/lib/get-package-version.js 수정 (#3993) (5d31f08)
• AWS-sdk-v3 테스트에서 버전 조회 문제를 수정했습니다 (#3992) (7be3f4a)
• groupedDependencies 을(를) 사용하도록 aws-sdk-v3 테스트 러너 재구성 (#3984) (fc67490)
• 실행되는 조합 수를 줄이기 위해 몇 가지 버전이 지정된 테스트 스탠자를 업데이트했습니다 (#3991) (d606305)

통합 연결

• API 문서의 커밋/푸시를 허용하도록 post-release 에 contents: write 추가 (#3978) (90c4e61)
• Node 24에서 실행되도록 남은 액션을 업데이트했습니다 (#3980) (ea21934)
• actions/download-artifact 버전을 v8로 업데이트했습니다 (#3980) (54a58b9)
• Node 24에서 실행되도록 액션 버전 업데이트 (#3980) (6302002)

지지 성명:

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 Node.js 에이전트 EOL 정책을 참조하세요. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)

Notes

특징

• Google ADK BaseAgent.runAsync 에 대한 계측을 추가했습니다 (#3905) (c6c51d5)
• Google ADK FunctionTool.runAsync 계측하다 (#3935) (57f9ed7)
• @azure/functions 계측을 구독자 유형으로 업데이트했습니다 (#3915) (227e779)
• 로그에서 라이선스 키가 마스킹되는 방식을 업데이트했습니다 (#3945) (6289502)

버그 수정

• <3.4.0 의 파일 재구성을 처리하도록 connect 계측 쿼리를 업데이트했습니다 (#3923) (00b615c)
• 프로미스가 이행되거나 거부될 때 세그먼트를 터치하도록 tracer.bindFunction 을(를) 업데이트했습니다 (#3967) (712db61)
• @smithy/smithy-client 4.13.0+ 사용을 처리하도록 AWS SDK v3 계측을 업데이트했습니다. (#3965) (5e0fe24)

코드 리팩토링

• undici, 도메인 및 process._fatalException 계측에 대한 AsyncLocalStorage.enterWith 의존성을 제거했습니다 (#3894) (612b449)

선적 서류 비치

• 호환성 보고서 업데이트 (#3941) (214b353) (#3934) (5a962d4) (#3909) (ad6fa8a)

잡일

• max_trace_segments 에 도달할 때 로그 줄 추가 (#3933) (46b9238)
• client-dynamodb 테스트를 위해 assertSegmentDuration 주석화 (#3972) (590cd3e)
• amqplib 테스트 관련 문제 수정 (#3969) (a770000)
• Connect 계측을 구독자 유형으로 리팩터링했습니다 (#3912) (e5d87b7)
• kafkajs 계측을 구독자 유형으로 리팩터링했습니다 (#3958) (72e383c)
• memcached 테스트에서 actualTime vs segmentDuration 어서션 제거 (#3932) (98c50e0)
• @apm-js-collab/tracing-hooks 을(를) 0.7.0 (으)로 업데이트했습니다 (#3949) (5c99cd1)

테스트

• assertSegmentDuration 커스텀 어설션을 추가하고 memcached 테스트에 추가했습니다 (#3875) (b28d866)

통합 연결

• CodeQL을 충족하기 위해 모든 워크플로우에 최소 권한 모델을 적용했습니다 (#3961) (237d5b9)

지지 성명:

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 90일 이내 버전으로 업데이트하세요. 에이전트에게 최신 정보를 제공하는 방법에 대해 자세히 알아보세요. (https://docs.newrelic.com/docs/new-relic-solutions/new-relic-one/install-configure/update-new-relic-agent/)

에이전트 릴리스 및 지원 날짜에 대한 정보는 뉴렐릭 Node.js 에이전트 EOL 정책을 참조하세요. (https://docs.newrelic.com/docs/apm/agents/nodejs-agent/getting-started/nodejs-agent-eol-policy/)