뉴렐릭 에이전트는 주요 버전 릴리스에 중대한 변경 사항이 포함되어 있음을 나타내기 위해 의미적 버전 관리를 따릅니다. 관리자에 따르면 주요 버전은 사용 수명이 종료된 언어 런타임에 대한 지원을 중단할 수 있습니다. 또한 주요 버전에서는 지원이 중단되고 특정 측정, 통계가 제거될 수 있습니다.
New Relic의 최신 기능, 향상된 기능 및 중요한 보안 패치를 최대한 활용하려면 Node.js 에이전트를 최신 버전으로 업데이트하는 것이 좋습니다. 특정 에이전트 업데이트에 대한 추가 정보는 Node.js 에이전트 릴리스 정보 를 참조하십시오. 릴리스 정보에는 해당되는 경우 다운로드 링크와 최신 버전 다운로드 및 설치 지침이 포함됩니다.
newrelic 모듈이 package.jsonnpm install 를 실행합니다.
newrelic 모듈만 타겟팅하려면 npm update newrelic 을 실행합니다.
권장 사항: 업데이트된 버전을 프로덕션으로 이동하기 전에 테스트하십시오. 문제가 있는 경우 Node.js 에이전트 문제 해결 절차를 따르세요.
에이전트를 제거하고 특정 버전의 에이전트를 설치해야 하는 경우 이 제거 가이드를 따른 다음 npm install newrelic@LIST_VERSION_HERE 을 사용하여 특정 에이전트 버전을 다시 설치하거나 package.json에서 버전을 업데이트하고 npm install 실행합니다.
Node.js 에이전트 버전 13으로 업그레이드
Node.js 버전 13으로 업그레이드하기 전에 주요 변경 사항이 있는지 이 정보를 검토하세요.
BREAKING: 기본 컨텍스트 관리자를 AsyncLocalContextManager로 업데이트했습니다.
이전 기본 LegacyContextManager는 config.feature_flag.legacy_context_manager 의 기능 플래그를 true 로 설정하여 복원할 수 있습니다.
환경 변수를 선호하는 경우 NEW_RELIC_FEATURE_FLAG_LEGACY_CONTEXT_MANAGERtrue 로 설정할 수 있습니다.
이 컨텍스트 관리자는 향후 버전에서 제거될 예정입니다. 이 레거시 컨텍스트 관리자를 다시 사용해야 하는 경우 New Relic 지원 또는 GitHub 문제를 통해 이를 제기해 주세요.
BREAKING: 이름이 shim.handleCATHeaders 에서 shim.handleMqTracingHeaders 로 변경되었습니다.
업데이트된 Node.js 버전 지원이 있는 버전으로 New Relic 종속성 업데이트
@newrelic/aws-sdk v7.0.0
@newrelic/koa v8.0.0
@newrelic/native-metrics v10.0.0
@newrelic/슈퍼에이전트 v7.0.0
@newrelic/test-utilities v8.0.0
Node.js 버전 지원
Node.js 16은 New Relic Node.js v11 에이전트가 지원하는 가장 초기 버전입니다. Node.js 14 및 15는 v11에서 지원되지 않습니다. Node.js 15 이하를 실행하는 고객에게는 두 가지 옵션이 있습니다.
지원되는 Node.js 버전으로 업그레이드하고 New Relic Node.js v11 에이전트의 새로운 기능을 활용하세요.
업데이트 에이전트 버전에서만 사용할 수 있는 새로운 기능을 사용할 수 없는 New Relic Node.js v10 에이전트를 그대로 유지하세요.
팁
가능한 한 빨리 최신 버전의 Node.js로 업그레이드하세요. New Relic Node.js 에이전트의 다음 주요 버전에서는 Node.js 16에 대한 지원이 제거될 가능성이 높습니다.
Node.js 에이전트 버전 10으로 업그레이드
Node.js 버전 10으로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.
Major changes with Node.js agent v11
Comments
동일한 확인된 moduleName에 대해 계측 다중 후크(onRequire, onResolved)를 등록하는 기능이 추가되었습니다.
이는 처음부터 에이전트의 한계였습니다.
api를 사용하여 api.instrument, api.instrumentDatastore, api.instrumentWebframework, api.instrumentMessages 또는 api.instrumentConglomerate를 계측한 경우 기존 계측 후크가 재정의됩니다.
그 결과 Node.js 에이전트가 설계된 대로 작동하지 않게 되었습니다.
BREAKING: config.transaction_tracer.record_sql 의 기본값을 꺼짐에서 난독화로 업데이트했습니다. 이는 SQL 문이 캡처되지만 난독화됨을 의미합니다.
BREAKING: 경로(URL) 모범 사례는 이제 바이올린, 루트 세그먼트 및 스팬에 request.parameters.route.* 속성으로 저장됩니다.
쿼리 매개변수는 request.parameters라는 접두사가 붙은 속성으로 제공됩니다.* 트랜잭션 및 스팬에 대해
경로 매개변수는 request.parameters.route.*라는 접두사가 붙은 속성으로 제공됩니다. 트랜잭션 및 스팬에 대해
경로 매개변수(URL 매개변수라고도 함)는 API 경로 정의의 일부로 자리 표시자를 생성할 수 있는 다양한 웹 프레임워크의 일반적인 기능입니다.
BREAKING: 대리인은 '인증서' 설정(일반적으로 프록시와 함께)을 사용할 때 더 이상 뉴렐릭 인증서 번들을 자동으로 포함하지 않습니다.
'인증서' 구성(일반적으로 프록시 사용)을 사용할 때 에이전트에는 더 이상 New Relic 인증서 번들이 포함되지 않습니다. 이로 인해 현재 환경이 손상되는 경우 Mozilla와 같은 CA 번들을 구입하는 것이 좋습니다.
BREAKING: 에이전트는 이제 사양 및 기타 에이전트를 준수하기 위해 포트 443에 외부 HTTPS 요청을 할 때 포트를 제외합니다.
기본 HTTPS 포트를 사용할 때 이전 외부 세그먼트의 이름은 External/example.com:443 입니다.
이제 외부 세그먼트의 이름이 External/example.com 입니다.
BREAKING: await_support 기능 플래그를 통해 비동기 후크 기반 약속 컨텍스트 추적을 비활성화하는 기능이 제거되었습니다. 이는 또한 구형 약속 약속을 제거합니다.
await_support 기능 플래그를 출시했습니다. 에이전트는 이제 async_hooks에 의존하여 비동기 약속 전파를 추적합니다. 최종 결과는 feature_flag.await_support 을 false로 설정한 경우 레거시 계측이 프라미스 체인의 모든 기능을 별도의 세그먼트로 추적했다는 것입니다.
BREAKING: 더 이상 사용되지 않는 oracle npm 패키지에 대한 계측이 제거되었습니다.
BREAKING: pg 의 최소 버전을 8.2.x로 업데이트했습니다. 이는 Node.js 14+에서 실행되는 최초 지원 버전입니다.
BREAKING: hapi의 최소 지원 버전을 v20.0.0으로 업데이트했습니다.
v20.0.0 미만의 모든 버전은 보안상의 이유로 hapi에서 더 이상 사용되지 않습니다. 지원 정책을 참조하십시오.
업데이트된 Node.js 버전 지원이 있는 버전으로 New Relic 종속성 업데이트
@newrelic/aws-sdk v5.0.0
@newrelic/koa v7.0.0
@newrelic/native-metrics v9.0.0
@newrelic/superagent v6.0.0
@newrelic/test-utilities v7.0.0
Node.js 버전 지원
Node.js 14는 New Relic Node.js v9 에이전트에서 지원하는 가장 초기 버전입니다. Node.js 12 및 13은 v9에서 지원되지 않습니다. Node.js 13 및 이전 버전을 실행하는 고객에게는 두 가지 옵션이 있습니다.
지원되는 Node.js 버전으로 업그레이드하고 New Relic Node.js v9 에이전트의 새로운 기능을 활용하세요.
업데이트 에이전트 버전에서만 사용할 수 있는 새로운 기능을 사용할 수 있는 기능 없이 New Relic Node.js v8 에이전트에 남아 있습니다.
팁
가능한 한 빨리 최신 버전의 Node.js로 업그레이드하세요. New Relic Node.js 에이전트의 다음 주요 버전은 Node.js 14에 대한 지원을 제거할 것입니다.
BREAKING: 대리인은 '인증서' 설정(일반적으로 프록시와 함께)을 사용할 때 더 이상 뉴렐릭 인증서 번들이 자동으로 포함되지 않습니다.
이것이 현재 환경을 손상시키는 것으로 판단되면 기능 플래그를 활용하여 이 기능을 일시적으로 복원할 수 있습니다. 구성 예: feature_flag: { certificate_bundle: true } . 이 경우 Mozilla와 같은 환경에 대한 인증서 번들을 얻는 것이 좋습니다. New Relic 번들 및 기능 플래그는 다음 주요 릴리스에서 완전히 제거됩니다.
더 이상 사용되지 않는 max_samples_per_minute 구성 매개변수가 제거되어 max_samples_stored 동작으로 대체됨
v1 - v5:max_samples_per_minute 에이전트가 분당 수집하는 최대 이벤트 수를 정의했습니다. 이전에 max_samples_per_minute 상한으로 사용한 경우, 데이터가 서버에 삭제되는 것을 방지하기 위해 이전 값, 한계를 유효한 최대값으로 낮추어야 할 수도 있습니다. 10,000 미만을 권장합니다.
v5: 에이전트 v5 이하에서는 max_samples_stored 이 뉴렐릭 수집기 와 통신할 수 없는 경우 에이전트 저장소의 최대 수를 정의했습니다.
v6:max_samples_stored 의 새로운 동작은 에이전트가 분당 수집하는 최대 이벤트 수를 정의합니다. 이 숫자보다 많은 경우 에이전트는 통계 샘플링을 수집합니다. 이 설정 사용법은 다른 APM 에이전트와 일치합니다.
Troubleshooting tips: 이벤트 데이터가 누락된 경우 max_samples_stored 값을 늘리거나 기본값으로 되돌립니다. max_samples_stored 값은 10,000을 초과할 수 없습니다.
Node.js 버전 지원
Node.js 8은 New Relic Node.js v6 에이전트에서 지원하는 가장 초기 버전입니다. Node.js 6, 7 및 9는 v6에서 지원되지 않습니다. Node.js 6, 7, 9를 실행하는 고객에게는 두 가지 옵션이 있습니다.
지원되는 Node.js 버전으로 업그레이드하고 New Relic Node.js v6 에이전트의 새로운 기능을 활용하세요.
업데이트 에이전트 버전에서만 사용할 수 있는 새로운 기능을 사용할 수 있는 기능 없이 New Relic Node.js v5 에이전트에 남아 있습니다.
v4: npm 패키지 node-cassandra-cql 을 사용하면 Cassandra에 대한 데이터스토어 지표를 얻을 수 있습니다.
v5: Cassandra 데이터스토어 메트릭을 얻으려면 cassandra-driver 패키지로 마이그레이션해야 합니다. 이 모듈은 동일한 개발자가 적극적으로 유지 관리합니다. node-cassandra-cql 패키지는 cassandra-driver 패키지를 위해 2014년 2월에 중단되었습니다.
더 이상 사용되지 않는 capture_params 및 ignored_params 구성을 제거했습니다.
v2 - v4: 에이전트 v2.7.0부터 이러한 설정 모범 사례로 인해 경고가 로그되고 값이 자동으로 새 속성 설정으로 업그레이드되었습니다.
v5: 경고는 계속 기록되지만 설정은 무시되며 더 이상 자동 업그레이드가 발생하지 않습니다.
Troubleshooting tips:ignored_params 설정에 나열된 모범 사례가 있는 경우 이를 attributes.exclude 로 이동해야 합니다.
Node.js 버전 지원
Node.js 6은 New Relic Node.js v5 에이전트에서 지원하는 가장 초기 버전입니다. Node.js 4 및 5는 v5에서 지원되지 않습니다. Node.js 4 또는 5를 실행하는 고객에게는 두 가지 옵션이 있습니다.
지원되는 Node.js 버전으로 업그레이드하고 New Relic Node.js v5 에이전트의 새로운 기능을 활용하세요.
업데이트 에이전트 버전에서만 사용할 수 있는 새로운 기능을 사용할 수 있는 기능 없이 New Relic Node.js v4 에이전트에 남아 있습니다.
Node.js v4 에이전트의 주요 변경 사항에는 v0에서 v2로의 https-proxy-agent 업그레이드가 포함됩니다. 이 종속성은 New Relic Node.js 에이전트가 사용한 https-proxy-agent 의 보안 문제 로 인해 업데이트되었습니다. https-proxy v2는 노드 v0.10 및 v0.12와 호환되지 않으므로 New Relic은 해당 에이전트 버전을 더 이상 사용하지 않습니다. New Relic의 Node.js 에이전트 v3에서 v4로 마이그레이션하는 데 필요한 조치는 없습니다.
Node.js 4는 New Relic Node.js v4 에이전트에서 지원하는 가장 초기 버전입니다. Node.js 0.10 및 0.12는 v4에서 지원되지 않습니다. Node.js 0.10 또는 0.12를 실행하는 고객에게는 두 가지 옵션이 있습니다.
지원되는 Node.js 버전으로 업그레이드하고 New Relic Node.js v4 에이전트의 새로운 기능을 활용하세요.
업데이트된 에이전트 버전에서만 사용할 수 있는 새 기능을 사용할 수 있는 기능 없이 New Relic Node.js v3 에이전트에 남아 있습니다.