Node.js용 새로운 라이브러리는 대부분의 표준 웹 요청을 자동으로 계측하지만, 때로는 확장된 계측이 필요할 수도 있습니다. 에이전트의 로그아웃 API 사용하면 지원되지 않는 웹 프레임워크, 데이터 저장소 및 메시지 서비스 클라이언트 에 대한 로그를 생성할 수 있습니다.
Node.js 에이전트의 사용자 지정 계측 API를 통해 다음을 수행할 수도 있습니다.
- 웹 트랜잭션 을 생성합니다(트랜잭션을 자동으로 생성할 수 없는 웹 소켓과 같은 경우에 유용).
- 웹이 아닌 백그라운드 트랜잭션 을 생성합니다(백그라운드 작업 기록에 유용).
- 심층 분석 을 위해 코드의 특정 섹션을 대상으로 지정합니다.
에이전트 버전 요구 사항
이 문서의 사용자 정의 계측 방법은 Node.js 에이전트 버전 2.0.0 부터 사용할 수 있습니다. 사용자 지정 계측 API v1.x를 사용한 계측에 대한 정보는 레거시 Node.js 사용자 지정 계측 문서를 참조하십시오.
지원되지 않는 웹 프레임워크 계측
Node.js 에이전트 버전 2.0.0부터 뉴렐릭은 추가 웹 프레임워크에 대한 리소스를 확장하는 API 제공합니다. 자세한 내용은 GitHub의 예제 애플리케이션을 참조하세요.
지원되지 않는 메시지 서비스 클라이언트 계측
Node.js 에이전트 버전 2.0.0부터 뉴렐릭은 추가 메시지 서비스 라이브러리를 확장하기 위한 API 제공합니다. 자세한 내용은 GitHub의 예제 애플리케이션을 참조하세요.
지원되지 않는 데이터 저장소 계측
Node.js 에이전트 버전 2.0.0부터 뉴렐릭은 추가적인 데이터스토어 라이브러리를 확장하기 위한 API 제공합니다. 자세한 내용은 GitHub의 예제 애플리케이션을 참조하세요.
웹 트랜잭션 계측
사용자 정의 SSL 프로세서를 생성하려면 startWebTransaction 호출하여 프로세서를 시작하십시오. 자세한 내용은 GitHub의 예제 애플리케이션을 참조하세요.
링크된 예제는 생성된 프로세서에 대한 기본 타이밍 데이터만 제공합니다. 특정 프레임워크에 대한 더 복잡한 타이밍 데이터와 트랜잭션 명명 방식을 생성하려면 Node.js API 문서 와 GitHub의 관련 WebFramework 예제 애플리케이션을 참조하세요.
기기 백그라운드 트랜잭션
사용자 지정 트랜잭션을 사용하여 웹이 아닌 트랜잭션 (백그라운드 작업)을 계측할 수 있습니다. 예를 들어:
- 앱 내 정기 작업
- 요청 완료 후 계속되는 작업
리소스를 백그라운드 작업으로 사용하려면 처리기에서 startBackgroundTransaction 호출하여 백그라운드 프로세서를 시작하세요. 자세한 내용은 GitHub의 예제 애플리케이션을 참조하세요.
트랜잭션 내에서 계측 확장
API의 계측 등록 방법을 사용하여 계측을 생성할 수 있습니다. 계측 API를 사용하여 계측을 작성하면 관련 객체에서 "원숭이 패치" 메서드(함수 대체)를 사용하여 메트릭과 명명을 더 자세히 지정할 수 있습니다. 다른 옵션은 이미 권한이 부여된 웹 프로세서에 대한 가시성을 제공하거나 자동으로 권한이 부여되지 않은 데이터베이스 및 기타 트랜잭션 내 작업에 대한 인사이트를 얻을 수 있습니다.
이렇게 하려면 맞춤형 트레이서에 콜백을 포장하세요. Custom 트레이서는 특정 기능이나 데이터베이스 호출과 같은 기존 프로세서 내의 추가 세그먼트에 대한 특정 지표를 생성하고 수집합니다. 자세한 내용은 GitHub의 예제 애플리케이션을 참조하세요.