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

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

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

문제 신고

Node.js 사용자 정의 계측

New Relic for Node.js는 대부분의 표준 웹 요청을 자동으로 계측하지만 때로는 확장된 계측을 원할 때도 있습니다. 에이전트의 사용자 지정 계측 API를 사용하여 지원되지 않는 웹 프레임워크 , 데이터 저장소메시지 서비스 클라이언트 에 대한 계측을 생성할 수 있습니다.

Node.js 에이전트의 사용자 지정 계측 API를 통해 다음을 수행할 수도 있습니다.

에이전트 버전 요구 사항

이 문서의 사용자 정의 계측 방법은 Node.js 에이전트 버전 2.0.0 부터 사용할 수 있습니다. 사용자 지정 계측 API v1.x를 사용한 계측에 대한 정보는 레거시 Node.js 사용자 지정 계측 문서를 참조하십시오.

지원되지 않는 웹 프레임워크 계측

Node.js 에이전트 버전 2.0.0부터 New Relic은 추가 웹 프레임워크에 대한 계측을 확장하기 위한 API를 제공합니다. 자습서를 포함한 자세한 내용은 GitHub의 Node.js 웹 프레임워크 계측 에 대한 설명서를 참조하세요.

지원되지 않는 메시지 서비스 클라이언트 계측

Node.js 에이전트 버전 2.0.0부터 New Relic은 추가 메시지 서비스 라이브러리에 대한 계측을 확장하기 위한 API를 제공합니다. 자습서를 포함한 자세한 내용은 GitHub의 Node.js 메시지 서비스 클라이언트 계측 에 대한 설명서를 참조하세요.

지원되지 않는 데이터 저장소 계측

Node.js 에이전트 버전 2.0.0부터 New Relic은 추가 데이터 저장소 라이브러리에 대한 계측을 확장하는 API를 제공합니다. 자습서를 포함한 자세한 내용은 GitHub의 Node.js 데이터 저장소 계측 에 대한 설명서를 참조하세요.

웹 트랜잭션 계측

맞춤 웹 트랜잭션 을 생성하려면 startWebTransaction 를 호출하여 트랜잭션을 시작하세요. 거래를 종료하려면 다음 옵션 중 하나를 사용하십시오.

거래 종료

코멘트

약속하다

startWebTransaction 에 전달된 핸들러가 약속을 반환하면 에이전트는 반환된 약속이 해결되거나 거부될 때 트랜잭션을 종료합니다.

수동

새 트랜잭션의 컨텍스트에서 getTransaction 을 호출하면 트랜잭션이 수동으로 처리될 것임을 에이전트에 알립니다.

핸들러에서 getTransaction 호출되면 transaction.end()호출하여 트랜잭션을 종료 해야 합니다 .

동기

이러한 옵션이 모두 충족되지 않으면 핸들러가 동기적으로 반환될 때 트랜잭션이 종료됩니다.

기기 백그라운드 트랜잭션

사용자 지정 트랜잭션을 사용하여 웹이 아닌 트랜잭션 (백그라운드 작업)을 계측할 수 있습니다. 예를 들어:

  • 앱 내 정기 작업
  • 요청 완료 후 계속되는 작업

백그라운드 작업을 계측하려면 핸들러에서 startBackgroundTransaction 를 호출하여 백그라운드 트랜잭션을 시작합니다. 거래를 종료하려면 다음 옵션 중 하나를 사용하세요.

거래 종료

코멘트

약속하다

startBackgroundTransaction 에 전달된 핸들러가 약속을 반환하면 에이전트는 반환된 약속이 해결되거나 거부될 때 트랜잭션을 종료합니다.

수동

새 트랜잭션의 컨텍스트에서 getTransaction 을 호출하면 트랜잭션이 수동으로 처리될 것임을 에이전트에 알립니다.

핸들러에서 getTransaction 호출되면 transaction.end()호출하여 트랜잭션을 종료 해야 합니다 .

동기

이러한 옵션이 모두 충족되지 않으면 핸들러가 동기적으로 반환될 때 트랜잭션이 종료됩니다.

트랜잭션 내에서 계측 확장

API의 계측 등록 방법을 사용하여 계측을 생성할 수 있습니다. 인스트루먼테이션 API를 사용하여 인스트루먼테이션을 작성하면 관련 개체에 대한 "원숭이 패치" 방법(함수 교체)을 통해 메트릭과 이름을 더 자세히 지정할 수 있습니다. 다른 옵션은 이미 계측된 웹 트랜잭션에 대한 가시성을 제공하거나 자동으로 계측되지 않는 데이터베이스 및 기타 트랜잭션 내 작업에 대한 통찰력을 얻을 수 있습니다.

이렇게 하려면 사용자 지정 추적 프로그램에서 콜백을 래핑합니다. 사용자 지정 추적기는 특정 기능 또는 데이터베이스 호출과 같은 기존 트랜잭션 내의 추가 세그먼트에 대한 특정 메트릭을 생성하고 수집합니다.

  • 개별 콜백을 계측하려면 콜백 내에서 startSegment() 를 호출하고 기본 콜백 로직을 handler 함수로 이동합니다.
  • 비동기 함수 내에서 호출되는 함수를 계측하려면 대상 함수와 상위 비동기 함수를 모두 startSegment() 으로 래핑합니다.

중요

이러한 예제는 트랜잭션에서 실행되는 코드에 배치해야 합니다. 사용자 지정이든 자동 생성이든 트랜잭션의 출처는 중요하지 않습니다.

Copyright © 2024 New Relic Inc.

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