Node.js agent release notesRSS

Notes

Features

• Added support for native Next.js OTEL instrumentation via the Hybrid Agent (#4040) (1944f39)

Bug fixes

• Updated label parser to handle empty values in an object key (#4004) (73c00d7)

Code refactoring

• Migrate @hapi/hapi and @hapi/vision to subscriber-based (#3995) (54c60a8)
• Refactored koa instrumentation to subscribe to events emitted (#4016) (e1f6c27)
• Updated MiddlewareWrapper maybeHandleError to only mark error as handled if there was a previously stored error (#4032) (1b21cc8)

Documentation

• Removed linked to @newrelic/apollo-server-plugin as instrumentation was merged into agent (#4003) (9afd9cb)
• Moved apollo-server docs to the docs website (#3994) (11ca2ae)
• Updated compatibility report (#4028) (b16ad6e) (#4014) (3efa1ff) (#4002) (33a8236)

Miscellaneous chores

• Deprecate instrumentLoadedModule API (#4034) (306ff86)
• Added audit logging for OTEL metrics (#4018) (494c836)
• Added OTEL rule to support Prisma 7 (#4013) (c142c60)
• Fix ordering of OTEL rules (#4025) (150476a)
• Refactored OTEL transform rules (#3999) (48ff739)
• Fixed node-version in CI workflow (#4042) (dd05ea9)
• Updated codecov action (#4039) (31b9c84)
• Updated remote-method to use audit method of logger (#4038) (0e4507e)
• Added baseline instructions for Claude bot (#4036) (c8f6649)
• Updated dependencies
  • Removed unused dev dependencies (#4005) (e00f7d3)
  • Updated @apm-js-collab/tracing-hooks to 0.9.1 (#4043) (f05e5d4)
  • Updated commander to latest (#4021) (83b1d58)
  • Updated nock to latest (#4022) (9bf79ab)
  • Updated sinon to latest (#4020) (0ced304)
  • Updated protobufjs to latest (#4006) (45c61f3)
  • Upgraded glob to 13 (#4008) (3053545)
  • Upgraded got and rimraf to latest (#4007) (b967593)

Tests

• Add stable http.request shim so AWS test agent setup works with smithy >=4.7.3 (#4010) (c5fd80a)
• Added an undici versioned test to assert behavior with using a self signed cert and undici.Agent (#4026) (27507bc)
• Refactor mongodb-esm tests to test >=4.1.4 (#4023) (d85767f)
• Removed reliance on glob in lieu of fs.glob (#4019) (204f124)
• Updated undici.Agent versioned test to skip using custom dispatcher on versions <5.2.0 as it was not supported (#4029) (08cd079)

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

⚠ 주요 변경 사항

이 버전의 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/)

Notes

버그 수정

• once 을(를) 구독하는 이벤트 핸들러 누수를 방지하도록 child_process 계측을 수정했습니다 (#3907) (ad0b1f6)

선적 서류 비치

• 업데이트된 호환성 보고서(#3897) (0ed2202)

지지 성명:

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 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

버그 수정

• AWS SDK 메시지 속성 존재 여부 감지 수정 (#3903) (e81dc61)

테스트

• Anthropic 버전별 테스트를 위해 minAgentVersion 업데이트 (#3900) (e1f6c32)
• AWS 버전 지정 테스트에서 테스트 유틸리티를 재구성했습니다(#3895)(3025571)

지지 성명:

최신 에이전트 버전이 출시되면 즉시 업데이트하는 것이 좋습니다. 최신 버전으로 업그레이드할 수 없는 경우, 에이전트를 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/)