属性の有効化と無効化（.NET）

ここでは、New Relic がデスティネーションに対してどの属性を含めるか、または除外するかを決定するために使用するルールについて説明しています。また、バージョン 9.0 以降の New Relic エージェント属性のリリースに伴い、利用できなくなった .NET エージェント属性の概要も記載しています。

アトリビュートルール

New Relic はこれらのルールに従って、どの属性を含めるか、あるいは除外するかを決定します。

attributes.enabledフィールドは他のすべての設定を上書きします。 falseの場合、属性はNewRelicに報告されません。

設定例

<attributes enabled="false">
  <include>foo</include>
  <include>bar</include>
</attributes>
<transactionTracer enabled="true">
  <attributes enabled="true"/>
</transactionTracer>

出力例。

Keys passed in: foo, bar, bat
Keys 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, four
Keys 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, myAttKey
Keys included: foo, bar
Keys excluded: myAttKey

includeリストとexcludeリストに同じキーが記載されている場合は、指定されたキーを持つ属性は除外されます。

設定例

<attributes enabled="true">
  <include>foo</include>
  <include>myCustomAtt</include>
  <exclude>password</exclude>
  <exclude>myCustomAtt</exclude>
</attributes>

出力例。

Keys passed in: foo, myCustomAtt, password
Keys included: foo
Keys excluded: password, myCustomAtt

キーは大文字と小文字を区別します。

設定例

<attributes enabled="true">
  <exclude>password</exclude>
  <exclude>PaSsWoRd</exclude>
</attributes>

出力例。

Keys passed in: password, Password, PASSWORD, PaSsWoRd, PassWORD
Keys included: Password, PASSWORD, PassWORD
Keys 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.bar
Keys included: custom, custom.key1, custom.key2
Keys excluded: request.parameters., request.parameters.foo, request.parameters.bar

複数のincludeまたはexclude属性が同じキーに影響を与える場合は、最も具体的な設定が優先されます。

設定例

<attributes enabled="true">
  <include>request.parameters.foo</include>
  <exclude>request.parameters.*</exclude>
</attributes>

出力例。

Keys passed in: request.parameters., request.parameters.foo, request.parameters.bar
Keys included: request.parameters.foo
Keys 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: foo
Keys included for transaction events:
Keys included for other destinations: foo
Keys excluded for transaction events: foo

廃止されたプロパティ

以下のプロパティは、.NETエージェントv9.0では使用できません。.NETエージェントをアップグレードする際の代替プロパティについては、 .NETエージェント8.xから9.xへの移行ガイドのページをご覧ください。

デフォルトでは、リクエストパラメータはNewRelicに送信されません。 request.parameters.*をattributes.includeリストに追加して、要求パラメーターの収集を有効にします。

<attributes>
  <include>request.parameters.*</include>
</attributes>

parameterGroups値とそのenabledおよびignore設定は廃止されました。デフォルトでは、 customParametersとresponseHeaderParametersがインストルメントされていますが、 serviceRequestParametersはインストルメントされていません。これらの設定をカスタマイズするには：

インストルメンテーションを有効にするには、 enabledフラグを使用します。
includeとexcludeを使用して、特定の属性のインストルメンテーションを切り替えます。
例えば：
```
<attributes enabled="true">
  <include>service.request.*</include>
  <exclude>response.headers.*</exclude>
  <exclude>myCustomApiKey.*</exclude>
</attributes>
```
アトリビュートの設定については、アトリビュートの例を参照してください。

browserMonitoring 、 transactionTracer 、 transactionEvents 、およびerrorCollectorのキャプチャ属性フラグは廃止されました。代わりに、 attributesサブ要素を使用して、これらの各宛先の属性設定を構成します。

New property	Example
`browserMonitoring`	`<browserMonitoring enabled="true"> <attributes enabled="false"> <include>myKey.*</include> <exclude>myKey.foo</exclude> </attributes> </browserMonitoring>`
`transactionTracer`	`<transactionTracer enabled="true"> <attributes enabled="false"> <include>myKey.*</include> <exclude>myKey.foo</exclude> </attributes> </transactionTracer>`
`transactionEvents`	`<transactionEvents enabled="true"> <attributes enabled="false"> <include>myKey.*</include> <exclude>myKey.foo</exclude> </attributes> </transactionEvents>`
`errorCollector`	`<errorCollector enabled="true"> <attributes enabled="false"> <include>myKey.*</include> <exclude>myKey.foo</exclude> </attributes> </errorCollector>>`

この機械翻訳は、参考として提供されています。

属性の有効化と無効化（.NET）

アトリビュートルール

Rootレベルが優先されて有効になります。

Destination enabledはincludeやexcludeよりも優先されます。

属性は、デスティネーションが有効な場合に含まれます。

Excludeは常にIncludeに優先します。

キーは大文字と小文字を区別します。

ワイルドカードにはアスタリスク`\*`を使用します。

キーの具体的な設定が優先されます。

特定のデスティネーションに影響を与えます。

廃止されたプロパティ

analyticsEventsがtransactionEventsに置き換わりました。

request.parametersをrequest.parameters.*に置き換えました。

parameterGroups：enableとignoreの代わりに、true、include、excludeの各属性を追加。

captureAttributesフラグがattributesサブエレメントに置き換えられました。

この機械翻訳は、参考として提供されています。

属性の有効化と無効化（.NET）

アトリビュートルール .css-21sua1{background:none;border:none;width:0;padding:0;}

Destination enabledはincludeやexcludeよりも優先されます。

属性は、デスティネーションが有効な場合に含まれます。

Excludeは常にIncludeに優先します。

キーは大文字と小文字を区別します。

ワイルドカードにはアスタリスク\*を使用します。

キーの具体的な設定が優先されます。

特定のデスティネーションに影響を与えます。

廃止されたプロパティ

analyticsEventsがtransactionEventsに置き換わりました。

request.parametersをrequest.parameters.*に置き換えました。

parameterGroups：enableとignoreの代わりに、true、include、excludeの各属性を追加。

captureAttributesフラグがattributesサブエレメントに置き換えられました。

アトリビュートルール

ワイルドカードにはアスタリスク`\*`を使用します。