Prise en main de RUM
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

Prise en main de RUM

Pour configurer la solution Real User Monitoring (RUM) de Datadog :

  1. Sur la page Real User Monitoring, cliquez sur le bouton New Application.
  2. Renseignez les informations sur votre application et cliquez sur Generate Client Token. Cette option permet de créer automatiquement un clientToken et un applicationId pour votre application.
  3. Configurez la bibliothèque RUM à partir des navigateurs de Datadog via NPM ou collez l’extrait de code généré dans le tag head.
  4. Déployez les modifications sur votre application. Une fois votre déploiement actif, Datadog commence à recueillir les événements depuis les navigateurs de vos utilisateurs.
  5. Visualisez les données recueillies sur les dashboards prêt à l’emploi de Datadog.

Remarque : votre application affiche le statut « Pending » (en attente) sur la liste des applications tant que Datadog n’a pas encore reçu de données.

Configuration via NPM

Après avoir ajouté @datadog/browser-rum à votre fichier package.json, lancez la bibliothèque avec :

import { datadogRum } from '@datadog/browser-rum';

datadogRum.init({
  applicationId: '<ID_APPLICATION_DATADOG>',
  clientToken: '<TOKEN_CLIENT_DATADOG>',
  datacenter: 'us',
  sampleRate: 100
});
import { datadogRum } from '@datadog/browser-rum';

datadogRum.init({
  applicationId: '<ID_APPLICATION_DATADOG>',
  clientToken: '<TOKEN_CLIENT_DATADOG>',
  datacenter: 'eu',
  sampleRate: 100
});

Configuration via bundle

Collez l’extrait de code généré dans le tag head (avant tous les autres tags du script) de toutes les pages HTML que vous souhaitez surveiller dans votre application. Lorsque le tag de script de niveau plus élevé est intégré et synchronisé, la solution RUM de Datadog peut recueillir toutes les données de performance et les erreurs.

<script
  src="https://www.datadoghq-browser-agent.com/datadog-rum-us.js"
  type="text/javascript">
</script>
<script>
  window.DD_RUM && window.DD_RUM.init({
    clientToken: '<TOKEN_CLIENT>',
    applicationId: '<ID_APPLICATION>',
    sampleRate: 100
  });
</script>
<script
  src="https://www.datadoghq-browser-agent.com/datadog-rum-eu.js"
  type="text/javascript">
</script>
<script>
  window.DD_RUM && window.DD_RUM.init({
    clientToken: '<TOKEN_CLIENT>',
    applicationId: '<ID_APPLICATION>',
    sampleRate: 100
  });
</script>

Remarque : le check window.DD_RUM est utilisé pour éviter tout problème si le chargement de la bibliothèque échoue.

Paramètres de lancement

ParamètreTypeObligatoireValeur par défautDescription
applicationIdChaîneOui``L’ID d’application RUM.
clientTokenChaîneOui``Un token client Datadog.
datacenterChaîneOuiusLe site Datadog associé à votre organisation. Choisissez us pour le site américain ou eu pour le site européen.
resourceSampleRateNuméroNon100Le pourcentage de sessions à surveiller (avec collecte des ressources). Choisissez une valeur entre 100 (toutes les sessions) et 0 (aucune session).
sampleRateNuméroNon100Le pourcentage de sessions à surveiller. Les événements RUM sont uniquement envoyés pour les sessions surveillées. Choisissez une valeur entre 100 (toutes les sessions) et 0 (aucune session).

Pour aller plus loin