recordCustomEvent

Sintaxis

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

Informa sobre un evento browser personalizado bajo un eventType especificado con atributo personalizado.

Requisitos

• Agente de Broswer Pro o Pro+SPA (v1.277.0 o superior)

• Si está utilizando npm para instalar el agente del navegador, debe habilitar la característica generic_events al crear una instancia de la clase BrowserAgent . En la matriz features , agregue lo siguiente:

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

  Copia

  Para obtener más información, consulte la documentación de instalación del navegador npm.

Descripción

Esta API de llamada envía un evento browser personalizado con su eventType definido por el usuario y un atributo opcional al tablero, junto con cualquier atributo personalizado que pueda configurar para su aplicación. Esto es útil para rastrear cualquier evento que no sea rastreado automáticamente por el agente del browser mejorado por reglas y atribución que usted controla.

• custom Los eventos se envían cada 30 segundos.
• Si se observan 1.000 eventos, el agente recolectará el evento almacenado inmediatamente, omitiendo el intervalo del ciclo de recolección.

Parámetros

Las consideraciones importantes y las mejores prácticas incluyen:

Debe monitorear IA para limitar el número total de tipos de eventos a aproximadamente cinco. Los tipos de eventos personalizados están pensados para encapsular categorías de alto nivel. Por ejemplo, podría crear un tipo de evento Gestos.

No emplee eventType para nombrar un evento personalizado. Cree eventTypes para albergar una categoría de datos y un atributo dentro de esa categoría para nombrar un evento o emplee el parámetro de nombre opcional. Si bien puedes crear numerosos eventos personalizados, es importante mantener tus datos manejables limitando la cantidad de tipos de eventos informados.

Ejemplos

Registrar clics en enlaces (JavaScript)

Este ejemplo registra un evento personalizado cada vez que un usuario hace clic en el botón Submit en un formulario. El evento se registra con un eventType de FormAction, que se empleó para contener muchos eventos relacionados con acciones realizadas en un formulario:

<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>

Luego puede consultar la cantidad de veces que se hizo clic en el botón Submit con la siguiente consulta NRQL:

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