Si la fonctionnalité RUM Browser de Datadog se comporte de manière inattendue, consultez ce guide pour découvrir rapidement des solutions. Si votre problème persiste, contactez l’assistance Datadog pour obtenir de l’aide. Assurez-vous de mettre régulièrement à jour le SDK RUM Browser, car chaque version contient des améliorations et des correctifs.

Données manquantes

Si vous ne voyez aucune donnée RUM ou si des données sont manquantes pour certains utilisateurs :

Consultez les directives relatives à la stratégie de sécurité de contenu et assurez-vous que votre site Web accorde l’accès au CDN du SDK RUM Browser et à l’endpoint d’admission.

Initialisation du SDK RUM Browser

Vérifiez si le SDK RUM Browser est initialisé en exécutant la commande window.DD_RUM.getInternalContext() dans la console de votre navigateur. Assurez-vous également que les éléments application_id et session_id, ainsi que l’objet de la vue, sont bien renvoyés :

Si le SDK RUM Browser n’est pas installé, ou s’il n’a pas été correctement initialisé, l’erreur ReferenceError: DD_RUM is not defined peut s’afficher :

Vous pouvez également consulter la console d’outils de développement de votre navigateur ou l’onglet Network si vous remarquez des erreurs liées au chargement du SDK RUM Browser.

Remarque : pour garantir l’exactitude des résultats, définissez sessionSampleRate sur 100. Pour en savoir plus, consultez la section Mettre à jour votre configuration pour Browser RUM et l’échantillonnage de Browser RUM et Session Replay.

Données vers l’endpoint d’admission Datadog

Le SDK RUM Browser envoie régulièrement des lots de données à l’endpoint d’admission Datadog. Si des données sont envoyées, vous devriez voir des requêtes réseau ciblant /v1/input (la partie relative à l’origine de l’URL peut être différente selon votre configuration RUM) dans la section Réseau des outils de développement de votre navigateur :

Cookies RUM

Le SDK RUM Browser utilise des cookies pour stocker des informations de session et suivre une session utilisateur sur différentes pages. Les cookies sont internes (c’est-à-dire qu’ils sont définis sur votre domaine) et ne sont pas utilisés pour le suivi intersite. Voici les cookies définis par le SDK RUM Browser :

Remarque : les cookies _dd_l, _dd_r et _dd ont été remplacés par le cookie _dd_s dans les dernières versions du SDK RUM Browser.

Limites techniques

Chaque événement envoyé par le SDK RUM Browser comporte les éléments suivants :

• Le contexte RUM global
• Le contexte de l’événement (le cas échéant)
• Les attributs propres à l’événement

Exemple :

window.DD_RUM && window.DD_RUM.addRumGlobalContext('global', {'foo': 'bar'})
window.DD_RUM && window.DD_RUM.addAction('hello', {'action': 'qux'})

Cet exemple de code crée l’événement d’action suivant :

{
  "type": "action",
  "context": {
    "global": {
      "foo": "bar"
    },
    "action": "qux"
  },
  "action": {
    "id": "xxx",
    "target": {
      "name": "hello"
    },
    "type": "custom"
  },
  ...
}

Si un événement ou une requête dépasse l’une des limites ci-dessous, il est rejeté par l’admission Datadog.

Avertissement relatif au blocage de la lecture interorigines

Sur les navigateurs basés sur Chromium, lorsque le SDK RUM Browser envoie des données à l’admission Datadog, un avertissement relatif au blocage de la lecture interorigines s’affiche dans la console : Cross-Origin Read Blocking (CORB) blocked cross-origin response.

Cet avertissement est généré lorsque l’admission renvoie un objet JSON non vide. Il s’agit d’un problème Chromium connu. Cela n’a aucune incidence sur le SDK RUM Browser ; vous pouvez ignorer l’avertissement.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Real User MonitoringBLOG Stratégie de sécurité de contenuDOCUMENTATION