이것은 New Relic이 대상 에 대해 포함하거나 제외할 속성을 결정하는 데 사용하는 규칙을 설명합니다. 여기에는 버전 9.0 이상의 New Relic 에이전트 특성 릴리스에서 더 이상 사용할 수 없었던 .NET 에이전트 속성의 요약도 포함됩니다.
속성 규칙
New Relic은 다음 규칙에 따라 포함하거나 제외할 속성을 결정합니다.
attributes.enabled
필드는 다른 모든 설정을 재정의합니다. false
일 때 New Relic에 속성이 보고되지 않습니다.
구성 예:
<attributes enabled="false"> <include>foo</include> <include>bar</include></attributes><transactionTracer enabled="true"> <attributes enabled="true"/></transactionTracer>
출력 예:
Keys passed in: foo, bar, batKeys included for all destinations:Keys excluded for all destinations: foo, bar, bat
{destination}.attributes.enabled
플래그는 포함 및 제외 키보다 우선합니다.
구성 예:
<attributes enabled="true"> <include>one</include> <include>two</include></attributes><transactionTracer enabled="true"> <attributes enabled="false"> <include>three</include> <include>four</include> </attributes></transactionTracer>
출력 예:
Keys passed in: one, two, three, fourKeys included for transaction traces:Keys excluded for transaction traces: one, two, three, four
대상이 활성화되면 모든 사용자 속성이 기본적으로 해당 대상으로 전송됩니다.
모든 사용자 속성의 기본값은 true
입니다. 그러나 기본적으로 모든 대상에 대해 요청 속성 및 메시지 매개변수가 비활성화되어 있습니다.
구성 예:
<attributes enabled="true"> <exclude>myAttKey</exclude></attributes>
출력 예:
Keys passed in: foo, bar, myAttKeyKeys included: foo, barKeys excluded: myAttKey
동일한 키가 포함 및 제외 목록에 나열되면 지정된 키가 있는 속성이 제외됩니다.
구성 예:
<attributes enabled="true"> <include>foo</include> <include>myCustomAtt</include> <exclude>password</exclude> <exclude>myCustomAtt</exclude></attributes>
출력 예:
Keys passed in: foo, myCustomAtt, passwordKeys included: fooKeys excluded: password, myCustomAtt
키는 대소문자를 구분합니다.
구성 예:
<attributes enabled="true"> <exclude>password</exclude> <exclude>PaSsWoRd</exclude></attributes>
출력 예:
Keys passed in: password, Password, PASSWORD, PaSsWoRd, PassWORDKeys included: Password, PASSWORD, PassWORDKeys excluded: password, PaSsWoRd
키 끝에 별표 *
를 와일드카드로 사용할 수 있습니다. 이것은 동일한 접두사를 가진 모든 속성과 일치합니다.
구성 예:
<attributes enabled="true"> <include>custom*</include> <exclude>request.parameters.*</exclude></attributes>
출력 예:
Keys passed in: custom, custom.key1, custom.key2, request.parameters., request.parameters.foo, request.parameters.barKeys included: custom, custom.key1, custom.key2Keys excluded: request.parameters., request.parameters.foo, request.parameters.bar
여러 포함 또는 제외 속성이 동일한 키에 영향을 미치는 경우 가장 구체적인 설정이 우선합니다.
구성 예:
<attributes enabled="true"> <include>request.parameters.foo</include> <exclude>request.parameters.*</exclude></attributes>
출력 예:
Keys passed in: request.parameters., request.parameters.foo, request.parameters.barKeys included: request.parameters.fooKeys excluded: request.parameters., request.parameters.bar
속성 include
또는 exclude
이 대상에 지정된 경우 해당 대상에만 영향을 줍니다.
구성 예:
<attributes enabled="true"> <include>foo</include></attributes><transactionEvents enabled="true"> <attributes enabled="true"> <exclude>foo</exclude> </attributes></transactionEvents>
출력 예:
Keys passed in: fooKeys included for transaction events:Keys included for other destinations: fooKeys excluded for transaction events: foo
더 이상 사용되지 않는 속성
다음 속성은 .NET 에이전트 v9.0에서 사용할 수 없습니다. .NET 에이전트를 업그레이드할 때 대체 속성에 대해서는 .NET 에이전트 8.x에서 9.x로의 마이그레이션 가이드 페이지를 방문하십시오.
newrelic.config 의 analyticsEvents
요소는 더 이상 사용되지 않습니다. newrelic.config 에서 transactionEvents
요소를 활성화합니다.
<transactionEvents enabled="true"/>
기본적으로 요청 매개변수는 New Relic으로 전송되지 않습니다. 요청 매개변수 수집을 활성화하려면 attributes.include
목록에 request.parameters.*
을 추가합니다.
<attributes> <include>request.parameters.*</include></attributes>
parameterGroups
값과 해당 enabled
및 ignore
설정은 더 이상 사용되지 않습니다. 기본적으로 customParameters
및 responseHeaderParameters
는 계측되지만 serviceRequestParameters
는 계측되지 않습니다. 이러한 설정을 사용자 지정하려면:
browserMonitoring
, transactionTracer
, transactionEvents
및 errorCollector
의 캡처 속성 플래그는 더 이상 사용되지 않습니다. 대신 attributes
하위 요소를 사용하여 이러한 각 대상에 대한 속성 설정을 구성합니다.
New property | Example |
---|---|
| |
| |
| |
|