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
)에는 모든 Node.js 에이전트 설정이 포함되어 있습니다. Node.js 에이전트를 설치할 때 newrelic.js
을 앱의 루트 디렉토리에 복사해야 합니다. 대부분의 설정은 기본적으로 비어 있습니다. config/default.js
에서 값을 상속합니다.
환경 변수 newrelic.js
의 대부분의 구성 설정에는 동등한 환경 변수가 있습니다. 예를 들어 에이전트가 Heroku 또는 Microsoft Azure와 같은 PaaS 환경에서 실행되는 경우에 유용합니다. Node.js 에이전트 환경 변수는 항상 NEW_RELIC_
로 시작합니다.
사용 가능한 경우 이러한 환경 변수는 개별 구성 옵션 아래에 Environ 변수 로 설명되어 있습니다. 또한 환경 변수를 통해서만 구성 할 수 있는 거의 사용되지 않는 두 가지 설정이 있습니다.
New Relic APM 및 CodeStream을 사용하는 경우 리포지토리를 연결 하는 방법과 빌드 SHA 또는 릴리스 태그 를 오류 받은 편지함에 연결하는 방법을 참조하십시오.
서버 측 구성 소유자와 관리자는 New Relic에서 직접 몇 가지 설정을 보고 구성할 수 있습니다. 사용 가능한 경우 서버 측 구성에 대한 UI 레이블은 이 문서의 개별 구성 옵션 아래에 서버 측 레이블 로 나열됩니다.
변수 내보내기 이 섹션에서는 앱 newrelic.js
구성 파일의 exports.config = {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.
app_name(필수) 유형
문자열
기본값
"내 응용 프로그램"
환경 변수
NEW_RELIC_APP_NAME
New Relic이 앱을 식별하는 데 사용하는 이름 입니다. 예: app_name: ['MyNodeApp']
. 앱에 여러 이름을 사용 하려면 쉼표로 구분된 이름 목록을 지정하십시오.
동일한 이름을 가진 모든 애플리케이션의 데이터는 New Relic UI에서 병합되므로 신중하게 설정하십시오. 혼동과 의도하지 않은 데이터 집계를 방지하려면 기본 이름을 설명이 포함된 이름으로 바꾸는 것이 좋습니다 .
팁 Azure 사용자 의 경우 Node.js 에이전트는 설정된 경우 APP_POOL_ID
을 사용하므로 두 번 설정하지 않고도 Azure 웹 서버에 대해 선택한 이름을 사용할 수 있습니다.
license_key(필수) 유형
문자열
기본값
(없음)
환경 변수
NEW_RELIC_LICENSE_KEY
이 설정은 필수입니다. 귀하의 New Relic 라이센스 키 . 예: license_key: '40HexadecimalCharacters'
.
에이전트 사용 가능 유형
부울
기본값
true
환경 변수
NEW_RELIC_ENABLED
에이전트 시작을 중지하려면 false
으로 설정합니다. 이는 코드를 디버깅하기 위해 에이전트를 일시적으로 비활성화해야 할 때 유용합니다. 에이전트가 계측을 부트스트랩하거나 모든 부분을 설정하는 것을 방지하여 에이전트가 New Relic의 서버를 시작하고 연결하는 것을 방지합니다.
true
인 경우 exclude
규칙으로 필터링된 헤더를 제외한 모든 HTTP 헤더의 캡처를 활성화합니다. false
인 경우 수집된 헤더는 Node.js 에이전트 속성 에 정의된 헤더로 제한됩니다.
유형
부울
기본값
false
환경 변수
NEW_RELIC_ALLOW_ALL_HEADERS
주의 헤더 관련 포함/제외 규칙은 필터링할 camelCase 형식이어야 합니다.
인증서 SSL 연결을 위해 신뢰할 추가 인증서로, PEM 형식의 문자열 배열로 지정됩니다. 이는 HTTPS 프록시에 대한 연결과 New Relic에 대한 연결 모두에 영향을 줍니다.
팁 파일에서 인증서를 읽도록 에이전트를 구성할 수도 있습니다.
certificates: [ fs.readFileSync('myca .crt', {encoding: 'utf8 '}) ]
주인 유형
문자열
기본값
collector.newrelic.com
환경 변수
NEW_RELIC_HOST
중요 New Relic Support에서 변경을 요청하지 않는 한 이 값을 편집하지 마십시오.
New Relic 수집기 가 인터넷에 연결할 호스트 이름. 예: host: 'collector.newrelic.com'
.
라벨 태그 를 추가합니다. 태그를 개체로 지정하거나 콜론으로 구분된 쌍의 세미콜론으로 구분된 문자열(예: Server:One;Data Center:Primary
)을 지정합니다.
유형
개체 또는 문자열
기본값
(없음)
환경 변수
NEW_RELIC_LABELS
포트 유형
정수
기본값
443
환경 변수
NEW_RELIC_PORT
중요 New Relic Support에서 변경을 요청하지 않는 한 이 값을 편집하지 마십시오.
New Relic 수집기에 연결할 포트 번호입니다. 예: port: 443
.
대리 유형
문자열
기본값
(없음)
환경 변수
NEW_RELIC_PROXY_URL
인터넷에 연결할 프록시 서버를 지정하는 URL입니다. 예: proxy: 'http://user:pass@10.0.0.1:8000/'
. 중요 고려 사항:
proxy
구성 파일 설정이 사용되는 경우 다른 구성 파일 프록시 설정( proxy_host
, proxy_port
, proxy_user
, proxy_pass
)을 재정의합니다. 마찬가지로 NEW_RELIC_PROXY_URL
환경 변수는 사용되는 경우 다른 환경 변수 프록시 설정( NEW_RELIC_PROXY_HOST
, NEW_RELIC_PROXY_PORT
, NEW_RELIC_PROXY_USER
및 NEW_RELIC_PROXY_PASS
)을 재정의합니다.Infinite Tracing 을 사용하는 경우: Infinite Tracing용 프록시를 구성하는 방법을 참조하십시오 .프록시 호스트 유형
문자열
기본값
(없음)
환경 변수
NEW_RELIC_PROXY_HOST
인터넷에 연결할 프록시 서버의 호스트 이름 또는 IP 주소입니다.
프록시 패스 유형
문자열
기본값
(없음)
환경 변수
NEW_RELIC_PROXY_PASS
프록시 서버에 인증하기 위한 비밀번호입니다. 에이전트는 기본 HTTP 인증만 지원합니다.
프록시 포트 유형
문자열
기본값
(없음)
환경 변수
NEW_RELIC_PROXY_PORT
인터넷에 연결할 프록시 서버의 포트 번호입니다.
프록시 사용자 유형
문자열
기본값
(없음)
환경 변수
NEW_RELIC_PROXY_USER
프록시 서버에 인증하기 위한 사용자 이름입니다. 에이전트는 기본 HTTP 인증만 지원합니다.
로깅 변수 이 섹션에서는 앱 newrelic.js
구성 파일의 logging: {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.
활성화 유형
문자열
기본값
true
( { serverless_mode
}의 false
})
환경 변수
NEW_RELIC_LOG_ENABLED
에이전트별 로깅을 활성화하거나 비활성화합니다.
레벨 유형
문자열
기본값
info
환경 변수
NEW_RELIC_LOG_LEVEL
에이전트 로그에 기록되는 세부 정보 수준을 정의합니다. 가장 작은 것부터 가장 큰 것까지 가능한 값은 fatal
, error
, warn
, info
, debug
또는 trace
입니다.
주의 New Relic Support에서 사용을 요청하지 않는 한 debug
또는 trace
로깅을 사용하지 마십시오. 이러한 수준의 로깅은 과도한 오버헤드를 생성할 수 있습니다. 대부분의 경우 info
를 사용합니다.
파일 경로 유형
문자열
기본값
process.cwd()
...을 더한 newrelic_agent.log
환경 변수
NEW_RELIC_LOG
파일 이름을 포함하여 New Relic 에이전트 로그의 전체 경로입니다. 기본값은 filepath: require('path').join(process.cwd(), 'newrelic_agent.log')
입니다. 에이전트는 이 파일을 생성할 수 없는 경우 프로세스를 종료합니다. 에이전트는 상위 Node.js 에이전트 프로세스와 동일한 권한으로 로그 파일을 생성합니다.
모든 로깅을 stdout 에 쓰려면 이것을 stdout
으로 설정하십시오. 모든 로깅을 stderr 에 기록하려면 이를 stderr
으로 설정합니다. 감사 로깅 이 섹션에서는 앱 newrelic.js
구성 파일의 audit_log: {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.
활성화 유형
부울
기본값
false
환경 변수
NEW_RELIC_AUDIT_LOG_ENABLED
활성화되면 에이전트는 수집기에 보내는 페이로드를 기록합니다. 이 데이터는 로깅 수준이 가장 낮은 수준으로 설정되어 있어도 기본 로그 파일에 포함됩니다.
끝점 유형
정렬
기본값
빈 배열(모든 유형 포함)
환경 변수
NEW_RELIC_AUDIT_LOG_ENDPOINTS
에이전트는 여러 유형의 데이터를 별도의 페이로드로 수집기에 보냅니다. 기본적으로 모두 로그 파일에 포함됩니다. 이 옵션을 사용하면 특정 유형의 데이터로만 로깅을 제한할 수 있습니다.
유효한 값은 다음과 같습니다.
agent_settings
analytic_event_data
connect
custom_event_data
error_data
error_event_data
metric_data
preconnect
shutdown
span_event_data
sql_trace_data
transaction_sample_data
API 구성 이 섹션에서는 활성화된 API 메서드를 선택할 수 있습니다. 각 구성 옵션을 사용하면 New Relic에 사용자 지정 정보를 전송하는 API 메서드를 모듈식으로 활성화할 수 있습니다.
중요 에이전트가 높은 보안 모드에 있을 때 이 모든 것이 false
으로 설정됩니다.
custom_attributes_enabled 속성 이 섹션에서는 일반적으로 앱 newrelic.js
구성 파일의 attributes: {
섹션에 나타나는 순서대로 Node.js 에이전트 속성 에 대한 변수를 정의합니다.
주의 헤더 관련 포함/제외 규칙은 필터링할 camelCase 형식이어야 합니다.
활성화 유형
부울
기본값
true
환경 변수
NEW_RELIC_ATTRIBUTES_ENABLED
true
인 경우 모든 대상에 대한 속성 캡처를 활성화합니다.
제외 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_ATTRIBUTES_EXCLUDE
모든 대상에서 제외할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
포함 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_ATTRIBUTES_INCLUDE
모든 대상에서 포함할 속성의 접두사입니다. 끝에 와일드카드로 *
을 허용합니다.
오류 수집기 변수 New Relic에서 오류 처리 방법을 관리할 수 있습니다. 이 섹션에서는 앱 newrelic.js
구성 파일의 error_collector: {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.
활성화 유형
부울
기본값
true
환경 변수
NEW_RELIC_ERROR_COLLECTOR_ENABLED
서버 측 레이블
Enable error collection?
활성화되면 에이전트는 앱에서 오류 추적 을 수집합니다.
ignore_status_codes 유형
정수 배열
기본값
[404]
환경 변수
NEW_RELIC_ERROR_COLLECTOR_IGNORE_ERROR_CODES
서버 측 레이블
Ignore these status codes
오류 수집기가 무시할 HTTP 상태 코드의 쉼표로 구분된 목록입니다.
ignore_classes 유형
배열|객체
기본값
[]
환경 변수
NEW_RELIC_ERROR_COLLECTOR_IGNORE_ERRORS
오류 수집기가 무시할 자바스크립트 오류 유형/클래스의 쉼표로 구분된 목록입니다.
다음 구성
ignore_classes: ["ReferenceError"]
모든 참조 오류를 무시합니다.
ignore_messages 수집기가 무시할 자바스크립트 오류 메시지에 연결된 자바스크립트 클래스 목록을 설명하는 자바스크립트 객체입니다. 다음 구성.
ignore_messages: {"Error":["Undefined", "Out of time"]}
Undefined
및 Out of time
의 정확한(대소문자 구분) 메시지 문자열을 사용하여 Error
유형의 모든 오류를 무시합니다.
주의 newrelic.noticeError
을(를) 사용하여 기록된 오류는 이 구성 값을 따르지 않습니다.
예상_상태_코드 유형
정수 배열
기본값
[]
환경 변수
NEW_RELIC_ERROR_COLLECTOR_EXPECTED_ERROR_CODES
오류 수집기가 예상대로 표시할 HTTP 상태 코드의 쉼표로 구분된 목록입니다.
주의 newrelic.noticeError
을(를) 사용하여 기록된 오류는 이 구성 값을 따르지 않습니다.
예상된 클래스 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_ERROR_COLLECTOR_EXPECTED_ERRORS
다음 구성
expected_classes: ["ReferenceError"]
모든 참조 오류를 예상대로 표시합니다.
주의 newrelic.noticeError
을(를) 사용하여 기록된 오류는 이 구성 값을 따르지 않습니다.
예상_메시지 수집기가 무시할 자바스크립트 오류 메시지에 연결된 자바스크립트 클래스 목록을 설명하는 자바스크립트 객체입니다. 다음 구성.
expected_messages: {"Error":["Undefined", "Out of time"]}
Undefined
및 Out of time
의 정확한(대소문자 구분) 메시지 문자열을 사용하여 Error
유형의 모든 오류를 표시합니다.
주의 newrelic.noticeError
을(를) 사용하여 기록된 오류는 이 구성 값을 따르지 않습니다.
속성.활성화 유형
부울
기본값
true
환경 변수
NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_ENABLED
true
인 경우 에이전트는 오류 수집에서 속성을 캡처합니다.
주의 헤더 관련 포함/제외 규칙은 필터링할 camelCase 형식이어야 합니다.
속성.제외 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDE
오류 수집에서 제외할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
속성.포함 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_INCLUDE
오류 수집에 포함할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
max_event_samples_stored 유형
정수
기본값
도면 1
환경 변수
NEW_RELIC_ERROR_COLLECTOR_MAX_EVENT_SAMPLES_STORED
에이전트가 분당 수집하는 최대 이벤트 수를 정의합니다. 이 수보다 많은 경우 에이전트는 통계적 샘플링을 수집합니다.
트랜잭션 추적기 변수 에이전트는 요청을 다음 작업에 사용되는 트랜잭션 으로 그룹화합니다.
앱이 시간을 보내는 위치를 시각화합니다(트랜잭션 분석에서). 느린 요청을 식별합니다. 그룹 메트릭. 느린 데이터베이스 성능 과 같은 다른 문제를 분리합니다. 이 섹션에서는 앱 newrelic.js
구성 파일의 transaction_tracer: {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.
중요 거래 이름 끝에 대괄호 [suffix]
를 사용하지 마십시오. New Relic은 자동으로 이름에서 괄호를 제거합니다. 대신 필요한 경우 괄호 (suffix)
또는 기타 기호를 사용하십시오.
활성화 유형
부울
기본값
true
환경 변수
NEW_RELIC_TRACER_ENABLED
서버 측 레이블
Enable transaction tracing?
활성화되면 에이전트는 느린 트랜잭션 추적을 수집합니다.
설명_임계값 유형
정수
기본값
500
환경 변수
NEW_RELIC_EXPLAIN_THRESHOLD
트랜잭션 추적 에서 느린 쿼리 에 적합한 트랜잭션의 최소 쿼리 기간(밀리초)입니다.
레코드_sql 유형
문자열( off
, obfuscated
또는 raw
)
기본값
off
환경 변수
NEW_RELIC_RECORD_SQL
이 옵션은 느린 쿼리 와 트랜잭션 추적의 record_sql
에 모두 영향을 줍니다. off
, obfuscated
또는 raw
의 세 가지 값 중 하나를 가질 수 있습니다.
off
으로 설정하면 느린 쿼리가 캡처되지 않고 역추적 및 SQL이 트랜잭션 추적에 포함되지 않습니다. raw
또는 obfuscated
로 설정하면 에이전트는 원시 또는 난독화된 SQL과 느린 쿼리 샘플을 수집기 에 보냅니다. 에이전트는 slow_sql.enabled
이 설정된 경우와 같이 다른 기준이 충족되는 경우에도 SQL을 보낼 수 있습니다.
top_n 유형
정수
기본값
20
환경 변수
NEW_RELIC_TRACER_TOP_N
트랜잭션 추적 에 적합한 최대 요청 수를 정의합니다.
트랜잭션 이름은 요청에 따라 지정되며 top_n
은 이러한 이름으로 그룹화된 "가장 느린 트랜잭션 상위 n 개"를 나타냅니다. 모듈은 새 추적이 해당 이름의 가장 느린 이전 추적보다 느린 경우에만 기록된 추적을 새 추적으로 대체합니다. 이 설정의 기본값은 top_n: 20
입니다. 트랜잭션 페이지 도 기본적으로 20개의 가장 느린 트랜잭션으로 설정되기 때문입니다.
Node.js 에이전트는 시작 후 첫 번째 수확 주기에서 최소 5개의 서로 다른 느린 트랜잭션을 캡처합니다. 또한 지난 5번의 수확 주기 동안 느린 트랜잭션이 캡처되지 않은 경우 다른 트랜잭션을 재설정하고 캡처합니다. 이렇게 하면 해당 수집 주기에 대해 절대적으로 가장 느린 요청에 초점을 맞추지 않는 대신 앱의 요청 경로에 대해 더 많은 정보를 볼 수 있습니다.
팁 마지막 1분 동안 가장 느린 트랜잭션을 기록하려면 top_n: 0
또는 top_n: 1
을 설정할 수 있습니다. 그러나 이로 인해 하나의 매우 느린 경로가 트랜잭션 추적을 지배하게 됩니다.
transaction_threshold 유형
정수 또는 apdex_f
기본값
apdex_f
환경 변수
NEW_RELIC_TRACER_THRESHOLD
서버 측 레이블
Threshold
트랜잭션 이 트랜잭션 추적 에 적합한 시간을 초과하는 웹 트랜잭션 응답 시간의 임계값(초)입니다. 기본값은 apdex_f
입니다. 이렇게 하면 추적 임계값이 애플리케이션 Apdex T 의 4배로 설정됩니다. 특정 시간 값을 밀리초 단위로 입력할 수도 있습니다.
예: 임계값 설정 apdex_f
기본 apdex_t
은 100밀리초입니다. 트랜잭션 임계값이 apdex_f
으로 설정된 경우 "느린" 트랜잭션은 400밀리초입니다.
hide_internals 유형
부울
기본값
true
환경 변수
NEW_RELIC_HIDE_INTERNALS
에이전트는 웹 애플리케이션에 연결된 내부 속성을 숨기기 위해 소량의 CPU를 사용합니다. 이 구성을 false
으로 변경하면 에이전트 오버헤드가 약간 줄어들 수 있지만 에이전트 성능에도 영향을 미칠 수 있습니다.
속성.활성화 유형
부울
기본값
true
환경 변수
NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_ENABLED
true
인 경우 에이전트는 트랜잭션 추적에서 속성을 캡처합니다.
주의 헤더 관련 포함/제외 규칙은 필터링할 camelCase 형식이어야 합니다.
속성.제외 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_EXCLUDE
트랜잭션 추적에서 제외할 속성의 접두사입니다. 끝에 와일드카드로 *
을 허용합니다.
속성.포함 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_INCLUDE
트랜잭션 추적에 포함할 속성의 접두사입니다. 끝에 와일드카드로 *
을 허용합니다.
규칙 변수 이 섹션에서는 앱 newrelic.js
구성 파일의 rules: {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.
이름 유형
문자열 또는 정규식
기본값
(없음)
환경 변수
NEW_RELIC_NAMING_RULES
들어오는 요청 URL과 일치하고 연결된 New Relic 트랜잭션의 이름을 지정하는 쉼표로 구분된 규칙 목록입니다. 다음 형식을 사용합니다.
name: [
{pattern: 'STRING_OR_REGEX ', name: 'NAME '},
{pattern: 'STRING_OR_REGEX ', name: 'NAME '}
],
두 매개변수가 모두 필요합니다. 문자열의 경우 제어 문자를 이스케이프해야 합니다. 정규식에서 제어 문자를 이스케이프할 필요가 없습니다. 추가 속성은 무시됩니다.
정규식은 JavaScript 스타일 캡처 그룹을 지원하고 이름은 $1
스타일 대체 문자열을 사용합니다. 정규식은 일치하는 첫 번째 결과만 찾습니다. 후속 일치는 무시됩니다. 자세한 내용은 Node.js 트랜잭션 명명 API 를 참조하세요.
NEW_RELIC_NAMING_RULES
환경 변수의 경우 규칙을 쉼표로 구분된 JSON 객체 리터럴로 전달합니다.
NEW_RELIC_NAMING_RULES='{"pattern":"^t ","name":"u "},{"pattern":"^u ","name":"t "}'
무시하다 유형
문자열 또는 정규식
기본값
socket.io 롱 폴링 요청과 일치하는 정규식("^\/socket\.io\/.*\/xhr-polling/").
환경 변수
NEW_RELIC_IGNORING_RULES
에이전트가 무시할 요청 URL 목록을 정의하십시오. 문자열 또는 정규식일 수 있는 패턴으로 목록을 지정합니다.
시행_백스톱 유형
부울
기본값
true
환경 변수
NEW_RELIC_ENFORCE_BACKSTOP
활성화되면 에이전트는 다른 이름 지정 논리(예: API, 규칙 또는 측정항목 정규화 규칙)의 영향을 받지 않는 트랜잭션의 이름을 NormalizedUri/*
으로 바꿉니다. 이것을 false
로 설정하면 에이전트는 트랜잭션 이름을 Uri/path/to/resource
로 설정합니다.
트랜잭션 이벤트 변수 이 섹션에서는 앱 newrelic.js
구성 파일의 transaction_events: {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.
활성화 활성화되면 에이전트는 트랜잭션 이벤트를 New Relic으로 보냅니다. 이 이벤트 데이터에는 트랜잭션 타이밍, 트랜잭션 이름 및 사용자 정의 매개변수가 포함됩니다. 비활성화된 경우 에이전트는 이 데이터를 수집하거나 New Relic으로 보내지 않습니다.
max_samples_stored 유형
정수
기본값
10000
환경 변수
NEW_RELIC_TRANSACTION_EVENTS_MAX_SAMPLES_STORED
에이전트가 분당 수집하는 최대 이벤트 수를 정의합니다. 이 수보다 많은 경우 에이전트는 통계적 샘플링을 수집합니다.
10,000을 초과하여 구성하지 않는 것이 좋습니다. 서버는 데이터를 분당 10,000개로 제한합니다.
max_samples_stored(지원 중단됨) New Relic 수집기 와 통신할 수 없는 경우 에이전트가 저장하는 최대 이벤트 수를 정의합니다. 이전 수확 주기 의 값은 다음 수확 주기로 병합되며 이 옵션은 최대 수를 제한합니다. 이 숫자가 max_samples_per_minute
보다 큰지 확인하십시오. 예를 들어 2배로 설정합니다. 이 값을 늘리기 전에 메모리 오버헤드를 고려하십시오.
주의 이 구성은 에이전트 버전 6.0.0 및 새로운 권장 최대값부터 다른 동작을 합니다. 에이전트 버전 6.x 이상은 max_samples_stored 를 참조하세요.
max_samples_per_minute(사용 중단됨) 에이전트가 분당 수집하는 최대 이벤트 수를 정의합니다. 이 수보다 많은 경우 에이전트는 통계적 샘플링을 수집합니다.
주의 이 구성은 에이전트 버전 6.0.0부터 max_samples_stored로 대체되었습니다. 6.x 이상의 에이전트는 max_samples_stored 를 참조하세요.
속성.활성화 유형
부울
기본값
true
환경 변수
NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_ENABLED
true
인 경우 에이전트는 트랜잭션 이벤트에서 속성을 캡처합니다.
주의 헤더 관련 포함/제외 규칙은 필터링할 camelCase 형식이어야 합니다.
속성.제외 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_EXCLUDE
트랜잭션 이벤트에서 제외할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
속성.포함 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_INCLUDE
트랜잭션 이벤트에 포함할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
브라우저 모니터링 변수 이 섹션에서는 앱 newrelic.js
구성 파일의 browser_monitoring: {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다.
디버그 유형
부울
기본값
false
환경 변수
NEW_RELIC_BROWSER_MONITOR_DEBUG
true
인 경우 서버에서 축소되지 않은 소스를 요청합니다.
속성.활성화 유형
부울
기본값
false
환경 변수
NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLED
true
인 경우 에이전트는 브라우저 모니터링에 사용자 정의 속성을 보냅니다.
주의 헤더 관련 포함/제외 규칙은 필터링할 camelCase 형식이어야 합니다.
속성.제외 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_EXCLUDE
브라우저 모니터링에서 제외할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
속성.포함 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_INCLUDE
브라우저 모니터링에 포함할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
맞춤 이벤트 변수 이 섹션에서는 앱 newrelic.js
구성 파일의 custom_insights_events: {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다. 현재 사용자 정의 이벤트에 대한 환경 변수가 없습니다.
max_samples_stored 유형
정수
기본값
1000
환경 변수
NEW_RELIC_CUSTOM_INSIGHTS_EVENTS_MAX_SAMPLES_STORED
에이전트가 분당 수집하는 최대 사용자 지정 이벤트 수를 정의합니다. 사용자 지정 이벤트 수가 이 제한을 초과하면 에이전트는 통계적 샘플링을 수집합니다.
중요 이 제한을 늘리면 메모리 사용량이 늘어납니다.
느린 쿼리 변수 이 섹션에서는 앱 newrelic.js
구성 파일의 slow_sql: {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다. 이러한 옵션은 느린 쿼리의 동작을 제어하지만 트랜잭션 추적의 SQL 노드에는 영향을 주지 않습니다.
max_samples 유형
정수
기본값
10
환경 변수
NEW_RELIC_MAX_SQL_SAMPLES
에이전트가 분당 수집하는 느린 쿼리의 최대 수를 정의합니다. 에이전트는 제한에 도달한 후 추가 쿼리를 삭제합니다.
중요 이 제한을 늘리면 메모리 사용량이 늘어납니다.
사용자 정의 호스트 이름 변수 이 섹션에서는 앱 newrelic.js
구성 파일의 process_host: {
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다. 이러한 옵션은 APM UI의 호스트 표시 이름과 관련된 동작을 제어합니다.
이름 표시하기 유형
255바이트 이하의 문자열
기본값
(없음)
환경 변수
NEW_RELIC_PROCESS_HOST_DISPLAY_NAME
New Relic 에 표시 할 사용자 지정 호스트 이름을 지정합니다. 이 필드를 설정하지 않으면 New Relic은 os.hostname()
을(를) 호출하여 찾은 기본 호스트 이름을 계속 사용합니다.
기본 호스트 이름 설정을 사용하는 경우 New Relic은 os.hostname()
을 통해 호스트 이름을 찾습니다. 이 호출이 실패하면 New Relic은 호스트의 IP를 이름으로 사용합니다. ipv_preference: 4
또는 ipv_preference: 6
을 설정하면 New Relic UI에 표시되는 IP 주소 유형(IPv4 또는 IPv6)을 선택할 수 있습니다.ipv_preference 유형
정수( 4
또는 6
)
기본값
4
환경 변수
NEW_RELIC_IPV_PREFERENCE
환경 변수 재정의 이 섹션에서는 환경 변수에만 사용할 수 있는 두 가지 구성 옵션을 정의합니다. 이러한 재정의는 대부분의 구성에서 사용되지 않습니다.
NEW_RELIC_HOME newrelic.js
이 포함된 디렉토리 경로입니다. 이것은 환경 변수로만 사용할 수 있습니다. 구성 파일에서 설정할 수 없습니다.
NEW_RELIC_NO_CONFIG_FILE 사용하는 경우 에이전트가 newrelic.js
에서 구성 설정을 읽는 것을 방지합니다. 환경 변수의 기본값과 값은 계속 설정됩니다.
이것은 환경 변수로만 사용할 수 있습니다. 구성 파일에서 설정할 수 없습니다.
데이터 저장소 추적기 변수 이 섹션에서는 앱 newrelic.js
구성 파일의 datastore_tracer
섹션에 일반적으로 나타나는 순서대로 Node.js 에이전트 변수를 정의합니다. 이러한 옵션은 데이터 저장소 인스턴스 측정항목을 수집하기 위한 동작을 제어합니다.
instance_reporting.enabled 활성화되면 에이전트는 일부 데이터베이스 드라이버 에 대한 데이터 저장소 인스턴스 메트릭(예: 호스트 및 포트)을 수집합니다. 이는 느린 쿼리 추적 및 트랜잭션 추적에 대해 보고됩니다.
database_name_reporting.enabled 활성화되면 에이전트는 일부 데이터베이스 드라이버 에 대한 느린 쿼리 추적 및 트랜잭션 추적에서 데이터베이스 이름을 수집합니다.
교차 애플리케이션 추적(지원 중단됨) 교차 애플리케이션 추적 을 제어하는 Node.js 에이전트 변수는 일반적으로 앱 newrelic.js
구성 파일의 cross_application_tracer
섹션에 나타납니다.
활성화 true
으로 설정하면 둘 이상의 New Relic 모니터링 애플리케이션에서 트랜잭션을 추적할 수 있습니다.
중요 CAT(교차 응용 프로그램 추적)은 더 이상 사용되지 않으며 향후 주요 릴리스에서 제거될 예정입니다. 서비스 간 가시성을 위해 에이전트 버전 8.3.0부터 기본적으로 활성화된 분산 추적 을 사용하는 것이 좋습니다. 활성화하기 전에 전환 가이드 를 읽으십시오.
오류 메시지 수정 변수 오류 메시지 수정을 제어하는 Node.js 에이전트 변수는 앱 newrelic.js
구성 파일의 allow_raw_exception_messages
섹션에 나타납니다.
활성화 유형
부울
기본값
true
환경 변수
NEW_RELIC_ALLOW_RAW_EXCEPTION_MESSAGES_ENABLED
false
일 때 에이전트는 캡처된 오류의 메시지를 수정합니다.
분산 추적 분산 추적을 사용하면 분산 시스템을 통해 이동하는 요청의 경로를 볼 수 있습니다. 구성 파일을 통해 구성할 때 distributed_tracing
섹션에 다음 옵션을 배치합니다.
활성화 유형
부울
기본값
true
환경 변수
NEW_RELIC_DISTRIBUTED_TRACING_ENABLED
분산 추적을 활성화하려면 이것을 true
으로 설정하십시오.
예를 들어 구성 파일에서 이를 활성화하려면 다음을 사용합니다.
아웃바운드 요청에 첨부된 New Relic 헤더를 제외하고 대신 분산 추적을 위해 W3C 추적 컨텍스트 헤더에만 의존하려면 이것을 true
으로 설정합니다. 이것이 false
이면 두 가지 유형의 헤더가 모두 사용됩니다.
예를 들어 구성 파일에서 이를 활성화하려면 다음을 사용합니다.
exclude_newrelic_header: true
스팬 이벤트 분산 추적 에 대해 스팬 데이터 가 보고됩니다. 범위를 보고하려면 분산 추적을 활성화해야 합니다. 스팬 구성은 span_events
스탠자에서 설정됩니다. 옵션에는 다음이 포함됩니다.
활성화 유형
부울
기본값
true
환경 변수
NEW_RELIC_SPAN_EVENTS_ENABLED
스팬 이벤트 보고를 켜거나 끕니다.
속성.활성화 유형
부울
기본값
true
환경 변수
NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_ENABLED
이 설정을 사용하여 범위에 대한 속성 보고를 켜거나 끌 수 있습니다. 루트 수준의 attributes.enabled
이 false
이면 설정 방법에 관계없이 스팬과 함께 속성이 전송되지 않습니다.
속성.포함 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_INCLUDE
스팬에 대해 속성이 활성화된 경우 이 목록에 있는 모든 속성 키가 스팬에 연결됩니다. 자세한 내용은 에이전트 속성 규칙 을 참조하십시오.
속성.제외 유형
정렬
기본값
[]
환경 변수
NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_EXCLUDE
이 목록에 있는 모든 속성 키는 범위와 함께 전송되지 않습니다. 자세한 내용은 에이전트 속성 규칙 을 참조하십시오.
max_samples_stored 유형
정수
기본값
2000 년
환경 변수
NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED
에이전트가 분당 수집하는 최대 이벤트 수를 정의합니다. 이 수보다 많은 경우 에이전트는 통계적 샘플링을 수집합니다.
10k를 초과하여 구성하지 않는 것이 좋습니다. 서버는 데이터를 분당 10,000개로 제한합니다.
무한 추적 무한 추적을 켜려면 분산 추적을 활성화하고( distributed_tracing
를 enabled: true
로 설정) 아래에 추가 설정을 추가합니다. 예를 보려면 언어 에이전트: 분산 추적 구성 을 참조하세요.
trace_observer.host 유형
문자열
기본값
(none)
환경 변수
NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOST
유효한 무한 추적 추적 관찰자 호스트 항목을 가져오는 데 도움이 필요 하면 추적 관찰자 끝점 찾기 또는 만들기 를 참조하세요.
애플리케이션 로깅 application_logging.enabled application_logging.metrics.enabled 유형
부울
기본값
true
환경 변수
NEW_RELIC_APPLICATION_LOGGING_METRICS_ENABLED
에이전트가 APM 요약 페이지의 로그 차트에 사용된 로깅 메트릭을 수집할지 여부를 토글합니다.
application_logging.forwarding.enabled 유형
부울
기본값
false
환경 변수
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_ENABLED
에이전트가 New Relic에 보낼 로그 레코드를 수집할지 여부를 토글합니다.
application_logging.forwarding.max_samples_stored 유형
숫자
기본값
10000
환경 변수
NEW_RELIC_APPLICATION_LOGGING_FORWARDING_MAX_SAMPLES_STORED
New Relic에 분당 보낼 로그 레코드 수입니다. 로그 전달을 사용할 때 전체 메모리 소비를 제어합니다.
application_logging.local_decorating.enabled 유형
부울
기본값
false
환경 변수
NEW_RELIC_APPLICATION_LOGGING_LOCAL_DECORATING_ENABLED
에이전트가 표준 로그 출력에서 로컬 로그 장식을 수행할지 여부를 토글합니다.