앱 이름, 라이선스 키, 프록시, 로깅 및 일반 에이전트 동작을 포함한 핵심 루비 에이전트 설정을 구성하십시오.
일반적인
이러한 설정은 에이전트 구성에 사용할 수 있습니다. 일부 설정은 New Relic 구독 수준에 따라 다릅니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 Ruby 에이전트 실행을 허용합니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
귀하의 뉴렐릭 .
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
로그 메시지의 세부 정보 수준을 설정합니다. 상세 수준이 높아지는 순서대로 가능한 로그 레벨은 다음과 같습니다: fatal, error, warn, info 또는 debug.
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
구독하고 계측할 ActiveSupport 커스텀 대시보드 이름의 어레이입니다. 예: [one.커스텀 대시보드, another.이벤트, a.third.이벤트]
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우, 에이전트는 ActiveRecord 메트릭, 스팬 및 트랜잭션 트레이스 세그먼트의 이름을 지정할 때 클래스 이름 대신 ActiveRecord 모델의 테이블 이름을 사용합니다. 이는 여러 모델이 데이터베이스 테이블을 공유할 때 카디널리티를 줄일 수 있습니다. 기본값은 false입니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
Rails 6에 도입된 보다 빠른 ActiveRecord 연결 조회를 백포트하여 ActiveRecord를 계측할 때 에이전트 성능을 향상시킵니다. 이 설정은 ActiveRecord를 패치하는 다른 gem과 호환되지 않을 수 있습니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
로컬 CA 번들에 대한 경로를 수동으로 재정의합니다. 이 CA 번들은 뉴렐릭의 데이터 수집 서비스에서 제공하는 SSL 인증을 검증합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우 에이전트는 트랜잭션 트레이스에서 memcache 키를 캡처합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 에이전트는 HTTP 요청 매개변수를 캡처하여 트랜잭션 추적, 추적된 오류 및 TransactionError 이벤트 에 연결합니다.
주의
capture_params 설정을 사용하면 루비 에이전트는 비밀 정보를 필터링하지 않습니다. Recommendation: 요청 보고서에서 비밀 정보를 필터링하려면 대신 attributes.include 설정을 사용하세요. 자세한 내용은 루비 속성 예제를 참조하세요.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 이면 에이전트는 Agent.drop_buffered_data 에서 Tracer::State 을 지웁니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
newrelic.yml 경로입니다. 정의되지 않은 경우 에이전트는 다음 디렉터리를 순서대로 확인합니다: config/newrelic.yml -> newrelic.yml -> $HOME/.newrelic/newrelic.yml -> $HOME/newrelic.yml
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우 아웃바운드 requests에 대한 newrelic 분산 추적 헤더를 억제합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우, 에이전트가 다른 프레임워크 내에 내장된 서비스로 실행되는 Sinatra를 감지할 때와 같이 일반적으로 에이전트가 이를 건너뛰는 경우에도 에이전트가 종료 핸들러(종료하기 전에 캐시된 모든 데이터를 수집기로 보냄)를 설치하도록 강제합니다. Sinatra는 자체 at_exit 블록 내에서 전체 애플리케이션을 실행하므로, 에이전트는 충돌을 피하기 위해 기본적으로 자체 at_exit 핸들러를 건너뜁니다. 이 설정은 이를 재정의합니다. 참고: 이 설정이 효과를 발휘하려면 send_data_on_exit도 true 이어야 합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 높은 보안 모드 를 활성화합니다. 이 설정을 활성화하기 전에 높은 보안 모드의 의미를 이해했는지 확인하십시오.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
이 에이전트에서 보낸 데이터에 적용할레이블 이름 및 값의 사전입니다. 콜론으로 구분된 : 쌍의 세미콜론으로 구분된 ; 문자열로 표현될 수도 있습니다. 예를 들어, Server:One;Data Center:Primary .
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
로그 파일의 이름을 정의합니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
파일 이름을 제외한 에이전트 로그 파일의 경로를 정의합니다. 에이전트 로그를 표준 출력으로 보내려면 이를 STDOUT(으)로 설정하십시오.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
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 요청 헤더의 캡처를 활성화합니다.
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
에이전트가 자동으로 사용자 정의를 추가할 수 있는 루비 메소드를 나타내는 CLASS#METHOD (클래스 메소드용) 및/또는 CLASS.METHOD (클래스 메소드용) 문자열의 포함입니다. 이렇게 하려면 메서드를 정의하는 소스 코드를 수정할 필요가 없습니다.
:: 구분 기호를 사용하여 모듈이나 클래스 네임스페이스를 포함하는 완전히 정규화된 클래스 이름을 사용합니다.
다음은 MyCompany 모듈에 있는 Image 클래스의 render_png 분리 메서드와 notify User 메서드를 정의하는 루비 소스 코드입니다.
module MyCompany class Image def render_png # code to render a PNG end end
class User def self.notify # code to notify users end end end해당 소스 코드가 주어지면 newrelic.yml 구성 파일은 다음과 같이 두 메서드 모두에 대한 계측을 요청할 수 있습니다.
automatic_custom_instrumentation_method_list: - MyCompany::Image#render_png - MyCompany::User.notify해당 설정 예제에서는 YAML 구문을 사용하여 두 가지 방법을 모두 지정합니다. 또는 쉼표로 구분된 문자열을 사용할 수 있습니다.
automatic_custom_instrumentation_method_list: 'MyCompany::Image#render_png, MyCompany::User.notify'목록의 쉼표 주위의 공백은 선택 사항입니다. NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST 환경 변수를 통해 메서드 목록으로 에이전트를 구성하는 경우 다음과 같은 쉼표로 구분된 문자열 형식을 사용하세요.
$export NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST='MyCompany::Image#render_png, MyCompany::User.notify'유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우, Action Cable 브로드캐스트 호출에 대한 메트릭에는 특정 브로드캐스트에 대한 broadcasting 값이 포함되지 않습니다. false로 기본 설정됩니다. 기본값은 향후 주요 버전 릴리스에서 변경될 수 있습니다.
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
에이전트가 무시할 미들웨어 클래스 또는 모듈 이름 목록입니다. 예: ["Rack::Cors", "ActionDispatch::Reloader"]
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우 에이전트가 Ruby on Rails를 사용하는 애플리케이션에 있을 때 config/initializers 실행 후에 시작됩니다.
주의
이 옵션은 환경 변수로만 설정할 수 있습니다.