New Relic에서 브라우저 모니터링을 사용하여 사용자 정의 이벤트 및 속성 을 추가할 수 있습니다.
사용자 정의 속성
모든 브라우저 이벤트에 사용자 정의 속성을 추가하면 데이터를 쿼리하거나 필터링하여 독창적인 질문에 답할 수 있습니다.
맞춤 이벤트
사용자 정의 속성을 사용하여 모든 이벤트를 캡처하려면 브라우저 API의 recordCustomEvent
메서드를 사용합니다.
페이지 작업
브라우저 API의 addPageAction
호출을 사용하여 이벤트, 작업, 경로 변경 또는 애플리케이션과의 모든 최종 사용자 상호작용을 캡처합니다. addPageAction
호출은 작업 이름, 페이지와 관련된 메모데이터, 사용자 정의 속성 이름 및 이와 함께 캡처하는 값을 포함하는 PageAction
라는 이벤트를 추가합니다.
전제 조건
Custom
이벤트를 보고하려면 다음 전제 조건을 확인하세요.
Requirement | Comments |
---|---|
에이전트 버전 | 브라우저 모니터링 에이전트 버전은 1.277.0 이상 이어야 합니다. |
클라이언트 브라우저 버전 |
|
사이클당 이벤트 |
|
이벤트/속성 이름 지정, 데이터 유형, 크기 | 이벤트/속성 명명 구문, 데이터 유형 및 크기에 대한 일반 요구 사항 을 준수해야 합니다. |
PageAction
이벤트를 보고하려면 다음 전제 조건을 확인하세요.
Requirement | Comments |
---|---|
에이전트 버전 | 브라우저 모니터링 에이전트 버전은 593 이상 이어야 합니다. |
클라이언트 브라우저 버전 |
|
사이클당 이벤트 |
|
이벤트/속성 이름 지정, 데이터 유형, 크기 | 이벤트/속성 명명 구문, 데이터 유형 및 크기에 대한 일반 요구 사항 을 준수해야 합니다. |
사용자 홈페이지 만들기
custom
이벤트를 생성하려면:
- 앱에 브라우저 에이전트가 설치되어 있는지 확인하십시오.
- 애플리케이션의 JavaScript에서 관련 부분에 있는
newrelic.recordCustomEvent
함수를 호출합니다. - 디버그가 실행되고 지정한 eventType에서 관련
custom
이벤트를 보고할 때까지 몇 분 정도 기다립니다. - 이벤트를 캡처하는 데 사용한
eventType
속성(및 이벤트와 함께 보낸 모든 관련 속성)을 포함하는 이벤트의 NRQL 쿼리를 실행합니다.
- 예를 들어,
eventType
이Foo
이고 속성이bar: 123
인custom
이벤트를 보냈다면 다음과 같은 쿼리를 실행할 수 있습니다.SELECT * FROM Foo WHERE bar = 123
PageAction 이벤트 만들기
PageAction
이벤트를 생성하려면:
- 앱에 브라우저 에이전트가 설치되어 있는지 확인하십시오.
- 애플리케이션 자바스크립트의 관련 부분에서
newrelic.addPageAction
함수를 호출합니다. - 애플리케이션이 실행되고 관련
PageAction
이벤트를 보고할 때까지 몇 분 정도 기다리십시오. - 이벤트를 캡처하는 데 사용한
actionName
속성(및 작업과 함께 보낸 모든 관련 속성)이 포함된PageAction
이벤트의 NRQL 쿼리 를 실행합니다.
- 예를 들어,
actionName
이Foo
이고 속성이bar: 123
인PageAction
이벤트를 보냈다면 다음과 같은 쿼리를 실행할 수 있습니다.SELECT * FROM PageAction WHERE actionName = 'Foo' AND bar = 123
브라우저 이벤트에 사용자 정의 속성 추가
모든 브라우저 이벤트에 사용자 정의 속성을 추가할 수 있습니다. setCustomAttribute
API 사용하여 추가하는 모든 맞춤 속성은 캡처된 모든 이벤트에 추가됩니다.
사용자 정의 속성을 추가하는 방법에는 두 가지가 있습니다.
중요한 고려 사항 및 모범 사례는 다음과 같습니다.
AI 모니터링을 통해 총 맞춤형 대시보드 유형 수를 약 5개로 제한해야 합니다. 사용자 정의 대시보드 유형은 상위 수준 범주를 캡슐화하는 데 사용됩니다. 예를 들어, 다양한 목적을 가진 여러 이벤트를 포함하는 Gestures라는 이벤트 유형을 만들 수 있습니다.
사용자 정의 대시보드 이름을 지정하기 위해 이벤트 유형을 사용하지 마십시오. 데이터 카테고리를 수용하는 이벤트 유형을 생성하고 해당 카테고리 내의 속성을 사용하여 이벤트를 차별화합니다. 수많은 사용자 정의 대시보드를 생성할 수 있지만 보고되는 이벤트 유형의 수를 제한하여 데이터를 관리 가능하게 유지하는 것이 중요합니다.
포함된 속성
사용자 정의 브라우저 이벤트는 이벤트가 발생했을 때 브라우저 환경의 컨텍스트를 이해하는 데 도움이 되도록 다음 속성으로 장식됩니다.
문제점 해결
다음은 몇 가지 문제 해결 팁입니다.
Problem | Comments |
---|---|
맞춤 속성 누락 | 사용자 정의 속성이 |
| 쿼리할 때 요구 사항이 충족되면 예약된 속성 이름이나 유효하지 않은 값을사용하고 있지 않은지 확인하세요. |
| 쿼리할 때 요구 사항이 충족되면 예약된 속성 이름이나 유효하지 않은 값을사용하고 있지 않은지 확인하세요. |