• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

Node.js 에이전트 업데이트

New Relic의 최신 기능, 향상된 기능 및 중요한 보안 패치를 최대한 활용하려면 Node.js 에이전트를 최신 버전으로 업데이트하는 것이 좋습니다. 특정 에이전트 업데이트에 대한 추가 정보는 Node.js 에이전트 릴리스 정보 를 참조하십시오. 릴리스 정보에는 해당되는 경우 다운로드 링크와 최신 버전 다운로드 및 설치 지침이 포함됩니다.

  • newrelic 모듈이 package.json npm install }를 실행합니다.
  • newrelic 모듈만 타겟팅하려면 npm update newrelic 을 실행합니다.

권장 사항: 업데이트된 버전을 프로덕션으로 이동하기 전에 테스트하십시오. 문제가 있는 경우 Node.js 에이전트 문제 해결 절차를 따르세요.

Node.js 에이전트 버전 11로 업그레이드

Node.js 버전 11로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.

Major changes with Node.js agent v11

Comments

Node.js 20에 대한 공식 패리티 지원이 추가되었습니다.

BREAKING: Node.js 14 지원이 중단되었습니다.

BREAKING: Node.js 20을 지원하도록 ESM 로더를 업데이트했습니다.

  • 이제 애플리케이션을 실행할 때 --experimental-loader-r 인수를 모두 사용해야 합니다.
  • node --experimental-loader newrelic/esm-loader.mjs -r newrelic path/to/app.js

BREAKING: 기본 컨텍스트 관리자를 AsyncLocalContextManager로 업데이트했습니다.

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: WebFrameworkShim 클래스에서 CaptureUrlParams를 제거했습니다.

DEPRECATION NOTICE: 여러 번 포장된 항목을 포장 해제하려고 하면 shim.unwrap 및 shim.unwrapOnce가 더 이상 작동하지 않습니다.

  • 이는 이제 동일한 모듈을 두 번 이상 계측할 수 있으므로 등록된 모든 계측을 중단하지 않고는 안전하게 래핑을 풀 수 없기 때문입니다. 다음 주요 릴리스에서는 shim.unwrap 및 shim.unwrapOnce를 제거할 계획입니다.

업데이트된 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 14는 New Relic Node.js v10 에이전트가 지원하는 가장 초기 버전입니다. Node.js 12 및 13은 v10에서 지원되지 않습니다. Node.js 13 이하를 실행하는 고객에게는 두 가지 옵션이 있습니다.

  • 지원되는 Node.js 버전으로 업그레이드하고 New Relic Node.js v10 에이전트의 새로운 기능을 활용하세요.
  • 업데이트 에이전트 버전에서만 사용할 수 있는 새로운 기능을 사용할 수 있는 기능 없이 New Relic Node.js v8 에이전트에 남아 있습니다.

가능한 한 빨리 최신 버전의 Node.js로 업그레이드하세요. New Relic Node.js 에이전트의 다음 주요 버전은 Node.js 14에 대한 지원을 제거할 것입니다.

Node.js 에이전트 버전 9로 업그레이드

Node.js 버전 9로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.

Major changes with Node.js agent v9

Comments

Node.js 18에 대한 공식 패리티 지원이 추가되었습니다.

BREAKING: Node.js 12 지원이 중단되었습니다.

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에 대한 지원을 제거할 것입니다.

Node.js 에이전트 버전 8로 업그레이드

Node.js 버전 8로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.

Major changes with Node.js agent v8

Comments

Node.js 16에 대한 공식 패리티 지원이 추가되었습니다.

BREAKING: Node.js v10.x 지원이 중단되었습니다.

BREAKING: 기능 플래그에서 serverless_mode 제거했습니다.

  • 표준 serverless_mode 구성이 여전히 존재합니다.

BREAKING: 대리인은 '인증서' 설정(일반적으로 프록시와 함께)을 사용할 때 더 이상 뉴렐릭 인증서 번들이 자동으로 포함되지 않습니다.

  • 이것이 현재 환경을 손상시키는 것으로 판단되면 기능 플래그를 활용하여 이 기능을 일시적으로 복원할 수 있습니다. 구성 예: feature_flag: { certificate_bundle: true } . 이 경우 Mozilla와 같은 환경에 대한 인증서 번들을 얻는 것이 좋습니다. New Relic 번들 및 기능 플래그는 다음 주요 릴리스에서 완전히 제거됩니다.
  • 기본값은 config.feature_flags.certificate_bundle이 false입니다.

