Node.js 에이전트 업데이트

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 으)로 이동해야 합니다.