Node.js agent release notesRSS

Notes

⚠ BREAKING CHANGES

This version of the Node.js agent is a SemVer MAJOR update and contains the following breaking changes. MAJOR versions may drop support for language runtimes that have reached End-of-Life according to the maintainer. Additionally, MAJOR versions may drop support for and remove certain instrumentation. For more details on these changes please see the migration guide.

• Dropped support for Node.js 20
• Migrated @apollo/sever instrumentation from a plugin(@newrelic/apollo-server-plugin) to traditional instrumentation
• Removed Cross Application Tracing(CAT) functionality
• Removed support for License, Application, and Security Policies(LASP)
• Removed instrumentation for koa-route
• Removed instrumentation for koa-router
• Removed shim.prefixRouteParameters as the logic was previously moved to when a transaction ends
• Removed creating MySQL Pool#query segments
• Removed shim.argsToArray
• Updated minimum supported version of @nestjs/cli and @nestjs/core to 10.0.0
• Updated minimum supported version of next to 14
• Updated minimum supported version of bluebird to 3.0.0
• Updated minimum supported version of mysql2 to 3.0.0
• Updated minimum supported version for cassandra-driver to 4.0.0
• Dropped support for fastify 3.x
• Updated config.distributed_tracing.exclude_newrelic_header to be set to true by default

Features

• Dropped support for fastify 3.x (#3980) (720979b)
• Dropped support for Node.js 20 (#3980) (5306223)
• Migrated @apollo/sever instrumentation from a plugin(@newrelic/apollo-server-plugin) to traditional instrumentation (#3980) (736e0a4)
• Removed shim.argsToArray (#3980) (9183d29)
• Removed shim.prefixRouteParameters as the logic was previously moved to when a transaction ends (#3980) (9f1408e)
• Removed creating MySQL Pool#query segments (#3980) (1d5a6dd)
• Removed Cross Application Tracing(CAT) functionality (#3980) (a87ed4d)
• Removed instrumentation for koa-route (#3980) (40c10d9)
• Removed instrumentation for koa-router (#3980) (038ecc7)
• Removed support for License, Application, and Security Policies(LASP) (#3980) (bc09485)
• Updated config.distributed_tracing.exclude_newrelic_header to be set to true by default (#3980) (774ce08)
• Updated minimum supported version for cassandra-driver to 4.0.0 (#3980) (419337a)
• Updated minimum supported version of @nestjs/cli and @nestjs/core to 10.0.0 (#3980) (120e6de)
• Updated minimum supported version of bluebird to 3.0.0 (#3980) (369f920)
• Updated minimum supported version of mysql2 to 3.0.0 (#3980) (2861406)
• Updated minimum supported version of next to 14 (#3980) (80c5c0c)

Code refactoring

• Updated how exclusive time and trace total time is calculated (#3980) (b227ed6)
• Updated instances of tracer.bindFunction with tracer.runInContext to improve performance in hot paths (#3811) (5d77085)

Documentation

• Updated compatibility report (#3990) (f3bb380)

Miscellaneous chores

• Removed husky in lieu of git hooks, added security hardened options to npm install (#3988) (e3a7dda)
• Updated production dependencies to the latest (#3996) (b710bac)

Tests

• Added minSupported to the nest js versioned tests package.json to ensure the compatibility report will show we support @nestjs/core (#3982) (bfa4aa1)
• Added prisma 7 tests (#3980) (116ee9c)
• Moved versioned test runner code from @newrelic/test-utilties to agent (#3980) (d4f9a0c)
• Removed @newrelic/test-utilities (#3980) (1751147)
• Decrease smoke-like esm tests' sample size (#3986) (40669fb)
• Fixed test/lib/get-package-version.js (#3993) (5d31f08)
• Fixed version lookup issue in aws-sdk-v3 tests (#3992) (7be3f4a)
• Restructure aws-sdk-v3 test runner to use groupedDependencies (#3984) (fc67490)
• Updated a few versioned test stanzas to reduce the number of combinations it runs (#3991) (d606305)

Continuous integration

• Added contents: write to post-release to allow commit/push of api docs (#3978) (90c4e61)
• Updated remaining actions so they are running on Node 24 (#3980) (ea21934)
• Updated version of actions/download-artifact to v8 (#3980) (54a58b9)
• Updated versions of actions to ensure they are running on node 24 (#3980) (6302002)

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

특징

• 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/)

Notes

특징

• @anthropic-ai/sdk 에 대한 계측 지원 추가 (#3881) (e8713bb)
• OTel DB 속성을 의미 체계 규칙 1.40.0의 안정적인 이름으로 업데이트했습니다 (#3826) (6d3000d)
• SNS에 분산 추적 전파 추가 (#3893) (8fc1144)

코드 리팩토링

• 발생한 이벤트를 구독하도록 @aws-sdk v3 계측을 리팩터링합니다.

  • @aws-sdk/smithy-client 구독자 추가(#3877) (0e350fc)
  • AWS Bedrock 미들웨어와 함께 @smithy/smithy-client send 구독자를 추가했습니다 (#3864) (5e0a6d1)
  • 일반 AWS Client 미들웨어를 구독자로 이동했습니다 (#3889) (3cb1e1b)
  • aws-sdk/dynamodb 계측을 구독자 미들웨어로 업데이트했습니다 (#3891) (ff677a2)
  • 실제 래핑된 미들웨어에서 bedrock 유틸리티를 분리하도록 AWS SDK v3 계측을 업데이트했습니다(#3883) (eed340e)
  • Lambda 계측을 구독자 미들웨어로 업데이트했습니다(#3890) (12f8284)
  • SNS 계측을 구독자 유형으로 리팩터링(#3876) (b9f3326)
  • SQS 계측을 구독자 유형으로 리팩터링 (#3880) (de46dee)

• 공급업체별 서브클래스를 사용하도록 LlmErrorMessage 을(를) 리팩터링했습니다(#3882) (5b0fd2b)

• 메시지 브로커 상수를 사용하도록 amqplib 리팩터링(#3879) (77621fb)

선적 서류 비치

• 업데이트된 호환성 보고서 (#3874) (ae887c4)

잡일

• @apm-js-collab/tracing-hooks 을(를) 0.6.0 (으)로 업데이트했습니다 (#3884) (f6ef470)
• 버전 8을 다루도록 Undici 테스트 업데이트 (#3896) (f27e75f)

지지 성명:

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