エージェント バージョン 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インストレーションを更新します)。
重要
Saving changes here only updates the NREUM.init configuration shown on the Application settings page. It doesn't take effect automatically for agents installed via NPM.
If you installed the browser agent using the NPM package, you must manually update the ajax.deny_list value in your application's init configuration (or re-copy it over from the UI), then rebuild and redeploy your application for the change to take effect.
拒否リストフィルターを検証します
追加したフィルターが期待どおりに機能するかどうかを検証するには、フィルターに一致する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に送信する前に難読化ルールを適用します。