AjaxRequest 이벤트 설정

에이전트 버전 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의 거부 목록을 업데이트하려면 앱 설정 페이지로 이동하십시오.

1. one.newrelic.com > All capabilities > Browser > (select an app) > Settings > Application settings 으)로 이동합니다.
2. AJAX data capture settings 섹션의 Deny list 필드에 앱에 적용할 필터를 추가하십시오.
3. 에이전트 설정을 업데이트하려면 Save 선택하세요.
4. 브라우저 에이전트를 다시 배포합니다 (연결된 APM에이전트를 다시 시작하거나 브라우저 설치 복사/붙여넣기 업데이트).

거부 목록 필터를 검증합니다.

추가한 필터가 예상대로 작동하는지 확인하려면 필터와 일치하는 AjaxRequest 이벤트에 대해 NRQL 쿼리를 실행하세요.

FROM AjaxRequest SELECT * WHERE requestUrl LIKE '%example.com%'

페이로드 캡처 데이터

모든 requests 또는 실패한 requests에 대해서만 페이로드 캡처를 활성화할 수 있습니다. 활성화되면 브라우저 에이전트는 허용된 모든 도메인에 대한 모든 AJAX 호출의 요청 및 응답 페이로드를 캡처합니다. 이는 응답 본문에 숨겨진 오류와 같이 메타데이터만으로는 보이지 않는 실패를 디버깅하는 데 유용합니다.

AJAX 페이로드 캡처를 활성화하면 브라우저 에이전트가 AjaxRequest 이벤트에 다음 속성을 추가합니다:

• requestBody: 요청 페이로드입니다.
• requestHeaders: JSON 형식의 요청 헤더입니다.
• requestQuery: JSON 형식의 URL 쿼리 파라미터입니다.
• responseBody: 응답 페이로드.
• responseHeaders: JSON 형식의 응답 헤더입니다.
• ajaxRequest.id: 각 AJAX 요청에 대한 고유 식별자입니다.

모든 페이로드 데이터 속성은 4096바이트에서 잘립니다. 잘림이 발생하면 마지막 4바이트가 ... (으)로 대체되어 내용이 잘렸음을 나타냅니다.

페이로드 캡처 활성화

다음 방법 중 하나를 사용하여 페이로드 캡처를 활성화할 수 있습니다:

window.NREUM.init = {
    ...<other init properties>...,
    ajax: {
      deny_list: ["bam.nr-data.net"],
      capture_payloads: 'failures' // or 'none', 'all'
    }
}

import { BrowserAgent } from '@newrelic/browser-agent/loaders/browser-agent'

const options = {
  init: {
    ...<other init properties>...,
    ajax: {
      deny_list: ["bam.nr-data.net"],
      capture_payloads: 'failures' // or 'none', 'all'
    }
  },
  info: { ... },
  loader_config: { ... }
}

new BrowserAgent(options)

페이로드 캡처를 처음 활성화하면 뉴렐릭은 일반적인 민감한 데이터를 보호하기 위해 기준 난독화 룰을 자동으로 추가합니다:

• 신용카드 번호: 주요 신용카드 형식(Visa, MasterCard, American Express, Discover 등)을 감지하고 마스크 처리합니다.
• 사회 보장 번호: SSN 패턴을 감지하고 마스크합니다.

뉴렐릭 플랫폼에서 난독화 룰을 설정하여 민감한 데이터가 뉴렐릭으로 전송되기 전에 마스크할 수 있습니다. 난독화 룰에 대한 자세한 내용은 브라우저 에이전트 데이터 난독화를 참조하십시오.

페이로드 캡처 설정을 활성화한 후, 다음 페이지에서 캡처된 페이로드 데이터를 확인할 수 있습니다:

• AJAX 요청 세부 정보
• 페이지 보기
• 세션 재생

페이로드 캡처가 거부 목록과 상호 작용하는 방식

페이로드 캡처는 기존 거부 목록을 준수합니다. 모든 AJAX 요청의 경우:

• URL이 거부 목록에 있는 경우 이벤트는 완전히 삭제되며 메타데이터나 페이로드는 캡처되지 않습니다.
• URL이 거부 목록에 없는 경우, 페이로드 캡처 설정에 따라 에이전트는 request 및 응답 페이로드를 캡처하고 데이터를 뉴렐릭으로 보내기 전에 난독화 룰을 적용합니다.

관련 문서