Node.js 에이전트 업데이트

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

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

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

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

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

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

BREAKING 더 이상 사용되지 않는 Distributed Tracing 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) 를 호출할 때 W3C의 traceparent 및 tracestate 헤더를 수락하고 New Relic 추적이 없는 한 transactionHandle.insertDistributedTraceHeaders(headers) 를 호출할 때 New Relic 분산 추적 헤더와 함께 W3C 헤더를 포함합니다. 헤더 형식은 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: @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을 넘지 않아야 합니다.

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

• v2 - v4: 에이전트 v2.7.0부터 이러한 구성 매개변수로 인해 경고가 기록되고 값이 자동으로 새 속성 구성으로 업그레이드되었습니다.
• v5: 경고가 계속 기록되지만 구성이 무시되고 더 이상 자동 업그레이드가 발생하지 않습니다.
• 문제 해결 팁: 애플리케이션에 ignored_params 구성에 나열된 매개변수가 있는 경우 attributes.exclude 으)로 이동해야 합니다.