recordCustomEvent

Sintaxe

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

Relata um evento de browser personalizado sob um eventType especificado com atributo personalizado.

Requisitos

• Browser Pro ou agente Pro+SPA (v1.277.0 ou superior)

• Se estiver usando o npm para instalar o agente browser, você deverá ativar o recurso generic_events ao instanciar a classe BrowserAgent . Na matriz features , adicione o seguinte:

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

  Copiar

  Para obter mais informações, consulte a documentação de instalação do browser npm.

Descrição

Esta chamada de API envia um evento de browser personalizado com seu eventType definido pelo usuário e atributo opcional para dashboard, junto com qualquer atributo personalizado que você possa ter definido para seu aplicativo. Isso é útil para rastrear qualquer evento que ainda não seja rastreado automaticamente pelo browser do agente, aprimorado pelas regras e atribuições que você controla.

• custom evento são enviados a cada 30 segundos.
• Se 1.000 eventos forem observados, o agente coletará o evento armazenado em buffer imediatamente, ignorando o intervalo do ciclo de coleta.

Parâmetro

Considerações importantes e práticas recomendadas incluem:

Você deve usar o monitoramento de IA para limitar o número total de tipos de eventos a aproximadamente cinco. Os eventTypes personalizados devem ser usados para encapsular categorias de alto nível. Por exemplo, você pode criar um tipo de evento Gestos.

Não utilize eventType para nomear evento personalizado. Crie eventTypes para abrigar uma categoria de dados e atributos dentro dessa categoria para nomear um evento ou use o parâmetro de nome opcional. Embora você possa criar vários eventos personalizados, é importante manter seus dados gerenciáveis limitando o número de eventTypes relatados.

Exemplos

Registrar cliques em links (JavaScript)

Este exemplo registra um evento personalizado sempre que um usuário clica no botão Submit em um formulário. O evento é registrado com um eventType de FormAction, que foi usado para conter muitos eventos relacionados a ações realizadas em um formulário:

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

Você pode então consultar o número de vezes que o botão Submit foi clicado com a seguinte consulta NRQL:

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