Node.js 에이전트 업데이트

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로 업데이트했습니다.

• 이전 기본 LegacyContextManager는 config.feature_flag.legacy_context_manager 의 기능 플래그를 true 로 설정하여 복원할 수 있습니다.
• 환경 변수를 선호하는 경우 NEW_RELIC_FEATURE_FLAG_LEGACY_CONTEXT_MANAGER true 로 설정할 수 있습니다.
• 이 컨텍스트 관리자는 향후 버전에서 제거될 예정입니다. 이 레거시 컨텍스트 관리자를 다시 사용해야 하는 경우 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

• 동일한 확인된 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 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 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

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

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

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

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

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

• 애플리케이션은 구성 api.custom_attributes_enabled 또는 관련 환경 변수 NEW_RELIC_API_CUSTOM_ATTRIBUTES 를 사용하여 newrelic.addCustomAttribute 및 newrelic.addCustomAttributes 를 활성화해야 합니다.

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

• v6.4.0-v6.14.0: 에이전트 v6.4.0부터 이러한 메서드는 더 이상 사용되지 않는 것으로 표시되었지만 새 메서드에 대한 전환 기간을 제공하기 위해 그대로 두었습니다.
• v7: 애플리케이션은 API 메소드 transactionHandle.insertDistributedTraceHeaders(headers) 및 transactionHandle.acceptDistributedTraceHeaders(transportType, headers) 사용해야 합니다. 이러한 방법을 사용하면 Node.js 에이전트는 이제 transactionHandle.acceptDistributedTraceHeaders(headers) transactionHandle.insertDistributedTraceHeaders(headers) 할 때 W3C의 traceparent 및 tracestate 헤더를 허용하고, 뉴렐릭 트레이스 헤더 형식은 distributed_tracing.exclude_newrelic_header:true(를) 사용하여 비활성화됩니다.

업데이트된 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

공식 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을 초과할 수 없습니다.

더 이상 사용되지 않는 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_params 및 ignored_params 구성을 제거했습니다.

• v2 - v4: 에이전트 v2.7.0부터 이러한 설정 모범 사례로 인해 경고가 로그되고 값이 자동으로 새 속성 설정으로 업그레이드되었습니다.
• v5: 경고는 계속 기록되지만 설정은 무시되며 더 이상 자동 업그레이드가 발생하지 않습니다.
• Troubleshooting tips: ignored_params 설정에 나열된 모범 사례가 있는 경우 이를 attributes.exclude 로 이동해야 합니다.