속성 활성화 및 비활성화(Ruby)

여기에서는 속성을 활성화 또는 비활성화하는 속성과 뉴렐릭이 대상 에 포함하거나 제외할 속성을 결정할 때 사용하는 규칙에 대해 설명합니다. 여기에는 뉴렐릭 에이전트 속성 출시로 더 이상 사용되지 않거나 제거된 루비 에이전트 속성에 대한 요약도 포함됩니다.

속성

다음 속성을 사용하여 속성을 활성화하거나 비활성화합니다.

유형	부울
기본값	`true`
환경 변수	`NEW_RELIC_ATTRIBUTES_ENABLED`

true 인 경우 모든 대상에 대한 속성 캡처를 활성화합니다.

유형	부울
기본값	(동적)
환경 변수	`NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLED`

true 인 경우 에이전트는 에서 속성을 캡처합니다.

유형	정렬
기본값	`[]`
환경 변수	`NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDE`

오류 수집에서 제외할 속성의 접두사. 끝에 와일드카드로 * 을 허용합니다.

error.message 수집을 방지하려면 대신 strip_exception_messages 구성을 사용하십시오.

속성 규칙

New Relic은 대상에 대해 포함하거나 제외할 속성을 결정할 때 이러한 규칙을 따릅니다.

attributes.enabled 필드는 다른 모든 설정보다 우선합니다. false 일 때 New Relic에 속성이 보고되지 않습니다.

구성 예:

attributes.enabled: false
    attributes.include: foo, bar
    transaction_tracer.attributes.enabled: true

출력 예:

Keys passed in: foo, bar, baz
    Keys included for all destinations:
    Keys excluded for all destinations: foo, bar, baz

YOUR_DESTINATION.attributes.enabled 플래그는 포함 및 제외 키보다 우선합니다.

구성 예:

transaction_tracer.attributes.enabled: false
    attributes.include: one, two
    transaction_tracer.attributes.include: three, four

출력 예:

Keys passed in: one, two, three, four
    Keys included for transaction traces:
    Keys excluded for transaction traces: one, two, three, four

대상이 활성화되면 모든 사용자 속성이 기본적으로 해당 대상으로 전송됩니다.

Note: 모든 사용자 속성의 기본값은 true 입니다. 그러나 기본적으로 모든 대상에 대해 요청 매개변수가 비활성화되어 있습니다.

구성 예:

attributes.enabled: true
    attributes.exclude: baz

출력 예:

Keys passed in: foo, bar, baz
    Keys included: foo, bar
    Keys excluded: baz

동일한 키가 포함 및 제외 목록에 나열되면 지정된 키가 있는 속성이 제외됩니다.

구성 예:

attributes.enabled: true
    attributes.include: foo, bar
    attributes.exclude: nerd, bar

출력 예:

Keys passed in: foo, bar, nerd
    Keys included: foo
    Keys excluded: nerd, bar

키는 대소문자를 구분합니다.

구성 예:

attributes.enabled: true
    attributes.exclude: username, UsErNaMe

출력 예:

Keys passed in: username, Username, USERNAME, UsErNaMe, userNAME
    Keys included: Username, USERNAME, userNAME
    Keys excluded: username, UsErNaMe

키 끝에 별표 * 를 와일드카드로 사용할 수 있습니다. 이것은 동일한 접두사를 가진 속성 집합과 일치합니다.

구성 예:

attributes.enabled: true
    attributes.include: custom*
    attributes.exclude: request.parameters.*

출력 예:

Keys passed in: custom, custom.key1, custom.key2, request.parameters., request.parameters.foo, request.parameters.bar
    Keys included: custom, custom.key1, custom.key2
    Keys excluded: request.parameters., request.parameters.foo, request.parameters.bar

여러 포함 또는 제외 속성이 동일한 키에 영향을 미치는 경우 가장 구체적인 설정이 우선합니다.

구성 예:

attributes.enabled: true
    attributes.include: request.parameters.foo
    attributes.exclude: request.parameters.*

출력 예:

Keys passed in: request.parameters., request.parameters.foo, request.parameters.bar
    Keys included: request.parameters.foo
    Keys excluded: request.parameters., request.parameters.bar

포함 또는 제외 속성이 대상에 지정된 경우 해당 대상에만 영향을 줍니다.

구성 예:

attributes.include: foo
    transaction_events.attributes.exclude: foo

출력 예:

Keys passed in: foo
    Keys included for transaction events:
    Keys included for other destinations: foo
    Keys excluded for transaction events: foo

URI 관련 속성

