New Relic Ruby 에이전트는 구성 파일의 설정, 환경 변수를 사용하거나 서버 측 구성을 사용하여 프로그래밍 방식으로 구성할 수 있습니다. 이 문서는 Ruby 에이전트에 사용할 수 있는 구성 옵션을 요약합니다.
구성 옵션의 기본값이 (Dynamic)
이면 Ruby 에이전트가 런타임에 기본값을 계산한다는 의미입니다. 구성 설정 값은 기본적으로 다른 설정 값으로 적절하게 설정됩니다.
구성 방법 및 우선 순위
Ruby 에이전트를 구성하는 기본(기본) 방법은 config
하위 디렉토리의 구성 파일( newrelic.yml
)을 사용하는 것입니다. 환경 변수를 사용하여 구성 값을 설정하려면:
- 설정 이름에 접두사
NEW_RELIC_
을 추가합니다. - 마침표
.
를 밑줄_
로 바꿉니다.
서버 측 구성 을 통해 UI에서 몇 가지 값을 구성할 수도 있습니다.
Ruby 에이전트는 구성에 대해 다음과 같은 우선 순위를 따릅니다.
- 환경 변수
- 서버 측 구성
- 구성 파일(
newrelic.yml
) - 기본 구성 설정
즉, 환경 변수는 다른 모든 구성 설정 및 정보를 재정의하고 서버 측 구성은 구성 파일 및 기본 구성 설정을 재정의하는 식입니다.
구성 파일 옵션 보기 및 편집
Ruby 에이전트의 newrelic.yml
은 표준 YAML 구성 파일입니다. 일반적으로 상단에는 Defaults
섹션이 있고 아래에는 각 애플리케이션 환경에 대한 섹션이 포함됩니다. 예: Development
, Testing
및 Production
.
Ruby 에이전트는 특정 환경 변수를 확인하여 애플리케이션 환경을 파생하여 읽을 newrelic.yml
구성 파일의 섹션을 결정합니다. 이는 예를 들어 프로덕션 환경에서 log_level
구성 설정에 info
을 사용하고 개발 환경에서 debug
와 같이 더 자세한 log_level
구성 설정을 원할 때 유용할 수 있습니다.
다음은 newrelic.yml
구성 파일의 예입니다.
common: &default_settings license_key: 'YOUR_LICENSE_KEY' app_name: 'My Application Name'production: <<: *default_settings log_level: infodevelopment: <<: *default_settings log_level: debug
비 Rails 앱의 경우 Ruby 에이전트는 다음 환경 변수를 순서대로 검색하여 애플리케이션 환경을 결정합니다.
NEW_RELIC_ENV
RUBY_ENV
RAILS_ENV
APP_ENV
RACK_ENV
Ruby 에이전트가 이러한 환경 변수의 값을 감지하지 못하면 애플리케이션 환경을 기본적으로 development
으로 설정하고 newrelic.yml
구성 파일의 development
섹션에서 읽습니다.
Rails 앱에서 Ruby 에이전트를 실행할 때 에이전트는 먼저 NEW_RELIC_ENV
환경 변수를 찾아 애플리케이션 환경과 사용할 newrelic.yml
섹션을 결정합니다. NEW_RELIC_ENV
가 없으면 에이전트는 Rails 환경( Rails 버전에 따라 RAILS_ENV
또는 RAILS.env
)을 사용합니다.
구성 파일을 편집할 때 다음을 확인하십시오.
두 개의 공백으로만 들여쓰기합니다.
error_collector
과 같은 섹션에서 관련 있는 경우에만 들여쓰기합니다.
들여쓰기를 올바르게 하지 않으면 에이전트가 시작될 때 Unable to parse configuration file
오류가 발생할 수 있습니다.
사용 가능한 Ruby 에이전트 구성 옵션의 최신 목록을 보려면 rake newrelic:config:docs
명령을 사용합니다. 이 문서에서는 가장 일반적인 옵션에 대해 설명합니다.
구성 파일 업데이트
이 문서는 Ruby 에이전트의 최신 릴리스에 적용됩니다. 이전 버전에 대한 자세한 내용은 newrelic.yml
자체의 주석을 참조하세요.
새 릴리스 이후에 newrelic.yml
파일을 업데이트하려면 에이전트 gem의 기본 디렉토리에 있는 템플릿을 사용하세요. 새 gem 버전으로 업데이트할 때 설치 디렉토리 에서 config/newrelic.yml
및 newrelic.yml
를 검사하거나 비교하여 새 구성 옵션을 활용하십시오.
중요
gem을 업데이트해도 config/newrelic.yml
은 자동으로 업데이트되지 않습니다.
일반적인
이러한 설정은 에이전트 구성에 사용할 수 있습니다. 일부 설정은 New Relic 구독 수준에 따라 다릅니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 Ruby 에이전트 실행을 허용합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
귀하의 뉴렐릭 .
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
로그 메시지의 세부 수준을 설정합니다. 가능한 로그 수준은 error
, warn
, info
또는 debug
입니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
구독하고 계측할 ActiveSupport 사용자 지정 이벤트 이름의 배열입니다. 예를 들어,
- 원.커스텀.이벤트
- 다른 이벤트
- a.세 번째.이벤트
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
귀하의 블루베리 . 뉴렐릭 REST API v2를 사용하여 구현을 기록하고 newrelic deployments
명령을 사용하여 배포할 때 필요합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
Rails 6에 도입된 보다 빠른 ActiveRecord 연결 조회를 백포트하여 ActiveRecord를 계측할 때 에이전트 성능을 향상시킵니다. 이 설정은 ActiveRecord를 패치하는 다른 gem과 호환되지 않을 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
로컬 CA 번들에 대한 경로를 수동으로 재정의합니다. 이 CA 번들은 New Relic의 데이터 수집 서비스에서 제공하는 SSL 인증서를 확인하는 데 사용됩니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
트랜잭션 추적에서 Memcache 키 캡처를 활성화하거나 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 HTTP 요청 매개변수를 캡처하여 트랜잭션 추적, 추적된 오류 및 TransactionError
이벤트 에 연결합니다.
주의
capture_params
설정을 사용할 때 Ruby 에이전트는 비밀 정보를 필터링하려고 시도하지 않습니다. Recommendation:
요청 매개변수에서 비밀 정보를 필터링하려면 대신 attributes.include
설정을 사용하십시오. 자세한 내용은 Ruby 속성 예제를참조하십시오.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 에이전트는 Agent.drop_buffered_data
}에서 { Tracer::State
을 지웁니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
newrelic.yml
에 대한 경로입니다. 정의되지 않은 경우 에이전트는 다음 디렉터리를 순서대로 확인합니다.
config/newrelic.yml
newrelic.yml
$HOME/.newrelic/newrelic.yml
$HOME/newrelic.yml
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
아웃바운드 요청에서 newrelic 분산 추적 헤더를 억제할 수 있습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
일반적으로 설치되어서는 안 되는 시나리오를 감지하는 것과 상관없이 종료하기 전에 모든 캐시된 데이터를 수집기로 보내는 종료 처리기를 강제로 설치합니다. 이 옵션의 알려진 사용 사례는 Sinatra가 다른 프레임워크 내에서 포함된 서비스로 실행되고 에이전트가 Sinatra 앱을 감지하고 결과적으로 at_exit
핸들러를 건너뛰는 경우입니다. Sinatra는 일반적으로 at_exit
블록에서 전체 애플리케이션을 실행하며 에이전트의 at_exit
핸들러도 이러한 상황에 설치된 경우 오작동합니다. 참고: send_data_on_exit
도 이 설정과 함께 true
로 설정해야 합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 높은 보안 모드 를 활성화합니다. 이 설정을 활성화하기 전에 높은 보안 모드의 의미를 이해했는지 확인하십시오.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
이 에이전트에서 보낸 데이터에 적용할레이블 이름 및 값의 사전입니다. 콜론으로 구분된 :
쌍의 세미콜론으로 구분된 ;
문자열로 표현될 수도 있습니다. 예를 들어, Server:One;Data Center:Primary
.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
로그 파일의 이름을 정의합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
파일 이름을 제외한 에이전트 로그 파일의 경로를 정의합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
New Relic 수집기 에 데이터를 전송하기 위한 마샬러를 지정합니다. 현재 이 설정에 유효한 값은 json
뿐입니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
일 때 에이전트는 앱에 대한 데이터를 New Relic 수집기 로 전송합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 ActiveRecord 계측에 alias_method
대신 Module#prepend
을 사용합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
프록시 서버를 통해 New Relic 수집기 와 통신하기 위한 호스트를 정의합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
프록시 서버를 통해 New Relic 수집기 와 통신하기 위한 암호를 정의합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
프록시 서버를 통해 New Relic 수집기 와 통신하기 위한 포트를 정의합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
프록시 서버를 통해 New Relic 수집기 와 통신하기 위한 사용자를 정의합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
언어 에이전트 보안 정책 설정을 적용합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 종료하기 전에 New Relic 수집기 로 데이터를 보내는 종료 핸들러를 활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
으로 설정하면 애플리케이션 시작 중에 New Relic 수집기 에 대한 동기 연결을 강제 실행합니다. 수명이 매우 짧은 프로세스의 경우 New Relic 에이전트가 보고할 시간을 확보하는 데 도움이 됩니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 트레이서 상태 저장소는 스레드 로컬이고, 그렇지 않으면 파이버 로컬입니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 수집기에 연결을 시도하는 데 소비해야 하는 최대 시간(초)을 정의합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 모든 대상에 대한 모든 HTTP 요청 헤더의 캡처를 활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트가 Ruby on Rails를 사용하는 애플리케이션에 있을 때 config/initializers
실행 후에 시작됩니다.
주의
이 옵션은 환경 변수로만 설정할 수 있습니다.
트랜잭션 추적기
트랜잭션 추적 기능은 호출 순서 요약, 소요 시간 분석, SQL 쿼리 목록 및 쿼리 계획(mysql 및 postgresql에서)을 포함하여 선택한 트랜잭션에서 자세한 정보를 수집합니다. 사용 가능한 기능은 New Relic 구독 수준에 따라 다릅니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 트랜잭션 추적 수집을 활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 트랜잭션 추적에서 계획 설명 수집을 활성화합니다. 이 설정은 slow_sql.explain_enabled
이 별도로 설정되지 않은 경우 느린 SQL 추적의 설명 계획에도 적용됩니다.
유형 | 뜨다 |
---|---|
기본값 |
|
환경 변수 |
|
상담원이 설명 계획을 수집할 임계값(초)입니다. explain_enabled
이 true인 경우에만 관련이 있습니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
단일 트랜잭션 추적에 기록할 최대 트랜잭션 추적 노드 수입니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 트랜잭션 추적에 Redis 명령 인수를 기록합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
트랜잭션 추적 노드에서 보고된 SQL 쿼리의 난독화 수준입니다.
기본적으로 이것은 숫자 및 문자열 리터럴을 제거하는 obfuscated
으로 설정됩니다.
- 에이전트가 쿼리 정보를 캡처하지 않도록 하려면 이것을
none
으로 설정하십시오. - 에이전트가 모든 쿼리 정보를 원래 형식으로 캡처하도록 하려면 이를
raw
으로 설정합니다. - 높은 보안 모드 를 활성화하면 자동으로
obfuscated
으로 설정됩니다.
유형 | 뜨다 |
---|---|
기본값 |
|
환경 변수 |
|
임계값을 초 단위로 지정하십시오. 스택 추적 기간이 이 임계값을 초과하면 에이전트가 트랜잭션 추적 노드에 스택 추적을 포함합니다.
유형 | 뜨다 |
---|---|
기본값 |
|
환경 변수 |
|
임계값을 초 단위로 지정하십시오. 기간이 이 임계값보다 긴 트랜잭션은 트랜잭션 추적에 적합합니다. 부동 소수점 값 또는 문자열 apdex_f
을 지정하십시오.
오류 수집기
에이전트는 기본적으로 잡히지 않는 모든 예외를 수집하고 보고합니다. 이러한 구성 옵션을 사용하면 오류 수집을 사용자 지정할 수 있습니다.
무시되고 예상되는 오류에 대한 정보 는 APM의 오류 분석 페이지를 참조하십시오 . NewRelic::Agent.notice_error
Ruby 메서드를 통해 예상되는 오류를 설정하려면 Ruby Agent API를 참조하세요 .
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 무시해야 하는 오류 클래스 목록입니다.
주의
이 옵션은 환경 변수를 통해 설정할 수 없습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 TransactionError
이벤트를수집합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 추적된 오류 및 오류 수 측정항목을 캡처합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 예상대로 처리해야 하는 오류 클래스 목록입니다.
주의
이 옵션은 환경 변수를 통해 설정할 수 없습니다.
유형 | 해시시 |
---|---|
기본값 |
|
환경 변수 |
|
메시지 목록에 대한 오류 클래스 맵. 여기에 지정된 클래스 중 하나의 오류가 발생할 때 오류 메시지에 여기에 해당하는 문자열 중 하나가 포함되어 있으면 해당 오류는 예상대로 처리됩니다.
주의
이 옵션은 환경 변수를 통해 설정할 수 없습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
범위를 포함할 수 있는 상태 코드의 쉼표로 구분된 목록입니다. 해당되는 경우 이러한 상태 코드와 관련된 오류는 예상대로 처리됩니다.
유형 | 해시시 |
---|---|
기본값 |
|
환경 변수 |
|
메시지 목록에 대한 오류 클래스 맵. 여기에 지정된 클래스 중 하나의 오류가 발생할 때 오류 메시지에 여기에 해당하는 문자열 중 하나가 포함되어 있으면 해당 오류는 무시됩니다.
주의
이 옵션은 환경 변수를 통해 설정할 수 없습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
범위를 포함할 수 있는 상태 코드의 쉼표로 구분된 목록입니다. 해당되는 경우 이러한 상태 코드와 관련된 오류는 무시됩니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
오류 역추적의 최대 프레임 수를 정의합니다. 이 양을 초과하는 역추적은 스택 추적의 시작과 끝을 유지하면서 중간이 잘립니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
수집 주기당 보고되는 최대 TransactionError
이벤트 수를 정의합니다.
AI 모니터링
이 섹션에는 AI 시뮬레이션 설정을 위한 루비 에이전트 설정이 포함되어 있습니다.
중요
추적 및 피드백 데이터를 캡처하려면 제외 추적을 활성화해야 합니다. 루비 에이전트 8.0.0 이상에서는 기본적으로 켜져 있습니다.
유형 | 부울 |
---|---|
기본값 |
|
|
true
으로 설정하면 AI 모니터링이 활성화됩니다.
유형 | 문자열 |
---|---|
기본값 |
|
|
높은 보안 모드에서는 기본값이
false
입니다.앱을 재충전하기 위한 에이전트를 활성화합니다. 모듈 앞에는
prepend
지원하고 별칭 메서드 체인에는chain
지원합니다.- 루비 에이전트는 기본적으로
prepend
사용합니다. - 동일한 클래스를 업데이트하는 라이브러리가 여러 개 있는 경우 이 설정을
chain
으로 업데이트할 수 있습니다.
- 루비 에이전트는 기본적으로
유형 | 부울 |
---|---|
기본값 |
|
|
false
으로 설정하면 에이전트는 LLM 이벤트에서 캡처된 입력 및 출력 콘텐츠(예: 프롬프트 및 응답의 텍스트 문자열)를 생략합니다.LlmChatCompletionMessage
이벤트에서content
속성을 삭제합니다.LlmEmbedding
이벤트에서input
속성을 삭제합니다.
LLM과 주고받는 민감한 데이터를 기록하지 않으려는 경우 선택적인 보안 설정입니다.
브라우저 모니터링
페이지 로드 타이밍 기능(실 사용자 모니터링 또는 RUM 이라고도 함)은 실제 사용자가 웹사이트에서 경험하고 있는 성능에 대해 인사이트를 제공합니다. 이는 각 페이지의 머리글과 바닥글에 소량의 JavaScript 코드를 삽입하여 사용자 브라우저가 웹 페이지를 다운로드하고 렌더링하는 데 걸리는 시간을 측정함으로써 수행됩니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 페이지 로드 타이밍(실제 사용자 모니터링 또는 RUM이라고도 함)에 대한 JavaScript 헤더 자동 삽입 을 활성화합니다.
거래 이벤트
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 트랜잭션 이벤트 샘플링을 활성화합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
단일 수집에서 보고되는 최대 트랜잭션 이벤트 수를 정의합니다.
애플리케이션 로깅
Ruby 에이전트는 컨텍스트에서 APM 로그를 지원합니다. Ruby 에이전트에 대한 로그 구성에 대한 몇 가지 팁 은 컨텍스트에서 Ruby 로그 구성 을 참조하십시오.
사용 가능한 로깅 관련 구성 옵션은 다음과 같습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 로그 장식과 로그 이벤트 및 측정항목 수집을 활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 애플리케이션에서 내보낸 로그 레코드를 캡처합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
로그 이벤트가 New Relic으로 전달되어야 하는 최소 수준을 설정합니다.
이는 Ruby의 Logger::Severity
상수( https://github.com/ruby/ruby/blob/master/lib/logger/severity.rb)의 정수 값을 기반으로 합니다.
의도는 구성에 지정된 수준의 로그와 더 높은 수준의 심각도를 가진 로그를 전달하는 것입니다.
예를 들어 이 값을 "debug"로 설정하면 모든 로그 이벤트가 New Relic으로 전달됩니다. 이 값을 "오류"로 설정하면 "오류", "치명적" 및 "알 수 없음" 수준의 로그 이벤트만 전달됩니다.
유효한 값(가장 낮은 순서대로):
- "디버그"
- "정보"
- "경고하다"
- "오류"
- "치명적인"
- "알려지지 않은"
유형 | 해시시 |
---|---|
기본값 |
|
환경 변수 |
|
New Relic으로 전달되는 모든 로그 이벤트에 사용자 지정 속성으로 추가할 키/값 쌍이 있는 해시입니다. 환경 변수를 사용하여 보내는 경우 값은 "key1=value1,key2=value2"와 같은 형식이어야 합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
한 번에 메모리에 버퍼링할 최대 로그 레코드 수를 정의합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 항목, 호스트, 추적 및 범위에 연결하기 위해 메타데이터로 로그를 장식합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 애플리케이션의 로깅과 관련된 측정항목을 캡처합니다.
AI 모니터링
이 섹션에는 AI 시뮬레이션 설정을 위한 루비 에이전트 설정이 포함되어 있습니다.
중요
추적 및 피드백 데이터를 캡처하려면 제외 추적을 활성화해야 합니다. 루비 에이전트 8.0.0 이상에서는 기본적으로 켜져 있습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
false
인 경우 모든 LLM 측정, 로그(현재는 OpenAI만 해당)가 비활성화되고 지표, 이벤트 또는 범위가 전송되지 않습니다. high_security
모드가 활성화되면 AI 모니터링이 자동으로 비활성화됩니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
false
인 경우 LLM 측정, 로그(현재 OpenAI만 해당)는 특정 LLM 이벤트의 입력 및 출력 콘텐츠를 캡처하지 않습니다.
제외되는 속성은 다음과 같습니다.
content
LlmChatCompletionMessage 이벤트에서input
LlmEmbedding 이벤트에서
속성
속성 은 이벤트 또는 트랜잭션의 속성을 결정하는 정보를 포함하는 키-값 쌍입니다. 이러한 키-값 쌍은 APM의 트랜잭션 추적, APM의 추적된 오류, 대시보드의 트랜잭션 이벤트 및 대시보드의 페이지 보기 내에서 볼 수 있습니다. 이러한 각 대상으로 보낼 속성을 정확히 사용자 지정할 수 있습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 모든 대상에 대한 속성 캡처를 활성화합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
모든 대상에서 제외할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
모든 대상에 포함할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 브라우저 모니터링에서 속성을 캡처합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
브라우저 모니터링에서 제외할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
브라우저 모니터링에 포함할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 오류 수집에서 속성을 캡처합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
오류 수집에서 제외할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
오류 수집에 포함할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 스팬 이벤트에서 속성을 캡처합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
범위 이벤트에서 제외할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
스팬 이벤트에 포함할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 트랜잭션 이벤트에서 속성을 캡처합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
트랜잭션 이벤트에서 제외할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
트랜잭션 이벤트에 포함할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 트랜잭션 세그먼트의 속성을 캡처합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
트랜잭션 세그먼트에서 제외할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
트랜잭션 세그먼트에 포함할 속성의 접두사. 끝에 와일드카드로 *
을 허용합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 트랜잭션 추적에서 속성을 캡처합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
트랜잭션 추적에서 제외할 속성의 접두사입니다. 끝에 와일드카드로 *
을 허용합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
트랜잭션 추적에 포함할 속성의 접두사입니다. 끝에 와일드카드로 *
을 허용합니다.
감사 로그
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 New Relic 수집기 와의 통신을 기록하는 감사 로그를 활성화합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
감사 로그에 포함할 수 있는 엔드포인트 목록입니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
감사 로그 파일의 경로를 지정합니다(파일 이름 포함).
자동 시작
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 자동으로 시작되지 않도록 해야 하는 상수 목록을 지정하십시오. 쉼표 ,
로 개별 상수를 구분합니다. 예: "Rails::Console,UninstrumentedBackgroundJob"
.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 계측하지 않아야 하는 실행 파일의 쉼표로 구분된 목록을 정의합니다. 예: "rake,my_ruby_script.rb"
.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 계측해서는 안 되는 Rake 작업의 쉼표로 구분된 목록을 정의합니다. 예: "assets:precompile,db:migrate"
.
코드 수준 메트릭
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 추적된 메서드에 대한 소스 코드 수준 메트릭을 보고합니다. 참조: https://docs.newrelic.com/docs/apm/agents/ruby-agent/features/ruby-codestream-integration/
받은편지함 구성 오류
다음 태그 중 하나를 설정하면 오류를 생성하는 소프트웨어 버전을 식별하는 데 도움이 됩니다.
NEW_RELIC_METADATA_SERVICE_VERSION
배포된 코드 버전(대부분의 경우 1.2.3과 같은 의미 버전)이 포함된 이벤트 데이터에 대한 tagged.service.version을 생성하지만 항상 그런 것은 아닙니다.NEW_RELIC_METADATA_RELEASE_TAG
릴리스 태그(예: v0.1.209)가 포함된 이벤트 데이터에 tagged.releaseTag를 생성합니다. 또는 릴리스-209).NEW_RELIC_METADATA_COMMIT
커밋 샤를 포함하는 이벤트 데이터에 대한 tagged.commit을 생성합니다. 전체 sha를 사용하거나 처음 7자만 사용할 수 있습니다(예: 734713b).
향후 릴리스된 오류 받은 편지함에서는 오류를 생성하는 소프트웨어 버전을 자동으로 추적합니다. 모든 버전 데이터는 CodeStream 에도 표시됩니다.
교차 애플리케이션 추적기
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
DEPRECATED Distributed_tracing.enabled 를 참조하세요.
true
이면 distributed_tracing.enabled
이 false
로 설정될 때 교차 애플리케이션 추적 을 활성화합니다.
사용자 정의 속성
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
false
이면 이벤트에 대해 사용자 정의 속성이 전송되지 않습니다.
맞춤 이벤트
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 에이전트가 맞춤 이벤트 를 캡처합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
- 한 번에 메모리에 버퍼링할 최대 사용자 지정 이벤트 수를 지정합니다.
- AI 모니터링 용 에이전트를 구성할 때 최대값
100000
으로 설정하세요. 에이전트가 LLM 이벤트의 최대량을 캡처하는지 확인합니다.
데이터 저장소 추적기
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
false
인 경우 에이전트는 트랜잭션 또는 느린 SQL 추적에 database_name
매개변수를 추가하지 않습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
false
인 경우 에이전트는 데이터 저장소 인스턴스 측정항목을 보고하지 않으며 트랜잭션 또는 느린 SQL 추적에 host
또는 port_path_or_id
매개변수를 추가하지 않습니다.
비활성화
이 설정을 사용하여 에이전트 시작 중에 계측 유형을 전환합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 작업 케이블 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 액션 컨트롤러 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 작업 사서함 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 Action Mailer 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 활성 작업 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 활성 스토리지 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 활성 지원 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 활성 레코드 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 Active Record 4+에 대한 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 호스트 프로세스의 CPU 사용량을 샘플링하지 않습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 지연된 작업 대기열의 깊이를 측정하지 않습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 가비지 수집에 소요된 시간을 측정하기 위해 GC::Profiler
사용을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 호스트 프로세스의 메모리 사용량을 샘플링하지 않습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 계측에서 타사 미들웨어를 래핑하지 않습니다( Rack::Builder
또는 Rails를 통해 설치되었는지 여부에 관계없음).
중요
미들웨어 계측이 비활성화된 경우 애플리케이션이 응답 코드를 변경할 수 있는 미들웨어를 사용하는 경우 트랜잭션에 보고된 HTTP 상태 코드는 변경된 값을 반영하지 않을 수 있습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 샘플러 측정항목 수집을 비활성화합니다. 샘플러 메트릭은 이벤트 기반이 아닌 메트릭입니다(예: CPU 시간 또는 메모리 사용량).
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 Sequel 계측 을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 Sidekiq 계측 을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 Roda용 에이전트 미들웨어를 비활성화합니다. 이 미들웨어는 page load timing [페이지 로드 타이밍] 및 error collection [오류 수집] 과 같은 고급 기능 지원을 담당합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 Sinatra용 에이전트 미들웨어를 비활성화합니다. 이 미들웨어는 애플리케이션 간 추적 , 페이지 로드 타이밍 및 오류 수집 과 같은 고급 기능 지원을 담당합니다.
중요
분산 추적 을 위해 교차 응용 프로그램 추적은 더 이상 사용되지 않습니다. 분산 추적은 Ruby 에이전트 버전 8.0.0 이상에서 기본적으로 켜져 있습니다. 분산 추적을 지원하는 데 미들웨어가 필요하지 않습니다.
교차 애플리케이션 추적을 계속 사용하려면 newrelic.yml
구성 파일에서 다음 옵션을 업데이트하세요.
# newrelic.yml
cross_application_tracer: enabled: true distributed_tracing: enabled: false
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 보기 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Ruby VM에서 성능 측정을 샘플링 하지 않습니다.
분산 추적
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
분산 추적을 사용하면 요청이 분산 시스템을 통과하는 경로를 볼 수 있습니다. 분산 추적을 활성화하면 일부 New Relic 기능의 동작이 변경되므로 이 기능을 활성화하기 전에 전환 가이드 를 주의 깊게 참조하십시오.
엘라스틱서치
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 트랜잭션 추적에서 Elasticsearch 쿼리를 캡처합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 트랜잭션 추적에서 Elasticsearch 쿼리를 난독화합니다.
헤로쿠
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Heroku dyno 이름을 호스트 이름으로 사용합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
일반적으로 에이전트는 뒤에 점과 프로세스 ID가 있는 dyno 이름을 보고합니다(예: worker.3
). 후행 데이터 없이 보고할 접두사를 지정하여 이 후행 데이터를 제거할 수 있습니다(예: worker
).
무한 추적
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
추적 관찰자 호스트의 호스트 이름을 구성합니다. 구성된 경우 일반적인 에이전트 샘플링 결정에 관계없이 추가 샘플링 결정을 위해 추적 관찰자에게 기록된 모든 범위를 전송하여 테일 기반 샘플링을 활성화합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
추적 관찰자 호스트에 대한 TCP/IP 포트를 구성합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
(기본값)인 경우 추적 관찰자에게 전송된 데이터는 각 범위를 개별적으로 전송하는 대신 일괄 처리됩니다.
유형 | 상징 |
---|---|
기본값 |
|
환경 변수 |
|
추적 관찰자에게 전송되는 데이터의 압축 수준을 구성합니다.
:none
, :low
, :medium
, :high
중 하나일 수 있습니다.
압축을 비활성화하려면 수준을 :none
로 설정합니다.
수단
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 ActiveSupport::BroadcastLogger
의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다. Rails 버전 >= 7.1에서 사용됩니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 ActiveSupport::Logger
의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다. Rails 버전 7.1 이하에서 사용됩니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Async::HTTP의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 토끼의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Fiber 클래스의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 동시 Ruby 라이브러리의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Curb의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 지연된 작업의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 elasticsearch 라이브러리의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 ethon의 자동 계측을 제어합니다. [auto|prepend|chain|disabled] 중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Excon의 자동 계측을 제어합니다. 다음 중 하나일 수 있습니다: enabled
, disabled
.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Grape의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 gRPC 클라이언트의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
New Relic에서 트래픽을 무시할 gRPC 호스트 이름과 일치하는 쉼표로 구분된 호스트 이름 패턴 목록을 지정합니다. New Relic의 gRPC 클라이언트 계측은 이러한 패턴과 일치하는 호스트로 스트리밍되는 트래픽을 무시하고 New Relic의 gRPC 서버 계측은 호스트 이름이 이러한 패턴과 일치하는 호스트에서 실행 중인 서버의 트래픽을 무시합니다. 기본적으로 gRPC 계측이 자체적으로 활성화된 경우 트래픽이 무시되지 않습니다. 예를 들어, "private.com$,exception.*"
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 gRPC 서버의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 HTTPClient의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 http.rb gem의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 httpx의 자동 계측을 제어합니다. [auto|prepend|chain|disabled] 중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Ruby 표준 라이브러리 Logger의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Memcache에 대한 Dalli Gem의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Memcache에 대한 Memcached gem의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Memcache용 Memcache-client gem의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Mongo의 자동 계측을 제어합니다. 다음 중 하나일 수 있습니다: enabled
, disabled
.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Net::HTTP
의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 ruby-openai gem의 자동 측정, 자동 반환을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
Puma::Rack
의 자동 계측을 제어합니다. 활성화되면 에이전트는 Puma::Rack::Builder
의 to_app
메서드에 연결하여 애플리케이션 시작 중에 계측할 gem을 찾습니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Puma::Rack::URLMap
의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
Rack의 자동 계측을 제어합니다. 활성화되면 에이전트는 Rack::Builder
의 to_app
메서드에 연결하여 애플리케이션 시작 중에 계측할 gem을 찾습니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Rack::URLMap
의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 레이크의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Redis의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 resque의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Roda의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Sinatra의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Stripe의 자동 계측을 제어합니다. 다음 중 하나일 수 있습니다: enabled
, disabled
.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 ViewComponent의 자동 측정, 자동 내보내기를 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 비동기 트랜잭션 내부에 범위를 올바르게 중첩할 수 있도록 시작 시 Thread 클래스의 자동 계측을 제어합니다. 이렇게 해도 에이전트는 생성된 모든 스레드를 자동으로 추적할 수 없습니다( instrumentation.thread.tracing
참조). auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Thread 클래스의 자동 계측을 제어하여 애플리케이션에서 생성된 모든 Thread에 자동으로 추적을 추가합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Tilt 템플릿 렌더링 라이브러리의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Typhoeus의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
메시지 추적기
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 메시지에 대한 메타데이터를 수집하고 이를 세그먼트 매개변수로 첨부합니다.
몽고
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 트랜잭션 추적에서 Mongo 쿼리를 캡처합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 트랜잭션 추적에서 Mongo 쿼리를 난독화합니다.
프로세스 호스트
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
New Relic UI에 표시 할 사용자 지정 호스트 이름을 지정합니다.
갈퀴
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
자동 계측할 Rake 작업 배열을 지정합니다. 이 구성 옵션은 배열을 RegEx 목록으로 변환합니다. 기본적으로 모든 작업을 허용하려면 rake.tasks: [.+]
사용하세요. 이 목록에 추가되지 않으면 레이크 작업이 계측되지 않습니다. 자세한 내용은 New Relic Rake Instrumentation 문서를참조하십시오.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
레이크 작업 전에 연결이 완료되기를 기다리는 시간 초과
규칙
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
무시하려는 URI와 일치하는 패턴 목록을 지정하여 에이전트가 무시할 트랜잭션을 정의합니다. 자세한 내용 은 특정 트랜잭션 무시에 대한 문서를 참조하세요.
서버리스 모드
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 단기 서버리스 기능과 함께 사용하기에 적합한 간소화된 모드에서 작동합니다. 참고: 현재는 AWS Lambda 함수만 지원되며 이 옵션은 뉴렐릭의 루비 Lambda 레이어 제공 없이는 사용할 수 없습니다.
사이드키크
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
어떤 Sidekiq 작업 인수가 New Relic에 보고되는지 필터링하기 위한 허용 목록 역할을 하는 문자열 배열입니다. Sidekiq 인수를 캡처하려면 'job.sidekiq.args.*' 별도의 :'attributes.include'
구성 옵션에 추가해야 합니다. 이 배열의 각 문자열은 고급 일치를 허용하기 위해 Regexp.new
을 통해 정규식으로 변환됩니다. 작업 인수 해시의 경우 키 또는 값이 일치하면 해당 쌍이 포함됩니다. 일치하는 모든 작업 인수 배열 요소와 작업 인수 스칼라가 포함됩니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
어떤 Sidekiq 작업 인수가 New Relic에 보고되는지 필터링하기 위한 거부 목록 역할을 하는 문자열 배열입니다. Sidekiq 인수를 캡처하려면 'job.sidekiq.args.*' 별도의 :'attributes.include'
구성 옵션에 추가해야 합니다. 이 배열의 각 문자열은 고급 일치를 허용하기 위해 Regexp.new
을 통해 정규식으로 변환됩니다. 작업 인수 해시의 경우 키 또는 값이 일치하면 쌍이 제외됩니다. 일치하는 모든 작업 인수 배열 요소와 작업 인수 스칼라가 제외됩니다.
느린 SQL
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 느린 SQL 쿼리 를 수집합니다.
유형 | 뜨다 |
---|---|
기본값 |
|
환경 변수 |
|
임계값을 초 단위로 지정합니다. 에이전트는 느린 SQL 쿼리 를 수집하고 이 임계값을 초과하는 계획을 설명합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 느린 SQL 쿼리에서 계획 설명을 수집합니다. 이 설정을 생략하면 느린 SQL에서도 Explain Plan의 기본 설정으로 transaction_tracer.explain_enabled
설정이 적용됩니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
느린 SQL 쿼리에 대한 난독화 수준을 정의합니다. 유효한 옵션은 obfuscated
, raw
또는 none
입니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
느린 SQL 추적을 위해 더 긴 sql_id
생성합니다. sql_id
은 유사한 쿼리의 집계에 사용됩니다.
스팬 이벤트
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 스팬 이벤트 샘플링을 활성화합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
추적 관찰자로 스트리밍할 때 버퍼링할 최대 범위 이벤트 수를 설정합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
- 단일 수확에서 보고되는 범위 이벤트의 최대 수를 정의합니다.
1
와10000
사이의 모든 정수가 유효합니다. - AI 모니터링 용 에이전트를 구성할 때 최대값
10000
으로 설정하세요. 요원이 트레이스의 최대 금액을 캡처하도록 보장합니다.
스트립 예외 메시지
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
strip_exception_messages 가 true
일 때 에이전트가 제거하지 않을 예외 목록을 지정하십시오. 쉼표로 예외를 구분하십시오. 예: "ImportantException,PreserveMessageException"
.
줄무늬
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
Stripe 이벤트의 user_data
해시 내에서 New Relic에 보고되어야 하는 키를 지정하는 문자열 배열입니다. 이 배열의 각 문자열은 고급 일치를 허용하기 위해 Regexp.new
을 통해 정규식으로 변환됩니다. 값을 ["."]
로 설정하면 모든 user_data
가) 보고됩니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
Stripe 이벤트의 user_data
해시 내부에 있는 키 및/또는 값을 New Relic에 보고하지 않아야 함을 지정하는 문자열 배열입니다. 이 배열의 각 문자열은 고급 일치를 허용하기 위해 Regexp.new
을 통해 정규식으로 변환됩니다. 각 해시 쌍에 대해 키 또는 값이 일치하면 해당 쌍이 보고되지 않습니다. 기본적으로 user_data
보고되지 않으므로 이 옵션은 stripe.user_data.include
옵션을 사용하는 경우에만 사용해야 합니다.
스레드 프로파일러
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 스레드 프로파일러 를 사용할 수 있습니다.
이용
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 AWS 환경에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Azure 환경에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Docker에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Google Cloud Platform 환경에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 에이전트가 Kubernetes에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Pivotal Cloud Foundry 환경에서 실행 중임을 자동으로 감지합니다.