recordCustomEvent

통사론

newrelic.recordCustomEvent(string $eventType[, JSON object $attributes])

사용자 정의 속성을 사용하여 지정된 eventType에서 사용자 정의 브라우저 이벤트를 보고합니다.

요구 사항

• 브라우저 Pro 또는 Pro+SPA 에이전트(v1.277.0 이상)

• npm을 사용하여 브라우저 에이전트를 설치하는 경우 BrowserAgent 클래스를 인스턴스화할 때 generic_events 기능을 활성화해야 합니다. features 배열에 다음을 추가합니다.

  import { GenericEvents } from '@newrelic/browser-agent/features/generic_events';
  
  const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
      GenericEvents
    ]
  }

  카피

  자세한 내용은 npm 브라우저 설치 설명서를 참조하세요.

설명

이 API 호출은 사용자가 정의한 eventType 및 선택적 속성이 포함된 사용자 정의 브라우저 이벤트를 대시보드 에 전송하고, 사용자 정의 속성에 대해 설정할 수도 있습니다. 이 기능은 브라우저 에이전트가 자동으로 추적하지 않는 모든 이벤트를 추적하는 데 유용하며, 사용자가 제어하는 규칙과 속성을 통해 강화됩니다.

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

매개변수

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

AI 모니터링을 통해 총 이벤트 유형 수를 약 5개로 제한해야 합니다. 사용자 정의 eventTypes는 상위 수준의 카테고리를 캡슐화하는 데 사용됩니다. 예를 들어, 제스처라는 이벤트 유형을 만들 수 있습니다.

사용자 정의 대시보드 이름을 지정하는 데 eventType을 사용하지 마십시오. 이벤트 이름을 지정하기 위해 해당 범주 내에 데이터 및 속성 범주를 수용하는 eventTypes를 생성하거나 선택적 이름을 사용하여 모범답안을 만드세요. 다양한 사용자 정의 대시보드를 만들 수 있지만 보고되는 eventTypes 수를 제한하여 데이터를 관리하기 쉽게 유지하는 것이 중요합니다.

예

링크 클릭 기록(JavaScript)

이 예에서는 사용자가 양식에서 Submit 버튼을 클릭할 때마다 사용자 정의 대시보드를 기록합니다. 이벤트는 eventType 의 FormAction 로 기록되었으며, 이는 양식에서 수행된 작업과 관련된 많은 이벤트를 포함하는 데 사용되었습니다.

<a href="/demo" id="try-me">Try Me!</a>
<script>
  document.getElementById('submit').addEventListener('click', function (e) {
    newrelic.recordCustomEvent('FormAction', {
      element: 'submit',
      action: 'click',
    });
  });
</script>

그러면 다음 NRQL 쿼리를 사용하여 Submit 버튼이 클릭된 횟수를 쿼리할 수 있습니다.

SELECT count(*) FROM FormAction WHERE element = 'submit' AND action = 'click' SINCE 1 hour ago