• 로그인지금 시작하세요

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

특정 거래 무시

New Relic for Ruby를 사용하면 Rails 또는 Sinatra 애플리케이션 내의 특정 요청에 대한 계측을 선택적으로 비활성화할 수 있습니다.

중요

이 절차는 Rails 버전 7 이상에서 테스트되지 않았습니다.

모든 계측 차단

Rails 컨트롤러 또는 Sinatra 애플리케이션 내에서 인수 없이 newrelic_ignore 를 호출하여 해당 컨트롤러 또는 애플리케이션에서 서비스하는 모든 요청의 계측을 방지합니다.

newrelic_ignore

newrelic_ignore 을 사용하면 에이전트가 대상 트랜잭션에 대한 성능 데이터(측정항목, 트랜잭션 추적, 이벤트, 추적된 오류 등)를 기록하지 못하게 하고 트랜잭션이 전체 Apdex 점수에 기여하는 것도 방지합니다.

Rails로 특정 작업 무시하기

Rails 컨트롤러에서 특정 작업만 무시하려면 newrelic_ignore 와 함께 { :only 또는 :except 옵션을 사용할 수 있습니다.

예를 들어 컨트롤러에서 indexshow 작업만 무시하려면 다음을 사용합니다.

newrelic_ignore :only => [:index, :show]

index 을(를) 제외한 컨트롤러의 모든 작업을 무시하려면 다음을 수행합니다.

newrelic_ignore :except => [:index]

Sinatra로 특정 경로 무시하기

Sinatra 애플리케이션 내의 특정 경로만 무시하려면 Sinatra 애플리케이션 내에서 Sinatra 스타일 경로 정의를 newrelic_ignore 에 전달할 수 있습니다. 자세한 내용은 Sinatra: 경로 무시 를 참조하십시오.

Apdex 기여 무시

컨트롤러의 모든 작업이 Apdex 점수에 기여하는 것을 방지하지만 여전히 다른 성능 데이터를 원하는 경우 newrelic_ignore_apdex 을 사용합니다.

newrelic_ignore_apdex

Rails 애플리케이션에서 newrelic_ignore_apdexnewrelic_ignore }과 동일한 :only:except 옵션 을 지원합니다. Sinatra 애플리케이션에서는 특정 트랜잭션을 대상으로 하는 동일한 Sinatra 스타일 경로 를 허용합니다.

브라우저 계측 차단

newrelic_ignore_enduser 을 사용하면 에이전트가 브라우저 모니터링 데이터를 캡처하는 데 사용되는 JavaScript를 자동으로 삽입하지 못합니다. 서버 측 계측은 영향을 받지 않습니다.

컨트롤러의 모든 작업에 대한 브라우저 에이전트 삽입을 방지하려면 컨트롤러 클래스에 다음과 같은 호출을 추가합니다.

newrelic_ignore_enduser

Rails 애플리케이션에서 newrelic_ignore_endusernewrelic_ignore }과 동일한 :only:except 옵션 을 지원합니다. Sinatra 애플리케이션에서는 특정 트랜잭션을 대상으로 하는 동일한 Sinatra 스타일 경로 를 허용합니다.

동적으로 트랜잭션 무시

어떤 경우에는 요청하는 동안 런타임에만 알려진 기준에 따라 특정 트랜잭션을 무시하기로 결정할 수 있습니다. 이와 같은 시나리오의 경우 위에서 설명한 선언적 메커니즘은 적합하지 않습니다. Ruby 에이전트 버전 3.9.2부터 트랜잭션 내 어느 지점에서나 다음 API 호출 패밀리를 대신 사용할 수 있습니다.

NewRelic::Agent.ignore_transaction
NewRelic::Agent.ignore_apdex
NewRelic::Agent.ignore_enduser

이러한 메서드는 newrelic_ignore , newrelic_ignore_apdexnewrelic_ignore_enduser 호출과 유사한 결과를 갖지만 클래스 정의 대신 요청 중에 호출할 수 있습니다.

구성이 있는 URL로 트랜잭션 무시

rules.ignore_url_regexes 구성 설정을 사용하여 URL별 트랜잭션을 무시할 수 있습니다.

rules:
ignore_url_regexes: ["secret", "^/admin"]

이 구성은 설정된 패턴과 일치하는 트랜잭션 이벤트 만 보고하는 것을 방지합니다. 추적 데이터와 같은 모든 데이터가 트랜잭션에서 보고되지 않도록 하려면 newrelic_ignore* 메서드 계열을 사용합니다.

정규식은 기본적으로 고정 유형을 포함하지 않습니다. /secret/ regex는 'newrelic.com/secret/login'과 일치하고 'newrelic.com/users/secretpanda'와도 일치합니다. 고정된 관리 정규식은 'newrelic.com/admin/praetorians'와 일치하지만 'newrelic.com/users/totally-real-admin'과 일치하지 않습니다.

필요한 경우 쉼표로 구분된 문자열에 정규식 목록을 제공하여 환경 변수로 정규식 무시를 설정할 수도 있습니다.

NEW_RELIC_RULES_IGNORE_URL_REGEXES="secret,^/admin"

항상 환경 변수의 구성은 newrelic.yml의 구성을 재정의합니다.

문제점 해결

newrelic_ignore* 메서드 제품군은 Rails 컨트롤러 클래스 또는 Sinatra 애플리케이션( Sinatra::Base 의 하위 클래스) 내에서만 작동합니다. 다른 애플리케이션은 무시하려는 각 요청 내에서 NewRelic::Agent.ignore_* 호출 패밀리를 사용해야 하며 이는 모든 컨텍스트에서 작동합니다.

Rails 컨트롤러 또는 Sinatra 애플리케이션 내에서 newrelic_ignore 을 사용하려고 할 때 NoMethodError 가 표시되면 클래스 정의 내에서 newrelic_ignore 호출을 시도하기 전에 newrelic_rpm 가 필수인지 확인하십시오.

Copyright © 2022 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.