ここでは、New Relic PHP エージェントで属性を使用する例を紹介します。これらの設定を使用するには
- 必要に応じて、
newrelic.ini
ファイルを変更します。 - 変更を有効にするために、エージェントとそのデーモンを再起動します。
キャプチャーリクエストパラメーター
デフォルトでは、エージェントはリクエストパラメータをキャプチャしません。
次の構成を使用して、デフォルトの宛先 transaction_tracer
、 transaction_events
、および error_collector
のパラメーターのキャプチャを有効にすることができます。パラメータをキャプチャする宛先を制限する場合は、 「特定の宛先の選択」を参照してください。
Configuration:
newrelic.attributes.include = request.parameters.*
特定のリクエストパラメータのみを取得
特定のリクエスト パラメータのみをキャプチャするには、リストを attributes.include
に渡します。
Configuration:
newrelic.attributes.include = request.parameters.user_id request.parameters.product_id
すべてのアトリビュートを無効にする
この例では、属性が無効になっているため、includeとexcludeのリストは無視され、すべての属性がフィルタリングされます。
Configuration:
newrelic.attributes.enabled = falsenewrelic.attributes.include = request.parameters.*
Input keys:
foo, bar, request.parameters.foo, request.parameters.bar
Output for destinations:
transaction_tracer: noneerror_collector: nonetransaction_events: nonebrowser_monitoring: none
特定の目的地を選択する
この例では
トランザクション トレースでは、属性が無効になります。インクルード リストとエクスクルード リストは無視され、この宛先ではすべての属性がフィルタリングされます。
の属性もデフォルトで無効になっています。
リクエストパラメータ(プレフィックスが
request.parameters.
)は、すべての宛先でデフォルトでオフになっています。
その結果、トレースされたエラーとトランザクションイベントで送信されるのはbar
のみです。
Configuration:
newrelic.attributes.enabled = truenewrelic.transaction_tracer.attributes.enabled = falsenewrelic.attributes.exclude = foo
Input keys:
foo, bar, request.parameters.foo, request.parameters.bar
Output for destinations:
transaction_tracer: noneerror_collector: bartransaction_events: barbrowser_monitoring: none
値と目的地の選択
この例では、特定の出力先には特定の入力キーが選択され、他の出力先には選択されません。
food.fruit.banana
キーは、トランザクショントレースからのみ除外されます。food
キーとfood.bread
キーはすべての宛先から除外されます。
Configuration:
newrelic.browser_monitoring.attributes.enabled = truenewrelic.attributes.exclude = food*newrelic.attributes.include = food.fruit.*newrelic.transaction_tracer.attributes.exclude = food.fruit.banana
Input keys:
food, food.bread, food.fruit.banana, food.fruit.apple
Output for destinations:
transaction_tracer: food.fruit.appleerror_collector: food.fruit.banana, food.fruit.appletransaction_events: food.fruit.banana, food.fruit.applebrowser_monitoring: food.fruit.banana, food.fruit.apple