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.세 번째.이벤트
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
당신의 New Relic . newrelic deployments
명령을 사용하여 배포를 기록하기 위해 New Relic REST API v2를 사용할 때 필요합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
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
인 경우 에이전트가 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
이벤트 수를 정의합니다.
브라우저 모니터링
브라우저 모니터링 페이지 로드 타이밍 기능(실제 사용자 모니터링 또는 RUM이라고도 함)은 실제 사용자가 웹사이트에서 경험하는 성능에 대한 통찰력을 제공합니다. 이것은 각 페이지의 머리글과 바닥글에 소량의 JavaScript 코드를 삽입하여 사용자의 브라우저가 웹 페이지를 다운로드하고 렌더링하는 데 걸리는 시간을 측정하여 수행됩니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 페이지 로드 타이밍(실제 사용자 모니터링 또는 RUM이라고도 함)에 대한 JavaScript 헤더 자동 삽입 을 활성화합니다.
거래 이벤트
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 트랜잭션 이벤트 샘플링을 활성화합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
단일 수집에서 보고되는 최대 트랜잭션 이벤트 수를 정의합니다.
애플리케이션 로깅
Ruby 에이전트는 컨텍스트에서 APM 로그를 지원합니다. Ruby 에이전트에 대한 로그 구성에 대한 몇 가지 팁은 Configure Ruby logs in context 를 참조하십시오. 사용 가능한 로깅 관련 구성 옵션은 다음과 같습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 로그 장식과 로그 이벤트 및 측정항목 수집을 활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 애플리케이션에서 내보낸 로그 레코드를 캡처합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
한 번에 메모리에 버퍼링할 최대 로그 레코드 수를 정의합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 항목, 호스트, 추적 및 범위에 연결하기 위해 메타데이터로 로그를 장식합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 애플리케이션의 로깅과 관련된 측정항목을 캡처합니다.
속성
속성 은 이벤트 또는 트랜잭션의 속성을 결정하는 정보를 포함하는 키-값 쌍입니다. 이러한 키-값 쌍은 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/
교차 애플리케이션 추적기
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
DEPRECATED 참조: distribution_tracing-enabled .
true
이면 distributed_tracing.enabled
이 false
로 설정될 때 교차 애플리케이션 추적 을 활성화합니다.
사용자 정의 속성
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
false
이면 이벤트에 대해 사용자 정의 속성이 전송되지 않습니다.
맞춤 이벤트
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 에이전트가 맞춤 이벤트 를 캡처합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
한 번에 메모리에 버퍼링할 최대 사용자 지정 이벤트 수를 지정합니다.
데이터 저장소 추적기
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
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를 통해 설치되었는지 여부에 관계없음).
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 샘플러 측정항목 수집을 비활성화합니다. 샘플러 메트릭은 이벤트 기반이 아닌 메트릭입니다(예: CPU 시간 또는 메모리 사용량).
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 Sequel 계측 을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 Sidekiq 계측 을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
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::Logger
의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작할 때 토끼의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Fiber 클래스의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 동시 루비 라이브러리의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Curb의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 지연된 작업의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 elasticsearch 라이브러리의 자동 계측을 제어합니다. 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
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작할 때 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
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
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
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 Sinatra의 자동 계측을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 비동기 트랜잭션 내에서 범위를 올바르게 중첩할 수 있도록 시작 시 Thread 클래스의 자동 계측을 제어합니다. 이렇게 해도 에이전트가 생성된 모든 스레드를 자동으로 추적할 수 없습니다( instrumentation.thread.tracing
참조). auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
애플리케이션에서 생성된 모든 스레드에 자동으로 추적을 추가하기 위해 시작 시 스레드 클래스의 자동 계측을 제어합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 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 문서)[/docs/apm/agents/ruby-agent/background-jobs/rake-instrumentation]을 참조하십시오.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
레이크 작업 전에 연결이 완료되기를 기다리는 시간 초과
규칙
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
무시하려는 URI와 일치하는 패턴 목록을 지정하여 에이전트가 무시할 트랜잭션을 정의합니다. 자세한 내용 은 특정 트랜잭션 무시에 대한 문서를 참조하세요.
느린 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
사이의 모든 정수가 유효합니다.
스트립 예외 메시지
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
strip_exception_messages 가 true
일 때 에이전트가 제거하지 않을 예외 목록을 지정하십시오. 쉼표로 예외를 구분하십시오. 예: "ImportantException,PreserveMessageException"
.
스레드 프로파일러
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 스레드 프로파일러 를 사용할 수 있습니다.
이용
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 AWS 환경에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Azure 환경에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Docker에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Google Cloud Platform 환경에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 에이전트가 Kubernetes에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Pivotal Cloud Foundry 환경에서 실행 중임을 자동으로 감지합니다.