• 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

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

문제 신고

Node.js 에이전트 구성

newrelic.js 구성 파일을 수정하거나 환경 변수를 설정하여 Node.js 에이전트를 앱 요구사항에 맞게 조정할 수 있습니다. 구성 파일은 앱의 루트 디렉터리에 있습니다. New Relic에서 몇 가지 옵션을 구성하거나 Node.js 에이전트 API를 사용할 수도 있습니다.

시작하다

New Relic 계정 (영구 무료)을 만들고 Node.js 에이전트를 설치 한 후 환경에 맞게 Node.js 에이전트를 구성할 수 있습니다.

license_key 설정이 필요합니다. 또한 앱에 기본 My Application 대신 의미 있는 이름 을 갖도록 app_name 을 설정하는 것이 좋습니다.

구성 방법 및 우선 순위

Node.js 에이전트를 구성하는 기본 방법은 에이전트 구성 파일( newrelic.js )입니다. 환경 변수 를 사용하여 대부분의 설정을 구성할 수도 있습니다. 서버 측 구성 을 사용하여 일부 설정을 조정할 수도 있습니다.

Node.js 에이전트는 구성 방법에 다음과 같은 우선 순위를 사용합니다.

Node.js 구성 계층: 서버 측 구성 설정은 환경 변수를 재정의합니다. 환경 변수는 에이전트 구성 파일을 재정의합니다. 구성 파일은 에이전트 기본값을 재정의합니다.

각 구성 방법에 대한 자세한 설명은 다음과 같습니다.

변수 내보내기

이 섹션에서는 앱 newrelic.js 구성 파일의 exports.config = { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.

로깅 변수

이 섹션에서는 앱 newrelic.js 구성 파일의 logging: { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.

감사 로깅

이 섹션에서는 앱 newrelic.js 구성 파일의 audit_log: { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.

API 구성

이 섹션에서는 활성화된 API 메서드를 선택할 수 있습니다. 각 구성 옵션을 사용하면 New Relic에 사용자 지정 정보를 전송하는 API 메서드를 모듈식으로 활성화할 수 있습니다.

중요

에이전트가 높은 보안 모드에 있을 때 이 모든 것이 false 으로 설정됩니다.

속성

이 섹션에서는 일반적으로 앱 newrelic.js 구성 파일의 attributes: { 섹션에 나타나는 순서대로 Node.js 에이전트 속성 에 대한 변수를 정의합니다.

주의

헤더 관련 포함/제외 규칙은 필터링할 camelCase 형식이어야 합니다.

오류 수집기 변수

New Relic에서 오류 처리 방법을 관리할 수 있습니다. 이 섹션에서는 앱 newrelic.js 구성 파일의 error_collector: { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.

트랜잭션 추적기 변수

에이전트는 요청을 다음 작업에 사용되는 트랜잭션 으로 그룹화합니다.

  • 앱이 시간을 보내는 위치를 시각화합니다(트랜잭션 분석에서).
  • 느린 요청을 식별합니다.
  • 그룹 메트릭.
  • 느린 데이터베이스 성능 과 같은 다른 문제를 분리합니다.

이 섹션에서는 앱 newrelic.js 구성 파일의 transaction_tracer: { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.

중요

거래 이름 끝에 대괄호 [suffix] 를 사용하지 마십시오. New Relic은 자동으로 이름에서 괄호를 제거합니다. 대신 필요한 경우 괄호 (suffix) 또는 기타 기호를 사용하십시오.

규칙 변수

이 섹션에서는 앱 newrelic.js 구성 파일의 rules: { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.

트랜잭션 이벤트 변수

이 섹션에서는 앱 newrelic.js 구성 파일의 transaction_events: { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.

브라우저 모니터링 변수

이 섹션에서는 앱 newrelic.js 구성 파일의 browser_monitoring: { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.

맞춤 이벤트 변수

이 섹션에서는 앱 newrelic.js 구성 파일의 custom_insights_events: { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다. 현재 사용자 정의 이벤트에 대한 환경 변수가 없습니다.

느린 쿼리 변수

이 섹션에서는 앱 newrelic.js 구성 파일의 slow_sql: { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다. 이러한 옵션은 느린 쿼리의 동작을 제어하지만 트랜잭션 추적의 SQL 노드에는 영향을 주지 않습니다.

사용자 정의 호스트 이름 변수

이 섹션에서는 앱 newrelic.js 구성 파일의 process_host: { 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다. 이러한 옵션은 APM UI의 호스트 표시 이름과 관련된 동작을 제어합니다.

환경 변수 재정의

이 섹션에서는 환경 변수에만 사용할 수 있는 두 가지 구성 옵션을 정의합니다. 이러한 재정의는 대부분의 구성에서 사용되지 않습니다.

데이터 저장소 추적기 변수

이 섹션에서는 앱 newrelic.js 구성 파일의 datastore_tracer 섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다. 이러한 옵션은 데이터 저장소 인스턴스 측정항목을 수집하기 위한 동작을 제어합니다.

교차 애플리케이션 추적(지원 중단됨)

교차 애플리케이션 추적 을 제어하는 Node.js 에이전트 변수는 일반적으로 앱 newrelic.js 구성 파일의 cross_application_tracer 섹션에 나타납니다.

중요

CAT(교차 응용 프로그램 추적)은 더 이상 사용되지 않으며 향후 주요 릴리스에서 제거될 예정입니다. 서비스 간 가시성을 위해 에이전트 버전 8.3.0부터 기본적으로 활성화된 분산 추적 을 사용하는 것이 좋습니다. 활성화하기 전에 전환 가이드 를 읽으십시오.

오류 메시지 수정 변수

오류 메시지 수정을 제어하는 Node.js 에이전트 변수는 앱 newrelic.js 구성 파일의 allow_raw_exception_messages 섹션에 나타납니다.

분산 추적

중요

분산 추적을 활성화하면 교차 애플리케이션 추적 이 비활성화되고 다른 APM 기능에 영향을 미칩니다. 활성화하기 전에 전환 가이드 를 읽으십시오. Node.js 에이전트 버전 4.7.0 이상이 필요합니다.

분산 추적을 사용하면 분산 시스템을 통해 이동하는 요청의 경로를 볼 수 있습니다. 구성 파일을 통해 구성할 때 distributed_tracing 섹션에 다음 옵션을 배치합니다.

스팬 이벤트

분산 추적 에 대해 스팬 데이터 가 보고됩니다. 범위를 보고하려면 분산 추적을 활성화해야 합니다. 스팬 구성은 span_events 스탠자에서 설정됩니다. 옵션에는 다음이 포함됩니다.

무한 추적

무한 추적을 켜려면 분산 추적을 활성화하고( distributed_tracingenabled: true 로 설정) 아래에 추가 설정을 추가합니다. 예를 보려면 언어 에이전트: 분산 추적 구성 을 참조하세요.

애플리케이션 로깅

Copyright © 2022 New Relic Inc.

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