• /
  • EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

보고서 브라우저 모니터링 사용자 지정 이벤트 및 속성

New Relic에서 브라우저 모니터링을 사용하여 사용자 정의 이벤트 및 속성 을 추가할 수 있습니다.

사용자 정의 속성

모든 브라우저 이벤트에 사용자 정의 속성을 추가하면 데이터를 쿼리하거나 필터링하여 독창적인 질문에 답할 수 있습니다.

맞춤 이벤트

사용자 정의 속성을 사용하여 모든 이벤트를 캡처하려면 브라우저 API의 recordCustomEvent 메서드를 사용합니다.

페이지 작업

브라우저 API의 addPageAction 호출을 사용하여 이벤트, 작업, 경로 변경 또는 애플리케이션과의 모든 최종 사용자 상호작용을 캡처합니다. addPageAction 호출은 작업 이름, 페이지와 관련된 메모데이터, 사용자 정의 속성 이름 및 이와 함께 캡처하는 값을 포함하는 PageAction 라는 이벤트를 추가합니다.

전제 조건

Custom 이벤트를 보고하려면 다음 전제 조건을 확인하세요.

Requirement

Comments

에이전트 버전

브라우저 모니터링 에이전트 버전은 1.277.0 이상 이어야 합니다.

클라이언트 브라우저 버전

Custom 이벤트를 기록하려면 브라우저가 도메인 간 XHR을 지원 해야 합니다.

사이클당 이벤트

Custom 이벤트는 다른 브라우저 이벤트와 함께 버퍼링되며 30초마다 전송됩니다. 총 1,000개의 이벤트가 관찰되면 에이전트는 하베스트 처리 간격을 우회하여 버퍼링된 이벤트를 즉시 수집합니다.

이벤트/속성 이름 지정, 데이터 유형, 크기

이벤트/속성 명명 구문, 데이터 유형 및 크기에 대한 일반 요구 사항 을 준수해야 합니다.

PageAction 이벤트를 보고하려면 다음 전제 조건을 확인하세요.

Requirement

Comments

에이전트 버전

브라우저 모니터링 에이전트 버전은 593 이상 이어야 합니다.

클라이언트 브라우저 버전

PageAction 이벤트를 기록하려면 브라우저가 도메인 간 XHR을 지원 해야 합니다.

사이클당 이벤트

PageAction 이벤트는 다른 브라우저 이벤트와 함께 버퍼링되며 30초마다 전송됩니다. 1,000개의 이벤트가 관찰되면 에이전트는 하베스트 처리 간격을 우회하여 버퍼링된 이벤트를 즉시 수집합니다.

이벤트/속성 이름 지정, 데이터 유형, 크기

이벤트/속성 명명 구문, 데이터 유형 및 크기에 대한 일반 요구 사항 을 준수해야 합니다.

사용자 홈페이지 만들기

custom 이벤트를 생성하려면:

  1. 앱에 브라우저 에이전트가 설치되어 있는지 확인하십시오.
  2. 애플리케이션의 JavaScript에서 관련 부분에 있는 newrelic.recordCustomEvent 함수를 호출합니다.
  3. 디버그가 실행되고 지정한 eventType에서 관련 custom 이벤트를 보고할 때까지 몇 분 정도 기다립니다.
  4. 이벤트를 캡처하는 데 사용한 eventType 속성(및 이벤트와 함께 보낸 모든 관련 속성)을 포함하는 이벤트의 NRQL 쿼리를 실행합니다.
  • 예를 들어, eventTypeFoo 이고 속성이 bar: 123custom 이벤트를 보냈다면 다음과 같은 쿼리를 실행할 수 있습니다.
    SELECT * FROM Foo WHERE bar = 123

PageAction 이벤트 만들기

PageAction 이벤트를 생성하려면:

  1. 앱에 브라우저 에이전트가 설치되어 있는지 확인하십시오.
  2. 애플리케이션 자바스크립트의 관련 부분에서 newrelic.addPageAction 함수를 호출합니다.
  3. 애플리케이션이 실행되고 관련 PageAction 이벤트를 보고할 때까지 몇 분 정도 기다리십시오.
  4. 이벤트를 캡처하는 데 사용한 actionName 속성(및 작업과 함께 보낸 모든 관련 속성)이 포함된 PageAction 이벤트의 NRQL 쿼리 를 실행합니다.
  • 예를 들어, actionNameFoo 이고 속성이 bar: 123PageAction 이벤트를 보냈다면 다음과 같은 쿼리를 실행할 수 있습니다.
    SELECT * FROM PageAction WHERE actionName = 'Foo' AND bar = 123

브라우저 이벤트에 사용자 정의 속성 추가

모든 브라우저 이벤트에 사용자 정의 속성을 추가할 수 있습니다. setCustomAttribute API 사용하여 추가하는 모든 맞춤 속성은 캡처된 모든 이벤트에 추가됩니다.

사용자 정의 속성을 추가하는 방법에는 두 가지가 있습니다.

중요한 고려 사항 및 모범 사례는 다음과 같습니다.

AI 모니터링을 통해 총 맞춤형 대시보드 유형 수를 약 5개로 제한해야 합니다. 사용자 정의 대시보드 유형은 상위 수준 범주를 캡슐화하는 데 사용됩니다. 예를 들어, 다양한 목적을 가진 여러 이벤트를 포함하는 Gestures라는 이벤트 유형을 만들 수 있습니다.

사용자 정의 대시보드 이름을 지정하기 위해 이벤트 유형을 사용하지 마십시오. 데이터 카테고리를 수용하는 이벤트 유형을 생성하고 해당 카테고리 내의 속성을 사용하여 이벤트를 차별화합니다. 수많은 사용자 정의 대시보드를 생성할 수 있지만 보고되는 이벤트 유형의 수를 제한하여 데이터를 관리 가능하게 유지하는 것이 중요합니다.

포함된 속성

사용자 정의 브라우저 이벤트는 이벤트가 발생했을 때 브라우저 환경의 컨텍스트를 이해하는 데 도움이 되도록 다음 속성으로 장식됩니다.

문제점 해결

다음은 몇 가지 문제 해결 팁입니다.

Problem

Comments

맞춤 속성 누락

사용자 정의 속성이 PageView 이벤트에 나타나지 않으면 페이지의 Load 이벤트 전에 setCustomAttribute 를 호출하고 있는지 확인하십시오. 페이지 로드가 발생한 후에 사용자 정의 속성이 호출되면 PageView 에 표시되지 않습니다.

PageAction 이벤트

쿼리할 때 PageAction 이벤트가 표시되지 않으면 요구 사항을 검토하십시오.

요구 사항이 충족되면 예약된 속성 이름이나 유효하지 않은 값을사용하고 있지 않은지 확인하세요.

Custom 이벤트

쿼리할 때 custom 이벤트가 표시되지 않으면 요구 사항을 검토하십시오.

요구 사항이 충족되면 예약된 속성 이름이나 유효하지 않은 값을사용하고 있지 않은지 확인하세요.

Copyright © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.