Dépannage

Dépannage

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 :

Causes courantes Correctif conseillé
Les bloqueurs de publicités empêchent le téléchargement du SDK RUM Browser ou empêchent ce dernier d’envoyer les données à Datadog. Certains bloqueurs de publicités limitent également le chargement des outils de suivi des performances et marketing. Consultez la documentation pour installer le SDK RUM Browser avec npm et transférer les données recueillies par l’intermédiaire d’un proxy.
Les règles réseau ou les VPN empêchent le téléchargement du SDK RUM Browser ou empêchent ce dernier d’envoyer les données à Datadog. Accordez l’accès aux endpoints requis pour le téléchargement du SDK ou l’envoi des données. La liste des endpoints est disponible dans la documentation relative à la stratégie de sécurité de contenu.
Les scripts, packages et clients initialisés avant le SDK RUM Browser peuvent entraînent la perte de logs, ressources et actions utilisateur. Par exemple, si vous initialisez ApolloClient avant le SDK RUM Browser, il est possible que les requêtes graphql ne soient pas enregistrées en tant que ressources XHR dans le RUM Explorer. Vérifiez à quel moment le SDK RUM Browser est initialisé et, si besoin, déplacez-le à une étape antérieure à l’exécution du code de votre application.

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, et en vérifiant que les éléments application_id et session_id ainsi que l’objet de la vue sont bien renvoyés :

Si le SDK 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.

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

Nom du cookie Détails
_dd_s Cookie utilisé pour regrouper tous les événements générés à partir d’une session utilisateur unique sur plusieurs pages. Il indique l’ID de session en cours, si la session est exclue en raison d’un échantillonnage, et la date d’expiration de la session. Le cookie est prolongé 15 minutes de plus à chaque interaction de l’utilisateur avec le site Web, jusqu’à la durée maximale de session utilisateur (4 heures).
dd_site_test_* Cookie temporaire utilisé pour tester la prise en charge des cookies. Expire instantanément.
dd_cookie_test_* Cookie temporaire utilisé pour tester la prise en charge des cookies. Expire instantanément.

Remarque : les cookies suivants ont été utilisés par le passé : _dd_l, _dd_r et _dd. Ils ont depuis été remplacés par _dd_s dans les dernières versions du SDK, mais tous ont la même utilité.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles: