트랜잭션 이벤트, 감사 로그, 자동 시작 동작, 클라우드 통합, 계측 제어, 보안 에이전트, 서버리스 모드, Sidekiq 및 사용률 감지를 포함한 기타 루비 에이전트 설정을 구성하십시오.
거래 이벤트
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 트랜잭션 이벤트 샘플링을 활성화합니다.
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
단일 수집에서 보고되는 최대 트랜잭션 이벤트 수를 정의합니다.
감사 로그
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 New Relic 수집기 와의 통신을 기록하는 감사 로그를 활성화합니다.
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
감사 로그에 포함할 허용된 엔드포인트 목록입니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
감사 로그 파일의 경로를 지정합니다(파일 이름 포함).
자동 시작
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
에이전트가 자동으로 시작되지 않도록 해야 하는 상수 목록을 지정하십시오. 쉼표 , 로 개별 상수를 구분합니다. 예: "Rails::Console,UninstrumentedBackgroundJob" .
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
에이전트가 계측하지 않아야 하는 실행 파일의 쉼표로 구분된 목록을 정의합니다. 예: "rake,my_ruby_script.rb" .
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
에이전트가 계측해서는 안 되는 Rake 작업의 쉼표로 구분된 목록을 정의합니다. 예: "assets:precompile,db:migrate" .
구름
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
이 애플리케이션과 연결된 AWS 계정 ID입니다.
코드 수준 메트릭
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우, 에이전트는 트레이스된 메서드에 대한 소스 코드 레벨 메트릭을 보고합니다. 참조: https://docs.newrelic.com/docs/apm/agents/ruby-agent/features/ruby-code-level-metrics/
사용자 정의 속성
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
false 이면 이벤트에 대해 사용자 정의 속성이 전송되지 않습니다.
맞춤 이벤트
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 이면 에이전트가 맞춤 이벤트 를 캡처합니다.
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
한 번에 메모리에 버퍼링할 커스텀 대시보드의 최대 수를 지정하십시오. AI 모니터링을 위해 에이전트를 구성할 때 최대값을 100000으로 설정합니다. 이를 통해 에이전트가 최대 LLM 이벤트 수를 캡처하도록 보장합니다.
데이터 저장소 추적기
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
false인 경우, 에이전트는 트랜잭션 또는 느린 SQL 트레이스에 database_name 파라미터를 추가하지 않습니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
false 인 경우 에이전트는 데이터 저장소 인스턴스 측정항목을 보고하지 않으며 트랜잭션 또는 느린 SQL 추적에 host 또는 port_path_or_id 매개변수를 추가하지 않습니다.
비활성화
이 설정을 사용하여 에이전트 시작 중에 계측 유형을 전환합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 이면 작업 케이블 계측을 비활성화합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 액션 컨트롤러 계측을 비활성화합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 작업 사서함 계측을 비활성화합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 Action Mailer 계측을 비활성화합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 활성 작업 계측을 비활성화합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우, Rails Active Job Continuations의 단계 이름이 메트릭 이름에 포함되지 않습니다. 이는 메트릭 카디널리티를 감소시키지만 개별 단계 성능에 대한 가시성도 감소시킵니다. 단계가 많은 작업이나 동적으로 이름이 지정된 단계로 인해 메트릭 카디널리티 문제가 발생하는 경우에만 이를 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용 에이전트 미들웨어를 비활성화합니다. 이 미들웨어는 분산 추적, 페이지 로드 시간 측정, 오류 수집 과 같은 고급 기능 지원을 담당합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 보기 계측을 비활성화합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 에이전트는 Ruby VM에서 성능 측정을 샘플링 하지 않습니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우, Puma 마스터 프로세스에서 Ruby/Puma/* 메트릭을 샘플링하는 Puma 서버 통계 측정을 비활성화합니다. 이 측정은 기본적으로 비활성화되어 있습니다. 활성화되면 에이전트는 이러한 메트릭을 전달하기 위해 Puma 마스터 프로세스에서 보고 스레드를 시작합니다.
엘라스틱서치
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 에이전트는 인스턴스 트레이스에서 Elasticsearch 제거 이름을 캡처합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 에이전트는 트랜잭션 추적에서 Elasticsearch 쿼리를 캡처합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 에이전트는 트랜잭션 추적에서 Elasticsearch 쿼리를 난독화합니다.
헤로쿠
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 에이전트는 Heroku dyno 이름을 호스트 이름으로 사용합니다.
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
일반적으로 에이전트는 뒤에 점과 프로세스 ID가 있는 dyno 이름을 보고합니다(예: worker.3 ). 후행 데이터 없이 보고할 접두사를 지정하여 이 후행 데이터를 제거할 수 있습니다(예: worker ).
수단
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
에이전트가 구독하는 ActiveSupport 공지 이벤트 이름(주로 캐싱 이벤트 및 메시지 직렬화기 이벤트)의 허용 목록입니다. 여기에 포함되지 않은 모든 이벤트 이름은 무시됩니다. cache_fetch_hit.active_support와(과) 같은 완전한 이벤트 이름만 제공하십시오. 별표나 정규식 패턴을 제공하지 마시고, 백슬래시로 문자를 이스케이프하지 마십시오.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
시작 시 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 중 하나일 수 있습니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
시작 시 semantic_logger 라이브러리의 자동 계측을 제어합니다. 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 중 하나일 수 있습니다.
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
뉴렐릭이 트래픽을 무시해야 하는 gRPC 호스트명과 일치하는 정규식 패턴의 쉼표로 구분된 목록입니다. 뉴렐릭의 gRPC 클라이언트 계측은 이러한 패턴 중 하나와 일치하는 호스트에 대한 호출 추적을 건너뛰고, gRPC 서버 계측은 일치하는 호스트에서 실행 중인 서버가 수신한 requests 추적을 건너뜁니다. 예: "private.com$,exception.*" Empty by default, meaning no traffic is ignored..
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
시작 시 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 중 하나일 수 있습니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
시작 시 로깅 라이브러리의 자동 측정, 자동 트랜잭션을 제어합니다. auto, prepend, chain, disabled 중 하나일 수 있습니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
시작 시 LogStasher 라이브러리의 자동 측정, 자동 트랜잭션을 제어합니다. 다음 중 하나일 수 있습니다: auto, prepend, chain, disabled.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
Rails.event의 계측을 구조화된 로그로 제어합니다. 다음 중 하나일 수 있습니다: enabled, disabled.
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
구조화된 로그 이벤트로 캡처할 Rails.event 이름의 어레이입니다. 예: [user.signup, payment.processed, order.created]. 모든 Rails.event 공지를 캡처하려면 비워 두십시오. 이벤트 페이로드의 :level 키를 통해 재정의되지 않는 한 이벤트는 레벨 UNKNOWN (필터링되지 않도록 보장)로 로그됩니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
시작 시 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를 난독화합니다.
오픈 텔레메트리
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
뉴렐릭을 통해 전송되는 모든 OpenTelemetry 신호를 비활성화하기 위한 전역 설정 옵션입니다. false인 경우, 뉴렐릭으로 OpenTelemetry 신호가 전송되지 않습니다. true인 경우, 신호별 활성화 설정 옵션(예: opentelemetry.traces.enabled)이(가) 해당 신호 유형의 텔레메트리가 뉴렐릭에 보고될지 여부를 결정합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
OpenTelemetry Spans에서 칩셋 트레이스 세그먼트 및 타임슬라이스 메트릭을 생성할 수 있습니다. 이는 OpenTelemetry 스팬에 대한 뉴럴릭 UI 경험을 개선하는 데 도움이 될 것입니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
OpenTelemetry 트레이서의 쉼표로 구분된 목록(문자열 형식, 예:) "AppTracer1,OpenTelemetry:: 측정, 리소스::Bunny::측정, 리소스"), 해당 트레이스가 뉴렐릭으로 전송됩니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
OpenTelemetry 트레이서의 쉼표로 구분된 목록(문자열 형식, 예:) "AppTracer1,OpenTelemetry::Instrumentation::Bunny::Instrumentation"), 해당 트레이스가 뉴렐릭으로 전송되지 않습니다.
프로세스 호스트
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
뉴렐릭 UI에 표시할 커스텀 호스트명을 지정합니다.
프로파일링
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우 연속 프로파일링을 활성화합니다. 애플리케이션에 stackprof 및 google-protobuf gem이 있어야 합니다. JRuby에서는 지원되지 않습니다. 고보안 모드가 활성화되면 자동으로 비활성화됩니다.
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
연속 프로파일링이 활성화된 후 시작되기 전까지의 지연 시간(밀리초)입니다. 기본값은 0이며, 이는 프로파일링이 즉시 시작됨을 의미합니다.
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
자동으로 중지되기 전까지 연속 프로파일링이 실행되는 시간(밀리초)입니다. 기본값은 0이며, 이는 명시적으로 중지될 때까지 프로파일링이 무기한 실행됨을 의미합니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
연속 프로파일링에 사용할 stackprof 샘플링 모드: cpu 또는 object.
유형 | 뜨다 |
|---|---|
기본값 |
|
환경 변수 |
|
연속 프로파일러가 수집한 스택 샘플 간의 간격(초)입니다. profiling.include이(가) cpu일 때만 사용됩니다. 0.000001~0.999999 사이여야 합니다.
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
연속 프로파일러가 수집한 스택 샘플 간의 객체 할당 수입니다. profiling.include이(가) object일 때만 사용됩니다. 1,000에서 999,999 사이여야 합니다.
퓨마
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
Puma 마스터 프로세스에서 수집된 Puma 서버 통계 샘플 간의 시간(초)입니다.
갈퀴
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
자동으로 계측할 Rake 작업의 어레이를 지정하십시오. 이 설정 옵션은 어레이를 정규식 목록으로 변환합니다. 이 목록에 추가되지 않으면 어떠한 rake 작업도 계측되지 않습니다. 기본적으로 모든 작업을 허용하려면 rake.tasks: [.+]을(를) 사용하십시오. 자세한 내용은 뉴렐릭 Rake 계측 문서를 참조하십시오.
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
Rake 작업을 실행하기 전에 연결이 완료될 때까지 대기할 시간(초)을 정의합니다.
규칙
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
제외할 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) 감지를 비활성화합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 IAST 스캔에서 RXSS(Reflected Cross-Site Spreadsheet) 감지를 비활성화합니다.
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
애플리케이션이 시작된 후 IAST 검사가 시작되기 전의 지연 시간(분)을 지정합니다.
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
IAST 스캔이 수행되는 시간(분)을 지정합니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
IAST 스캔을 언제 실행해야 하는지 설정하는 Cron 표현식을 지정합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 IAST 백그라운드에서 지속적으로 트레이스 데이터를 수집할 수 있습니다. 보안 에이전트는 수집된 데이터를 사용하여 예약된 시간에 IAST 스캔을 수행합니다.
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
IAST 스캔에 대해 분당 허용되는 최대 HTTP requests 수를 설정합니다. 12-3600(기본값) 사이의 정수여야 합니다.
유형 | 정수 |
|---|---|
기본값 |
|
환경 변수 |
|
IAST 분석을 수행할 특정 부분에 대한 로그를 포함하는 수입니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 이면 HTTP 응답 본문 전송이 활성화됩니다. 이 기능을 비활성화하면 Reflected Cross-Site 펼쳐(RXSS) 탐지도 비활성화됩니다.
유형 | 문자열 |
|---|---|
기본값 |
|
환경 변수 |
|
연속 통합/연속 배포(CI/CD) 환경에서 IAST를 실행할 때 여러 테스트 실행을 구분하기 위한 고유한 테스트 식별자입니다. 예를 들어 빌드 번호입니다.
서버리스 모드
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 에이전트는 단기 서버리스 기능에 적합한 간소화된 모드로 작동합니다. 참고: 현재는 AWS Lambda 함수만 지원되며, 이 옵션은 뉴렐릭의 루비 Lambda 계층 제공 없이는 사용할 수 없습니다.
사이드키크
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
어떤 Sidekiq 작업 인수가 뉴렐릭에 보고될지 필터링하기 위한 허용 목록 역할을 총괄적으로 수행할 문자열 어레이입니다. Sidekiq 인수를 캡처하려면 별도의 attributes.include 설정 옵션에도 job.sidekiq.args.*을(를) 추가해야 합니다. 고급 일치를 허용하기 위해 이 어레이의 각 문자열은 Regexp.new을(를) 통해 정규식으로 변환됩니다. 작업 인수 해시의 경우, 키 또는 값이 일치하면 해당 쌍이 포함됩니다. 일치하는 모든 작업 인수 어레이 요소 및 작업 인수 스칼라가 포함됩니다.
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
어떤 Sidekiq 작업 인수가 뉴렐릭에 보고될지 필터링하기 위한 거부 목록 역할을 총괄적으로 수행하는 문자열 어레이입니다. Sidekiq 인수를 캡처하려면 별도의 attributes.include 설정 옵션에도 job.sidekiq.args.*을(를) 추가해야 합니다. 고급 일치를 허용하기 위해 이 어레이의 각 문자열은 Regexp.new을(를) 통해 정규식으로 변환됩니다. 작업 인수 해시의 경우 키 또는 값이 일치하면 해당 쌍이 제외됩니다. 일치하는 모든 작업 인수 어레이 요소 및 작업 인수 스칼라가 제외됩니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 에이전트는 Sidekiq의 재시도 중 발생한 예외를 무시하고 작업이 영구적으로 실패하는 경우에만 오류를 보고합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우, 웹 트랜잭션 중에 Sidekiq 작업이 실행될 때 에이전트가 새 트랜잭션을 시작합니다. 이를 통해 Sidekiq 작업 실행 시간이 웹 트랜잭션 메트릭에 포함되는 것을 방지합니다.
스트립 예외 메시지
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우 에이전트는 허용된 클래스 목록에 있는 예외를 제외한 모든 예외에서 메시지를 제거합니다. high security mode [높은 수준의 보안 모드에서] 자동으로 활성화됩니다.
유형 | 정렬 |
|---|---|
기본값 |
|
환경 변수 |
|
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인 경우, Google Cloud Run(Service, Worker Pool, Job)에서 실행될 때 에이전트는 GCP 인스턴스 ID를 호스트명으로 보고합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true인 경우 에이전트는 Google Cloud Run에서 GCP 인스턴스 ID 앞에 Cloud Run 리비전 이름을 추가하여 호스트명({revision}-{instance id})을 구성합니다. 리비전 이름은 Cloud Run Service의 K_REVISION, Cloud Run Worker Pool의 CLOUD_RUN_REVISION, Cloud Run Job의 CLOUD_RUN_EXECUTION에서 가져옵니다. utilization.gcp_cloud_run.use_instance_as_host도 true가 아니라면, 아무런 영향을 미치지 않습니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 이면 에이전트가 Kubernetes에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우 에이전트는 Pivotal Cloud Foundry 환경에서 실행 중임을 자동으로 감지합니다.
유형 | 부울 |
|---|---|
기본값 |
|
환경 변수 |
|
true 인 경우, 에이전트는 에이전트 시작 시간을 단축하기 위해 환경 감지를 병렬로 수행합니다.