기본적으로 Ruby 에이전트는 URI(Uniform Resource Identifiers)를 다음 대상을 비롯한 여러 위치에서 New Relic에 보고합니다.

오류 이벤트 의 request.uri 속성
스팬 이벤트 의 http.url 속성
느린 SQL 추적 의 url 속성
외부 요청 세그먼트 의 uri 속성

New Relic에서는 유용한 디버깅 정보가 포함될 수 있는 이러한 URI를 보고할 것을 권장합니다. URI에 이메일 주소, 계정 ID 등 보고하고 싶지 않은 민감한 데이터가 포함되어 있는 경우 URI 보고를 비활성화할 수 있습니다. URI 보고를 비활성화하려면 위의 속성 이름 중 하나를 attributes.exclude 목록에 추가하세요.

예를 들어 구성 파일에 다음 키를 추가하면 에이전트가 URI 관련 속성을 보고하지 않게 됩니다.

attributes.exclude: uri

더 이상 사용되지 않고 제거된 속성

다음 속성은 더 이상 사용되지 않거나 제거되었습니다. Ruby 에이전트를 업그레이드할 때 이러한 속성에 대한 새 속성 구성으로 전환하세요.

Deprecated property	New property	Removed Version
`capture_params`	`attributes.include: request.parameters.*`	해당 없음
`resque.capture_params`	`attributes.include: job.resque.args.*`	9.0.0
`sidekiq.capture_params`	`attributes.include: job.sidekiq.args.*`	9.0.0
`transaction_tracer.capture_attributes`	`transaction_tracer.attributes.enabled`	9.0.0
`error_collector.capture_attributes`	`error_collector.attributes.enabled`	9.0.0
`browser_monitoring.capture_attributes`	`browser_monitoring.attributes.enabled`	9.0.0
`analytics_events.capture_attributes`	`transaction_events.attributes.enabled`	9.0.0

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

속성 활성화 및 비활성화(Ruby)

속성

속성.활성화

transaction_tracer.attributes.enabled

transaction_events.attributes.enabled

error_collector.attributes.enabled

browser_monitoring.attributes.enabled

span_events.attributes.enabled

transaction_segments.attributes.enabled

속성.제외

transaction_tracer.attributes.exclude

transaction_events.attributes.exclude

error_collector.attributes.exclude

browser_monitoring.attributes.exclude

span_events.attributes.exclude

transaction_segments.attributes.exclude

속성.포함

transaction_tracer.attributes.include

transaction_events.attributes.include

error_collector.attributes.include

browser_monitoring.attributes.include

span_events.attributes.include

transaction_segments.attributes.include

속성 규칙

활성화된 경우 루트 수준이 우선합니다.

활성화된 대상은 포함 및 제외보다 우선합니다.

대상이 활성화된 경우 속성이 포함됩니다.

제외는 항상 포함을 대체합니다.

키는 대소문자를 구분합니다.

와일드카드에는 `\*` 을 사용합니다.

키에 대한 가장 구체적인 설정이 우선합니다.

포함 또는 제외는 특정 대상에 영향을 줍니다.

URI 관련 속성

더 이상 사용되지 않고 제거된 속성

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

속성 활성화 및 비활성화(Ruby)

속성.css-21sua1{background:none;border:none;width:0;padding:0;}

transaction_tracer.attributes.enabled

transaction_events.attributes.enabled

error_collector.attributes.enabled

browser_monitoring.attributes.enabled

span_events.attributes.enabled

transaction_segments.attributes.enabled

속성.제외

transaction_tracer.attributes.exclude

transaction_events.attributes.exclude

error_collector.attributes.exclude

browser_monitoring.attributes.exclude

span_events.attributes.exclude

transaction_segments.attributes.exclude

속성.포함

transaction_tracer.attributes.include

transaction_events.attributes.include

error_collector.attributes.include

browser_monitoring.attributes.include

span_events.attributes.include

transaction_segments.attributes.include

속성 규칙

활성화된 경우 루트 수준이 우선합니다.

활성화된 대상은 포함 및 제외보다 우선합니다.

대상이 활성화된 경우 속성이 포함됩니다.

제외는 항상 포함을 대체합니다.

키는 대소문자를 구분합니다.

와일드카드에는 \* 을 사용합니다.

키에 대한 가장 구체적인 설정이 우선합니다.

포함 또는 제외는 특정 대상에 영향을 줍니다.

URI 관련 속성

더 이상 사용되지 않고 제거된 속성

속성

와일드카드에는 `\*` 을 사용합니다.