エージェント バージョン 1211以降では、ページによって行われたすべてのネットワークrequestsはAjaxRequestイベントとして記録されます。どのrequestsを記録し、どのデータをキャプチャするかを構成できます：
- 拒否リスト：AJAXトラッキングから除外するドメインとURLをフィルタリングします。
- ペイロードのキャプチャ: 障害のデバッグのために、完全なリクエストとレスポンスのデータを記録します。
拒否リスト
デフォルトでは、アプリケーションによって行われたすべてのネットワークrequestsのAjaxRequestイベントが記録されます。
- すべてのイベントの記録を停止するには、単数の
*(アスタリスク) ワイルドカード文字を追加します。- 例：
*
- 例：
- サイト全体のイベントの記録を停止するには、ドメイン名を追加します。
- 例：
mywebsite.com
- 例：
- 特定のページのイベントの記録を停止するには、ドメインとパスを追加します。
- 例：
mywebsite.com/photos
- 例：
- エージェントバージョン1.307.0以降、
*(アスタリスク) が見つかる場所であればどこでも、任意の長さの文字列と一致します。- 例:
mywebsite.com/shop/*(パスの場合)、*.mywebsite.com(サブドメインの場合)、mywebsite.com/*/shop/*/checkout(URL の途中の文字列の場合)。
- 例:
URLのプロトコル、ポート、検索、およびハッシュは、拒否リストによって無視されます。
拒否リストへのアクセス
アプリケーションがイベント作成時にフィルタリングするURLの拒否リストを更新するには、アプリの設定ページに移動します。
- one.newrelic.com > All capabilities > Browser > (select an app) > Settings > Application settingsに移動します。
- 「AJAX data capture settings」セクションの「Deny list」フィールドに、アプリに適用するフィルターを追加してください。
- エージェント設定を更新するには、 Save選択します。
- Browser エージェントを再デプロイします(関連付けられている エージェントを再起動するか、コピー/貼り付けのbrowserインストレーションを更新します)。
重要
ここで変更を保存すると、Application settingsページに表示されるNREUM.init設定のみが更新されます。NPM経由でインストールされたエージェントには自動的に反映されません。
NPMパッケージを使用してBrowserエージェントをインストールした場合は、アプリケーションのinit設定のajax.deny_list値を手動で更新し（またはUIから再度コピーし）、その後、変更を有効にするためにアプリケーションを再ビルドして再デプロイする必要があります。
拒否リストフィルターを検証します
追加したフィルターが期待どおりに機能するかどうかを検証するには、フィルターに一致するAjaxRequestイベントに対して NRQL クエリを実行します。
FROM AjaxRequest SELECT * WHERE requestUrl LIKE '%example.com%'ペイロードキャプチャデータ
重要
ペイロードのキャプチャには、Browserエージェントのバージョン1.317.0以降が必要です。
すべてのrequestsまたは失敗したrequestsに対してのみ、ペイロードキャプチャを有効にすることができます。有効にすると、Browserエージェントは、許可されたすべてのドメインのすべてのAJAX呼び出しに対するリクエストとレスポンスのペイロードをキャプチャします。これは、レスポンス本文に隠されているエラーなど、メタデータだけでは確認できない障害をデバッグするのに役立ちます。
AJAXペイロードキャプチャを有効にすると、BrowserエージェントはAjaxRequestイベントに次の属性を追加します：
requestBody：リクエストのペイロード。requestHeaders：JSON形式のリクエストヘッダー。requestQuery：JSON形式のURLクエリパラメーター。responseBody：レスポンスペイロード。responseHeaders：JSON形式のレスポンスヘッダー。ajaxRequest.id：各AJAXリクエストの一意の識別子。
すべてのペイロードデータ属性は4,096バイトで切り捨てられます。切り捨てが発生した場合、コンテンツが切り取られたことを示すために、最後の4バイトが...に置き換えられます。
ペイロードキャプチャの有効化
次のいずれかの方法を使用して、ペイロードキャプチャを有効にすることができます：
ペイロードキャプチャを初めて有効にすると、New Relicは一般的な機密データを保護するためにベースラインの難読化ルールを自動的に追加します：
- クレジットカード番号：主要なクレジットカードの形式（Visa、MasterCard、American Express、Discoverなど）を検出し、マスクします。
- 社会保障番号：SSNパターンを検出してマスクします
New Relicプラットフォームで難読化ルールを設定して、機密データがNew Relicに送信される前にマスクすることができます。難読化ルールの詳細については、Browserエージェントデータの難読化を参照してください。
ペイロードキャプチャ設定を有効にした後、次のページでキャプチャされたペイロードデータを表示できます：
ペイロードのキャプチャと拒否リストの相互作用
ペイロードのキャプチャは、既存の拒否リストを尊重します。任意のAJAXリクエストの場合：
- URLが拒否リストにある場合、イベントは完全に破棄され、メタデータやペイロードはキャプチャされません。
- URLが拒否リストにない場合、ペイロードのキャプチャ設定に基づいて、エージェントはリクエストとレスポンスのペイロードをキャプチャし、データをNew Relicに送信する前に難読化ルールを適用します。