업데이트된 Node.js 버전 지원이 있는 버전으로 New Relic Dependencies 업데이트

  • @newrelic/aws-sdk v4.0.1
  • @newrelic/koa v6.0.1
  • @newrelic/native-metrics v7.0.1
  • @newrelic/superagent v5.0.1
  • @newrelic/test-utilities v6.0.0

Node.js 버전 지원

Node.js v12는 New Relic Node.js v8 에이전트에서 지원하는 가장 초기 버전입니다. Node.js 10 및 11은 v8에서 지원되지 않습니다. Node.js 11 및 이전 버전을 실행하는 고객에게는 두 가지 옵션이 있습니다.

  • 지원되는 Node.js 버전으로 업그레이드하고 New Relic Node.js v8 에이전트의 새로운 기능을 활용하세요.
  • 업데이트 에이전트 버전에서만 사용할 수 있는 새로운 기능을 사용할 수 있는 기능 없이 New Relic Node.js v7 에이전트에 남아 있습니다.

가능한 한 빨리 최신 버전의 Node.js로 업그레이드하세요. New Relic Node.js 에이전트의 다음 주요 버전은 Node.js 12에 대한 지원을 제거할 것입니다.

Node.js 에이전트 버전 7로 업그레이드

Node.js 버전 7로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.

Major changes with Node.js agent v7

Comments

BREAKING 더 이상 사용되지 않는 httpResponseCode, response.statushttpResponseMessage http 응답 속성을 제거했습니다.

  • v6.4.2-v6.14.0: 에이전트 v6.4.2부터 이러한 속성은 더 이상 사용되지 않는 것으로 표시되었지만 새 속성에 대한 전환 기간을 제공하기 위해 그대로 유지되었습니다.
  • v7: http 응답 속성 보고가 활성화되면 http.statusCodehttp.statusText 보고됩니다.

BREAKING 더 이상 사용되지 않는 setIgnoreTransaction API 메소드를 제거했습니다.

  • v5 - v6: 에이전트 v5.0.0부터 이 방법은 더 이상 사용되지 않는 것으로 표시되었지만 새 방법에 대한 전환 기간을 제공하기 위해 그대로 두었습니다.
  • v7: 애플리케이션은 API 메서드 transactionHandle.ignore() 을 사용해야 합니다.

BREAKING api.custom_parameters_enabled 설정 항목 및 관련 환경 변수 NEW_RELIC_API_CUSTOM_PARAMETERS 을(를) 제거했습니다.

BREAKING 지원 중단된 추적 API 메소드인 createDistributedTracePayload() 및를 제거했습니다. acceptDistributedTracePayload()

업데이트된 Node.js 버전 지원이 있는 버전으로 New Relic Dependencies 업데이트

  • @newrelic/aws-sdk v3.0.0
  • @newrelic/koa v5.0.0
  • @newrelic/native-metrics v6.0.0
  • @newrelic/superagent v4.0.0
  • @newrelic/test-utilities v5.0.0

Node.js 버전 지원

Node.js v10은 New Relic Node.js v7 에이전트에서 지원하는 가장 초기 버전입니다. Node.js 8 및 9는 v7에서 지원되지 않습니다. Node.js 9 및 이전 버전을 실행하는 고객에게는 두 가지 옵션이 있습니다.

  • 지원되는 Node.js 버전으로 업그레이드하고 New Relic Node.js v7 에이전트의 새로운 기능을 활용하세요.
  • 업데이트 에이전트 버전에서만 사용할 수 있는 새로운 기능을 사용할 수 있는 기능 없이 New Relic Node.js v6 에이전트에 남아 있습니다.

Node.js 10은 업데이트를 받지 않습니다 . 가능한 한 빨리 최신 버전의 Node.js로 업그레이드하세요. Node.js 10에 대한 지원은 New Relic Node.js 에이전트 v8에서 중단되었습니다.

Node.js 에이전트 버전 6으로 업그레이드

Node.js 에이전트 버전 6으로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.

Major changes with Node.js agent v6

Comments

공식 Koa 프레임워크 계측 모듈을 v3.0.0으로 업그레이드했습니다.

  • v6: v8.0.2까지 @koa/router에 대한 지원이 추가되었습니다. @koa/router v8.0.3 이상은 현재 지원되지 않습니다.
  • v6: Node.js v12에 대한 지원이 추가되고 Node.js v6, 7, 9에 대한 지원이 제거되었습니다. 지원되는 최소 버전은 Node.js v8입니다.
  • Github에서 New Relic의 Koa 릴리스 노트도 참조하세요. .

