enregistrementCustomEvent

Syntaxe

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

Signale un événement de navigateur personnalisé sous un eventType spécifié avec l'attribut personnalisé.

Exigences

• Agent navigateur Pro ou Pro+SPA (v1.277.0 ou supérieur)

• Si vous utilisez npm pour installer l'agent du navigateur, vous devez activer la fonctionnalité generic_events lors de l'instanciation de la classe BrowserAgent . Dans l'éventail features , ajoutez ce qui suit :

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

  Copier

  Pour plus d'informations, consultez la documentation d'installation du navigateur npm.

Description

Cet appel d'API envoie un événement de navigateur personnalisé avec votre eventType défini par l'utilisateur et un attribut facultatif au dashboard, ainsi que tout attribut personnalisé que vous avez peut-être défini pour votre application. Cela est utile pour suivre tout événement qui n'est pas déjà suivi automatiquement par l'agent du navigateur, amélioré par des règles et une attribution que vous contrôlez.

• custom événement sont envoyés toutes les 30 secondes.
• Si 1 000 événements sont observés, l'agent récoltera immédiatement l'événement mis en mémoire tampon, en contournant l'intervalle du cycle de collecte.

Paramètres

Les considérations importantes et les bonnes pratiques comprennent :

Vous devez monitorer l'IA pour limiter le nombre total de types d'événements à environ cinq. Les types d'événements personnalisés sont destinés à être utilisés pour encapsuler des catégories de haut niveau. Par exemple, vous pouvez créer un type d’événement Gestes.

N'utilisez pas eventType pour nommer un événement personnalisé. Créez des eventTypes pour héberger une catégorie de données et un attribut dans cette catégorie pour nommer un événement ou utilisez le paramètre de nom facultatif. Bien que vous puissiez créer de nombreux événements personnalisés, il est important de garder vos données gérables en limitant le nombre d'événements type signalés.

Exemples

Enregistrer les clics sur les liens (JavaScript)

Cet exemple enregistre un événement personnalisé chaque fois qu'un utilisateur clique sur le bouton Submit dans un formulaire. L'événement est enregistré avec un eventType de FormAction, qui était utilisé pour contenir de nombreux événements liés aux actions effectuées sur un formulaire :

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

Vous pouvez ensuite interroger le nombre de fois que le bouton Submit a été cliqué avec la requête NRQL suivante :

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