New Relic의 최신 기능, 향상된 기능 및 중요한 보안 패치를 최대한 활용하려면 Node.js 에이전트를 최신 버전으로 업데이트하는 것이 좋습니다. 특정 에이전트 업데이트에 대한 추가 정보는 Node.js 에이전트 릴리스 정보 를 참조하십시오. 릴리스 정보에는 해당되는 경우 다운로드 링크와 최신 버전 다운로드 및 설치 지침이 포함됩니다.
newrelic 모듈이 package.jsonnpm install }를 실행합니다.
newrelic 모듈만 타겟팅하려면 npm update newrelic 을 실행합니다.
권장 사항: 프로덕션으로 이동하기 전에 업데이트된 버전을 테스트하십시오. 문제가 있는 경우 Node.js 에이전트 문제 해결 절차 를 따르세요.
속보: 기본 컨텍스트 관리자를 AsyncLocalContextManager로 업데이트했습니다.
이전 기본 LegacyContextManager는 config.feature_flag.legacy_context_manager 의 기능 플래그를 true 로 설정하여 복원할 수 있습니다.
환경 변수를 선호하는 경우 NEW_RELIC_FEATURE_FLAG_LEGACY_CONTEXT_MANAGERtrue 로 설정할 수 있습니다.
이 컨텍스트 관리자는 향후 버전에서 제거될 예정입니다. 이 레거시 컨텍스트 관리자를 다시 사용해야 하는 경우 New Relic 지원 또는 GitHub 문제를 통해 이를 제기해 주세요.
속보: 이름이 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으로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.
Node.js 에이전트 v11의 주요 변경 사항
코멘트
동일한 확인된 moduleName에 대해 계측 다중 후크(onRequire, onResolved)를 등록하는 기능이 추가되었습니다.
이는 처음부터 에이전트의 한계였습니다.
api를 사용하여 api.instrument, api.instrumentDatastore, api.instrumentWebframework, api.instrumentMessages 또는 api.instrumentConglomerate를 계측한 경우 기존 계측 후크가 재정의됩니다.
그 결과 Node.js 에이전트가 설계된 대로 작동하지 않게 되었습니다.
속보: config.transaction_tracer.record_sql 의 기본값을 off에서 난독화로 업데이트했습니다. 이는 SQL 문이 캡처되지만 난독화됨을 의미합니다.
속보: 경로(URL) 매개변수는 이제 트랜잭션, 루트 세그먼트 및 범위에 대한 request.parameters.route.* 속성으로 저장됩니다.
쿼리 매개변수는 request.parameters라는 접두사가 붙은 속성으로 제공됩니다.* 트랜잭션 및 스팬에 대해
경로 매개변수는 request.parameters.route.*라는 접두사가 붙은 속성으로 제공됩니다. 트랜잭션 및 스팬에 대해
경로 매개변수(URL 매개변수라고도 함)는 API 경로 정의의 일부로 자리 표시자를 생성할 수 있는 다양한 웹 프레임워크의 일반적인 기능입니다.
속보: 에이전트는 '인증서' 구성(일반적으로 프록시 사용)을 사용할 때 더 이상 New Relic 인증서 번들을 자동으로 포함하지 않습니다.
'인증서' 구성(일반적으로 프록시 사용)을 사용할 때 에이전트에는 더 이상 New Relic 인증서 번들이 포함되지 않습니다. 이로 인해 현재 환경이 손상되는 경우 Mozilla와 같은 CA 번들을 구입하는 것이 좋습니다.
속보 : 이제 에이전트는 사양 및 기타 에이전트를 준수하기 위해 포트 443에 대한 외부 HTTPS 요청을 할 때 포트를 제외합니다.
기본 HTTPS 포트를 사용할 때 이전 외부 세그먼트의 이름은 External/example.com:443 입니다.
이제 외부 세그먼트의 이름이 External/example.com 입니다.
속보 : await_support 기능 플래그를 통해 비동기 후크 기반 프라미스 컨텍스트 추적을 비활성화하는 기능이 제거되었습니다. 이것은 또한 레거시 Promise 계측을 제거합니다.
await_support 기능 플래그를 출시했습니다. 에이전트는 이제 async_hooks에 의존하여 비동기 약속 전파를 추적합니다. 최종 결과는 feature_flag.await_support 을 false로 설정한 경우 레거시 계측이 프라미스 체인의 모든 기능을 별도의 세그먼트로 추적했다는 것입니다.
속보 : 에이전트는 '인증서' 구성(일반적으로 프록시 사용)을 사용할 때 더 이상 New Relic 인증서 번들을 자동으로 포함하지 않습니다.
이것이 현재 환경을 손상시키는 것으로 판단되면 기능 플래그를 활용하여 이 기능을 일시적으로 복원할 수 있습니다. 구성 예: 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 을 상한으로 사용한 경우 서버에서 데이터가 삭제되지 않도록 임계값을 유효한 최대값으로 낮춰야 할 수 있습니다. 10k 미만을 권장합니다.
v5: 에이전트 v5 이하에서 max_samples_stored 은(는) New Relic 수집기 와 통신할 수 없는 경우 에이전트가 저장하는 최대 이벤트 수를 정의했습니다.
v6:max_samples_stored 의 새로운 동작은 에이전트가 분당 수집하는 최대 이벤트 수를 정의합니다. 이 수보다 많은 경우 에이전트는 통계적 샘플링을 수집합니다. 이 구성 사용법은 다른 APM 에이전트와 일치합니다.
문제 해결 팁: 이벤트 데이터가 누락된 경우 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: 경고가 계속 기록되지만 구성이 무시되고 더 이상 자동 업그레이드가 발생하지 않습니다.
문제 해결 팁: 애플리케이션에 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 에이전트에 남아 있습니다.