더 이상 사용되지 않는 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 에이전트에 남아 있습니다.

Node.js 8은 더 이상 업데이트를 받지 않지만 New Relic은 당분간 이러한 버전의 Node.js를 계속 지원할 것입니다.

가능한 한 빨리 최신 버전의 Node.js로 업그레이드하세요. New Relic Node.js 에이전트의 다음 주요 버전은 Node.js 8에 대한 지원을 제거할 것입니다.

Node.js 에이전트 버전 5로 업그레이드

Node.js 에이전트 v5로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요. 또한 GitHub에서 New Relic의 Node.js v5 마이그레이션 가이드를 참조하세요.

Major changes with Node.js v5 agent

Comments

더 이상 사용되지 않는 addCustomParameter 메서드를 제거했습니다.

  • v2 - v4: 에이전트 v2.7.0부터 이러한 메서드는 더 이상 사용되지 않는 것으로 표시되었지만 새 메서드에 대한 전환 기간을 제공하기 위해 그대로 두었습니다.
  • v5: 애플리케이션은 API 메서드 newrelic.addCustomAttribute()newrelic.addCustomAttributes() 사용해야 합니다. 이는 기존 방법을 대체하는 대체 방안입니다.

더 이상 사용되지 않는 create*Transaction 메서드를 제거했습니다.

  • v2 - v4: 에이전트 v2.0.2부터 이러한 메서드는 더 이상 사용되지 않는 것으로 표시되었지만 새 메서드에 대한 전환 기간을 제공하기 위해 그대로 두었습니다.
  • v5: 애플리케이션은 API 메서드 newrelic.startWebTransaction()newrelic.startBackgroundTransaction() 로 업데이트해야 합니다.
  • Troubleshooting tips: 이러한 새로운 방법은 기존 방법을 즉시 대체하는 것이 아닙니다 . 이러한 새로운 방법으로 전환하기 전에 맞춤형 로그아웃 가이드를 검토하세요.

더 이상 사용되지 않는 createTracer 메서드가 제거되었습니다.

  • v3 - v4: 에이전트 v3.3.0부터 이 메서드는 newrelic.startSegment()(를) 위해 더 이상 사용되지 않는 것으로 표시되었습니다.
  • v5: 애플리케이션을 newrelic.startSegment() 로 업데이트해야 합니다.

node-cassandra-cql 계측을 제거했습니다.

  • v4: npm 패키지 node-cassandra-cql 을 사용하면 Cassandra에 대한 데이터스토어 지표를 얻을 수 있습니다.
  • v5: Cassandra 데이터스토어 메트릭을 얻으려면 cassandra-driver 패키지로 마이그레이션해야 합니다. 이 모듈은 동일한 개발자가 적극적으로 유지 관리합니다. node-cassandra-cql 패키지는 cassandra-driver 패키지를 위해 2014년 2월에 중단되었습니다.

더 이상 사용되지 않는 capture_paramsignored_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 7 및 9는 더 이상 업데이트를 받지 않지만 New Relic은 당분간 이러한 버전의 Node.js를 계속 지원할 것입니다.

가능한 한 빨리 최신 버전의 Node.js로 업그레이드하세요. New Relic Node.js 에이전트의 다음 주요 버전은 Node.js 6 및 7에 대한 지원을 제거할 것입니다.

v5의 기능 플래그

Node.js v5용 New Relic 기준:

  • custom_instrumentation: 이 기능은 더 이상 구성할 수 없습니다.
  • custom_metrics: 이 기능은 더 이상 구성할 수 없습니다.
  • synthetics: 이 기능은 더 이상 구성할 수 없습니다.
  • native_metrics: 이 기능은 이제 plugins.native_metrics.enabled 구성 값으로 제어됩니다.

Node.js 에이전트 버전 4로 업그레이드

Node.js 에이전트 v4로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요. 또한 GitHub에서 New Relic의 Node.js v4 마이그레이션 가이드를 참조하세요.

Node.js 에이전트 버전 3으로 업그레이드

Node.js 에이전트 에이전트 v3으로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요. 또한 GitHub에서 New Relic의 Node.js v3 마이그레이션 가이드를 참조하세요.

Node.js 에이전트 버전 2로 업그레이드

Node.js 에이전트 v2로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요. 또한 GitHub에서 New Relic의 Node.js v2 마이그레이션 가이드를 참조하세요.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.