ここでは、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, 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: myAttKeyincludeリストとexcludeリストに同じキーが記載されている場合は、指定されたキーを持つ属性は除外されます。
設定例
<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複数の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.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"/>デフォルトでは、リクエストパラメータはNewRelicに送信されません。 request.parameters.*をattributes.includeリストに追加して、要求パラメーターの収集を有効にします。
<attributes> <include>request.parameters.*</include></attributes>parameterGroups値とそのenabledおよびignore設定は廃止されました。デフォルトでは、 customParametersとresponseHeaderParametersがインストルメントされていますが、 serviceRequestParametersはインストルメントされていません。これらの設定をカスタマイズするには：
browserMonitoring 、 transactionTracer 、 transactionEvents 、およびerrorCollectorのキャプチャ属性フラグは廃止されました。代わりに、 attributesサブ要素を使用して、これらの各宛先の属性設定を構成します。
新規物件 | 例 |
|---|---|
| |
| |
| |
|