New Relic Ruby 에이전트는 구성 파일의 설정, 환경 변수를 사용하거나 서버 측 구성을 사용하여 프로그래밍 방식으로 구성할 수 있습니다. 이 문서는 Ruby 에이전트에 사용할 수 있는 구성 옵션을 요약합니다.
구성 옵션의 기본값이 (Dynamic)
이면 Ruby 에이전트가 런타임에 기본값을 계산한다는 의미입니다. 구성 설정 값은 기본적으로 다른 설정 값으로 적절하게 설정됩니다.
구성 방법 및 우선 순위
Ruby 에이전트를 구성하는 기본(기본) 방법은 config
하위 디렉토리의 구성 파일( newrelic.yml
)을 사용하는 것입니다. 환경 변수를 사용하여 구성 값을 설정하려면:
- 설정 이름에 접두사
NEW_RELIC_
을 추가합니다. - 마침표
.
를 밑줄_
로 바꿉니다.
서버 측 구성 을 통해 UI에서 몇 가지 값을 구성할 수도 있습니다.
Ruby 에이전트는 구성에 대해 다음과 같은 우선 순위를 따릅니다.
- 환경 변수
- 서버 측 구성
- 구성 파일(
newrelic.yml
) - 기본 구성 설정
즉, 환경 변수는 다른 모든 구성 설정 및 정보를 재정의하고 서버 측 구성은 구성 파일 및 기본 구성 설정을 재정의하는 식입니다.
구성 파일 옵션 보기 및 편집
루비 에이전트의 newrelic.yml
은 표준 YAML 설정 파일입니다. 일반적으로 상단에 Defaults
섹션이 포함되고 하단에는 각 애플리케이션 환경(Development
, Test
, Staging
, Production
)에 대한 섹션이 포함됩니다.
루비 에이전트는 특정 환경 변수를 살펴보고 newrelic.yml
구성 파일에서 읽을 섹션을 결정하여 에이전트 환경을 파생시킵니다. 이것은 운영 환경에서 log_level
구성 설정에 info
사용하고 개발 환경에서 더 자세한 log_level
구성 설정(예: debug
)을 원할 때 유용할 수 있습니다.
다음은 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
루비 에이전트는 인력 환경을 찾기 위해 다음 환경 변수를 순서대로 찾습니다.
NEW_RELIC_ENV
RUBY_ENV
RAILS_ENV
APP_ENV
RACK_ENV
루비 에이전트가 해당 환경 변수에 대한 값을 감지하지 못하면 기본적으로 애플리케이션 환경을 development
으로 설정하고 newrelic.yml
구성 파일의 development
섹션에서 읽습니다.
Rails 앱에서 루비 에이전트를 실행할 때 에이전트는 먼저 NEW_RELIC_ENV
환경 변수를 검색하여 내장 환경과 사용할 newrelic.yml
의 섹션을 찾습니다. NEW_RELIC_ENV
가 없으면 에이전트는 Rails 환경(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 번들은 뉴렐릭의 데이터 수집 서비스에서 제공하는 SSL 인증을 검증합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
트랜잭션 추적에서 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
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
아웃바운드 요청에서 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 요청 헤더의 캡처를 활성화합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 자동으로 사용자 정의를 추가할 수 있는 루비 메소드를 나타내는 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
인 경우 에이전트가 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 에이전트 API를 참조하세요 .
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 TransactionError
이벤트를수집합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 추적된 오류 및 오류 수 측정항목을 캡처합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 예상대로 처리해야 하는 오류 클래스 목록입니다.
주의
이 옵션은 환경 변수를 통해 설정할 수 없습니다.
유형 | 해시시 |
---|---|
기본값 |
|
환경 변수 |
|
메시지 목록에 대한 오류 클래스 맵. 여기에 지정된 클래스 중 하나의 오류가 발생할 때 오류 메시지에 여기에 해당하는 문자열 중 하나가 포함되어 있으면 해당 오류는 예상대로 처리됩니다.
주의
이 옵션은 환경 변수를 통해 설정할 수 없습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
범위를 포함할 수 있는 상태 코드의 쉼표로 구분된 목록입니다. 해당되는 경우 이러한 상태 코드와 관련된 오류는 예상대로 처리됩니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
에이전트가 무시해야 하는 오류 클래스 목록입니다.
주의
이 옵션은 환경 변수를 통해 설정할 수 없습니다.
유형 | 해시시 |
---|---|
기본값 |
|
환경 변수 |
|
메시지 목록에 대한 오류 클래스 맵. 여기에 지정된 클래스 중 하나의 오류가 발생할 때 오류 메시지에 여기에 해당하는 문자열 중 하나가 포함되어 있으면 해당 오류는 무시됩니다.
주의
이 옵션은 환경 변수를 통해 설정할 수 없습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
범위를 포함할 수 있는 상태 코드의 쉼표로 구분된 목록입니다. 해당되는 경우 이러한 상태 코드와 관련된 오류는 무시됩니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
오류 역추적의 최대 프레임 수를 정의합니다. 이 양을 초과하는 역추적은 스택 추적의 시작과 끝을 유지하면서 중간이 잘립니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
수집 주기당 보고되는 최대 TransactionError
이벤트 수를 정의합니다.
브라우저 모니터링
페이지 로드 타이밍 기능(실 사용자 모니터링 또는 RUM 이라고도 함)은 실제 사용자가 웹사이트에서 경험하고 있는 성능에 대해 인사이트를 제공합니다. 이는 각 페이지의 머리글과 바닥글에 소량의 JavaScript 코드를 삽입하여 사용자 브라우저가 웹 페이지를 다운로드하고 렌더링하는 데 걸리는 시간을 측정함으로써 수행됩니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 페이지 로드 타이밍(실제 사용자 모니터링 또는 RUM이라고도 함)에 대한 JavaScript 헤더 자동 삽입 을 활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 브라우저 모니터링 스크립트에 콘텐츠 보안 정책 Nonce 의 자동 주입이 활성화됩니다. 현재 자동 주입은 Rails 5.2 이상에서만 작동합니다.
거래 이벤트
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 트랜잭션 이벤트 샘플링을 활성화합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
단일 수집에서 보고되는 최대 트랜잭션 이벤트 수를 정의합니다.
애플리케이션 로깅
Ruby 에이전트는 컨텍스트에서 APM 로그를 지원합니다. Ruby 에이전트에 대한 로그 구성에 대한 몇 가지 팁 은 컨텍스트에서 Ruby 로그 구성 을 참조하십시오.
사용 가능한 로깅 관련 구성 옵션은 다음과 같습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 로그 장식과 로그 이벤트 및 측정항목 수집을 활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 애플리케이션에서 내보낸 로그 레코드를 캡처합니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
로그 이벤트가 New Relic으로 전달되어야 하는 최소 수준을 설정합니다.
이는 루비의 Logger::Severity
상수 의 정수 값을 기반으로 합니다.
의도는 구성에 지정된 수준의 로그와 더 높은 수준의 심각도를 가진 로그를 전달하는 것입니다.
예를 들어 이 값을 "debug"로 설정하면 모든 로그 이벤트가 New Relic으로 전달됩니다. 이 값을 "오류"로 설정하면 "오류", "치명적" 및 "알 수 없음" 수준의 로그 이벤트만 전달됩니다.
유효한 값(가장 낮은 순서대로):
- "디버그"
- "정보"
- "경고하다"
- "오류"
- "치명적인"
- "알려지지 않은"
유형 | 해시시 |
---|---|
기본값 |
|
환경 변수 |
|
New Relic으로 전달되는 모든 로그 이벤트에 사용자 지정 속성으로 추가할 키/값 쌍이 있는 해시입니다. 환경 변수를 사용하여 보내는 경우 값은 "key1=value1,key2=value2"와 같은 형식이어야 합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 로그 레코드에 레이블을 첨부합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
로그 레코드에서 제외할 레이블을 포함하는 대소문자를 구분하지 않는 문자열 또는 쉼표로 구분된 문자열입니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
한 번에 메모리에 버퍼링할 최대 로그 레코드 수를 정의합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 항목, 호스트, 추적 및 범위에 연결하기 위해 메타데이터로 로그를 장식합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 애플리케이션의 로깅과 관련된 측정항목을 캡처합니다.
AI 모니터링
이 섹션에는 AI 시뮬레이션 설정을 위한 루비 에이전트 설정이 포함되어 있습니다.
중요
추적 및 피드백 데이터를 캡처하려면 제외 추적을 활성화해야 합니다. 루비 에이전트 8.0.0 이상에서는 기본적으로 켜져 있습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
false
인 경우 모든 LLM 측정, 로그(현재는 OpenAI만 해당)가 비활성화되고 지표, 이벤트 또는 범위가 전송되지 않습니다. high_security
모드가 활성화되면 AI 모니터링이 자동으로 비활성화됩니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
false
인 경우 LLM 측정, 로그(현재 OpenAI만 해당)는 특정 LLM 이벤트의 입력 및 출력 콘텐츠를 캡처하지 않습니다.
제외되는 속성은 다음과 같습니다.
content
LlmChatCompletionMessage 이벤트에서input
LlmEmbedding 이벤트에서이는 LLM과 주고받는 민감한 데이터가 기록되는 것을 방지하기 위한 선택적 보안 설정입니다.
속성
속성 은 이벤트 또는 트랜잭션의 속성을 결정하는 정보를 포함하는 키-값 쌍입니다. 이러한 키-값 쌍은 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"
.
구름
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
이 앱과 연결된 AWS 계정의 AWS 계정 ID
코드 수준 메트릭
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 요원은 트레이스 메서드에 대한 소스 수준 지표를 보고합니다. 참조: https://docs.newrelic.com/docs/apm/agents/ruby-agent/features/ruby-codestream-integration/
교차 애플리케이션 추적기
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
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
구성 파일에서 다음 옵션을 업데이트하세요.
cross_application_tracer: enabled: true distributed_tracing: enabled: false
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 보기 계측을 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 Ruby VM에서 성능 측정을 샘플링 하지 않습니다.
분산 추적
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
분산 추적을 사용하면 요청이 분산 시스템을 통과하는 경로를 볼 수 있습니다. 분산 추적을 활성화하면 일부 New Relic 기능의 동작이 변경되므로 이 기능을 활성화하기 전에 전환 가이드 를 주의 깊게 참조하십시오.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
이 설정은 원격 부모가 샘플링되고 traceparent에 트레이스 플래그가 설정된 경우 트랜잭션 샘플링의 동작을 제어합니다. 사용 가능한 값은 default
, always_on
, always_off
입니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
이 설정은 원격 부모가 샘플링되지 않고 traceparent에 트레이스 플래그가 설정되지 않은 경우 트랜잭션 샘플링의 동작을 제어합니다. 사용 가능한 값은 default
, always_on
, always_off
입니다.
엘라스틱서치
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 인스턴스 트레이스에서 Elasticsearch 제거 이름을 캡처합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
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
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 AWS-sdk-firehose 라이브러리의 자동 측정, 자동 리소스를 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 aws_sdk_lambda 라이브러리의 자동 측정, 자동 트랜잭션을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 AWS-sdk-kinesis 라이브러리의 자동 측정, 자동 트랜잭션을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 ruby-kafka 라이브러리의 자동 측정, 자동 트랜잭션을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 opensearch-ruby 라이브러리의 자동 측정, 자동 트랜잭션을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 rdkafka 라이브러리의 자동 측정, 자동 트랜잭션을 제어합니다. auto
, prepend
, chain
, disabled
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 AWS-sdk-sqs 라이브러리의 자동 측정, 자동 트랜잭션을 제어합니다. 다음 중 하나일 수 있습니다: auto
, prepend
, chain
, disabled
.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 AWS-sdk-dynamodb 라이브러리의 자동 측정, 자동 트랜잭션을 제어합니다. 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
중 하나일 수 있습니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
시작 시 LogStasher 라이브러리의 자동 측정, 자동 트랜잭션을 제어합니다. 다음 중 하나일 수 있습니다: 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
. 높은 보안 모드에서는 기본값이 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 쿼리를 난독화합니다.
오픈서치
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 프로세서 트레이스에서 OpenSearch 쿼리를 캡처합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 에이전트는 프로세서 트레이스에서 OpenSearch를 난독화합니다.
프로세스 호스트
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
New Relic UI에 표시 할 사용자 지정 호스트 이름을 지정합니다.
갈퀴
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
자동 계측할 Rake 작업 배열을 지정합니다. 이 구성 옵션은 배열을 RegEx 목록으로 변환합니다. 기본적으로 모든 작업을 허용하려면 rake.tasks: [.+]
사용하세요. 이 목록에 추가되지 않으면 레이크 작업이 계측되지 않습니다. 자세한 내용은 New Relic Rake Instrumentation 문서를참조하십시오.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
레이크 작업 전에 연결이 완료되기를 기다리는 시간 초과
규칙
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
무시하려는 URI와 일치하는 패턴 목록을 지정하여 에이전트가 무시할 트랜잭션을 정의합니다. 자세한 내용 은 특정 트랜잭션 무시에 대한 문서를 참조하세요.
보안
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 보안 에이전트가 로드됩니다(루비 'require'가 수행됨).
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 보안 에이전트가 시작됩니다(에이전트는 이벤트 루프에서 실행됨).
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
보안 에이전트가 작동하는 모드를 정의합니다. 현재는 IAST
만 지원됩니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
보안 관련 데이터를 게시하기 위한 엔드포인트 URL을 정의합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
애플리케이션이 수신 중인 포트입니다. 이 설정은 Passenger 서버에서 필수입니다. 에이전트는 기본적으로 다른 서버를 감지합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
IAST 스캔에서 보안 에이전트가 무시해야 하는 API 경로를 정의합니다. 무시할 URI와 일치하는 정규식 패턴을 허용합니다. 정규식 패턴은 엔드포인트 없이 URL과 완전히 일치하는 항목을 찾아야 합니다. 예를 들어, [".*account.*"], [".*/\api\/v1\/.*?\/login"]
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
보안 에이전트가 IAST 스캔에서 무시해야 하는 HTTP 요청 헤더의 반대입니다. 해당 헤더와 일치하는 패턴 목록을 무시하도록 지정해야 합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
HTTP 요청에 대한 검증을 수행하기 위해 보안 에이전트는 IAST 스캔에서 무시해야 합니다. 무시하려면 HTTP 요청 쿼리와 일치하는 패턴 목록을 지정해야 합니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
보안 에이전트가 IAST 스캔에서 무시해야 하는 HTTP 요청 본문 키의 반대입니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 심각도가 낮은 안전하지 않은 설정의 감지를 비활성화합니다. 예를 들어 해시, 암호, 쿠키, 난수 생성기, 신뢰 경계 등이 있습니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 파일 작업 관련 IAST 감지(파일 액세스 및 애플리케이션 무결성 위반)를 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 IAST 스캔에서 SQL 주입 감지를 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 IAST 스캔에서 NOSQL 주입 감지를 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 IAST 스캔에서 LDAP 주입 감지를 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 IAST 스캔에서 Javascript 주입 감지를 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 IAST 스캔에서 시스템 명령 주입 감지를 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 IAST 스캔에서 XPATH 주입 감지를 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 IAST 스캔에서 SSRF(Sever-Side Request Forgery) 감지를 비활성화합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 IAST 스캔에서 RXSS(Reflected Cross-Site Spreadsheet) 감지를 비활성화합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
애플리케이션이 시작된 후 IAST 검사가 시작되기 전의 지연 시간(분)을 지정합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
IAST 스캔이 수행되는 기간(분)을 나타냅니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
IAST 스캔을 언제 실행해야 하는지 설정하는 Cron 표현식을 지정합니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
인 경우 IAST 백그라운드에서 지속적으로 트레이스 데이터를 수집할 수 있습니다. 보안 에이전트는 수집된 데이터를 사용하여 예약된 시간에 IAST 스캔을 수행합니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
스캔에 허용되는 분당 최대 HTTP 수를 requests 설정합니다.IAST 12와 3600 사이의 모든 정수가 유효합니다. 기본값은 3600입니다.
유형 | 정수 |
---|---|
기본값 |
|
환경 변수 |
|
IAST 분석을 수행할 특정 부분에 대한 로그를 포함하는 수입니다.
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true
이면 HTTP 응답 본문 전송이 활성화됩니다. 이 기능을 비활성화하면 Reflected Cross-Site 펼쳐(RXSS) 탐지도 비활성화됩니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
서로 다른 테스트 실행을 구별하기 위해 연속 통합/연속 배포(CI/CD) 환경에서 IAST 실행할 때 고유한 테스트 예외입니다. 예를 들어, 빌드 번호.
서버리스 모드
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
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
으로 설정합니다. 이렇게 하면 에이전트가 에이전트 트레이스의 최대량을 캡처할 수 있습니다.
스트립 예외 메시지
유형 | 부울 |
---|---|
기본값 |
|
환경 변수 |
|
true인 경우 에이전트는 허용된 클래스 목록 에 있는 예외를 제외한 모든 예외에서 메시지를 제거합니다. 높은 보안 모드 에서는 자동으로 활성화됩니다.
유형 | 문자열 |
---|---|
기본값 |
|
환경 변수 |
|
strip_exception_messages 가 true
일 때 에이전트가 제거하지 않을 예외 목록을 지정하십시오. 쉼표로 예외를 구분하십시오. 예: "ImportantException,PreserveMessageException"
.
줄무늬
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
Stripe 이벤트의 user_data
과거 내부에 있는 어떤 키를 지정하기 위한 문자열을 뉴렐릭에게 보고해야 합니다. 이 알고리즘의 각 문자열은 고급 매칭을 활성화하기 위해 Regexp.new
통해 정규 표현식으로 변환됩니다. 값을 ["."]
로 설정하면 user_data
모두 보고됩니다.
유형 | 정렬 |
---|---|
기본값 |
|
환경 변수 |
|
Stripe 이벤트의 user_data
시절 내에서 어떤 키 및/또는 값을 지정하기 위한 문자열이 뉴렐릭에 보고되지 않아야 합니다. 이 알고리즘의 각 문자열은 고급 매칭을 허용하기 위해 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 환경에서 실행 중임을 자동으로 감지합니다.