ここでは、 Python エージェントの属性を有効または無効にするための設定について説明しています。 、当社のエージェントが デスティネーションに対してどの属性を含めるか、または除外するかを決定する際のルールについて説明しています。 。
これには、Pythonのエージェント設定 のうち、エージェント属性のリリースに伴い廃止された設定の概要も含まれています 。
構成設定
以下のデスティネーション設定を使用して、任意の属性コレクションに対してデスティネーションを開いたり閉じたりします。
トランザクション追跡のすべての属性をオンまたはオフにします。 attributes.enabled が falseの場合、この構成設定がどのように設定されているかに関係なく、属性はトランザクション追跡に送信されません。
トレースされたエラーのすべての属性をオンまたはオフにします。 attributes.enabled が falseの場合、この構成設定がどのように設定されているかに関係なく、トレースされたエラーに属性は送信されません。
トランザクション イベントのすべての属性をオンまたはオフにします。 attributes.enabled が falseの場合、この構成設定がどのように設定されているかに関係なく、属性はトランザクション イベントに送信されません。
のすべての属性をオンまたはオフにします。 これは PageView の宛先に送信されるデータです。 attributes.enabledがfalseの場合、この設定がどのように設定されているかに関係なく、属性はブラウザ監視に送信されません。
特定の宛先で特定の属性を追加または削除するには、次の属性/宛先固有の .include または .exclude 設定を使用します。
タイプ： | ストリングスの空間分離されたリスト |
|---|
デフォルト： | （無し） |
|---|
属性が有効な場合、このリストにあるすべての属性キーが送信されます。
タイプ： | スペースで区切られた文字列のリスト |
|---|
デフォルト： | （無し） |
|---|
このリストのすべての属性キーは not 送信されます。
タイプ： | スペースで区切られた文字列のリスト |
|---|
デフォルト： | （無し） |
|---|
トランザクション トレースで属性が有効になっている場合、このリストにあるすべての属性キーがトランザクション トレースで送信されます。
タイプ： | スペースで区切られた文字列のリスト |
|---|
デフォルト： | （無し） |
|---|
このリストのすべての属性キーは、 not トランザクショントレースで送信されます。
タイプ： | スペースで区切られた文字列のリスト |
|---|
デフォルト： | （無し） |
|---|
属性がトレースエラーに有効な場合、このリストのすべての属性キーがトレースエラーで送信されます。
タイプ： | スペースで区切られた文字列のリスト |
|---|
デフォルト： | （無し） |
|---|
このリストのすべての属性キーは、 not トレースされたエラーで送信されます。
タイプ： | スペースで区切られた文字列のリスト |
|---|
デフォルト： | （無し） |
|---|
属性がトランザクションイベントで有効になっている場合、このリストのすべての属性キーがトランザクションイベントで送信されます。
タイプ： | スペースで区切られた文字列のリスト |
|---|
デフォルト： | （無し） |
|---|
このリストのすべての属性キーは、 not トランザクションイベントで送信されます。
タイプ： | スペースで区切られた文字列のリスト |
|---|
デフォルト： | （無し） |
|---|
browser_monitoringに対して属性が有効になっている場合、このリスト内のすべての属性キーがページビューで送信されます。
タイプ： | スペースで区切られた文字列のリスト |
|---|
デフォルト： | （無し） |
|---|
このリストで見つかったすべての属性キーは、 not ページビューで送信されます。
アトリビュートルール
エージェントは、これらのルールに従って、デスティネーションに対してどの属性を含めるか、または除外するかを決定します。
attributes.enabled フィールドは他のすべての設定よりも優先されます。 falseの場合、属性は報告されません。
設定例
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
デスティネーションが有効な場合、すべてのユーザー属性はデフォルトでそのデスティネーションに送信されます。
すべてのユーザー属性はデフォルトで trueに設定されます。ただし、デフォルトでは、リクエスト パラメータはすべての宛先に対して無効になっています。
設定例
attributes.enabled = true
出力例。
Keys passed in: foo, bar, baz
includeリストとexcludeリストに同じキーが記載されている場合は、指定されたキーを持つ属性は除外されます。
設定例
attributes.enabled = true
attributes.include = foo bar
attributes.exclude = nerd bar
出力例。
Keys passed in: foo, bar, nerd
キーは大文字と小文字を区別します。
設定例
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
複数のincludeまたはexclude属性が同じキーに影響を与える場合は、最も具体的な設定が優先されます。
設定例
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
デスティネーションにincludeまたはexclude属性が指定されている場合、そのデスティネーションにのみ影響を与えます。
設定例
transaction_events.attributes.exclude = foo
出力例。
Keys included for transaction events:
Keys included for other destinations: foo
Keys excluded for transaction events: foo
非推奨の設定項目
以下の設定項目は非推奨となりました。Pythonエージェントをアップグレードする際には、これらの設定を新しい属性の設定に切り替えてください。
Deprecated setting | New setting |
|---|
capture_params
| attributes.include = request.parameters.*
デフォルトでは、リクエストパラメータは送信されません。すべてのリクエスト パラメータをオンにするには、 request.parameters.* を attributes.include リストに追加します。 capture_params プロパティは非推奨になりました。 |
ignored_params
| attributes.exclude = request.parameters.{name}
各リクエスト パラメータ キーを attributes.exclude リストに追加します。キーの前に必ず request.parametersを付けてください。 ignored_params プロパティは非推奨になりました。 |
analytics_events.enabled
| transaction_events.enabled
|
analytics_events.capture_attributes
| transaction_events.capture_attributes
|
analytics_events.max_samples_stored
| transaction_events.max_samples_stored
|
browser_monitoring.capture_attributes
| browser_monitoring.attributes.enabled
|
error_collector.capture_attributes
| error_collector.attributes.enabled
|
transaction_tracer.capture_attributes
| transaction_tracer.attributes.enabled
|