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

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

문제 신고

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개의 이벤트가 관찰되면 에이전트는 하베스트 처리 간격을 우회하여 버퍼링된 이벤트를 즉시 수집합니다.

매개변수

매개변수

설명

$eventType

필수의. 이벤트 데이터를 저장할 eventType

속성이나 값의 이름을 지정할 때 예약된 NRQL 단어 나 기존의 eventTypes를 사용하지 마세요.

$attributes

JSON 객체

선택 과목. 하나 이상의 키/값 쌍이 있는 JSON 객체. 예: {key:"value"} . 키는 지정된 값과 함께 자체 PageAction 속성으로 보고됩니다.

속성/값의 이름을 지정할 때 예약된 NRQL 단어 를 사용하지 마십시오.

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

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

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

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

<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