• 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로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.

Node.js 에이전트 v11의 주요 변경 사항

코멘트

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

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

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

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

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

속보: 이름이 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 경로 정의의 일부로 자리 표시자를 생성할 수 있는 다양한 웹 프레임워크의 일반적인 기능입니다.

속보: WebFrameworkShim 클래스에서 CaptureUrlParams가 제거되었습니다.

사용 중단 알림: 여러 번 포장된 항목을 포장 해제하려고 하면 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로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.

Node.js 에이전트 v9의 주요 변경 사항

코멘트

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

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

속보: 에이전트는 '인증서' 구성(일반적으로 프록시 사용)을 사용할 때 더 이상 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로 설정한 경우 레거시 계측이 프라미스 체인의 모든 기능을 별도의 세그먼트로 추적했다는 것입니다.

속보 : 더 이상 사용되지 않는 oracle npm 패키지에 대한 계측이 제거되었습니다.

속보 : pg 의 최소 버전을 8.2.x로 업데이트했습니다. 이것은 Node.js 14+에서 실행되는 가장 빠른 지원 버전입니다.

속보 : 지원되는 최소 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로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.

Node.js 에이전트 v8의 주요 변경 사항

코멘트

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

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

속보 : serverless_mode 을 기능 플래그로 제거했습니다.

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

속보 : 에이전트는 '인증서' 구성(일반적으로 프록시 사용)을 사용할 때 더 이상 New Relic 인증서 번들을 자동으로 포함하지 않습니다.

  • 이것이 현재 환경을 손상시키는 것으로 판단되면 기능 플래그를 활용하여 이 기능을 일시적으로 복원할 수 있습니다. 구성 예: 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로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.

Node.js 에이전트 v7의 주요 변경 사항

코멘트

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() 를 사용해야 합니다.

속보 api.custom_parameters_enabled 구성 항목 및 관련 환경 변수 NEW_RELIC_API_CUSTOM_PARAMETERS 을(를) 제거했습니다.

BREAKING 더 이상 사용되지 않는 Distributed Tracing 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으로 업그레이드하기 전에 이 정보에서 주요 변경 사항을 검토하세요.

Node.js 에이전트 v6의 주요 변경 사항

코멘트

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

  • v6: @koa/router에 대한 지원이 v8.0.2까지 추가되었습니다. @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 을 상한으로 사용한 경우 서버에서 데이터가 삭제되지 않도록 임계값을 유효한 최대값으로 낮춰야 할 수 있습니다. 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 에이전트에 남아 있습니다.

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 마이그레이션 가이드를 참조하세요.

Node.js v5 에이전트의 주요 변경 사항

코멘트

더 이상 사용되지 않는 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() 로 업데이트해야 합니다.
  • 문제 해결 팁: 이 새로운 방법은 이전 방법을 즉시 대체할 수 없습니다 . 이러한 새로운 방법으로 이동하기 전에 맞춤형 계측 가이드 를 검토하십시오.

더 이상 사용되지 않는 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: 경고가 계속 기록되지만 구성이 무시되고 더 이상 자동 업그레이드가 발생하지 않습니다.
  • 문제 해결 팁: 애플리케이션에 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.