dépannage Relecture de session

Il s’agit de la première étape pour diagnostiquer vous-même votre problème de relecture de session New Relic.

Si vous ne trouvez pas votre problème répertorié ici, vous pouvez toujours contacter le support New Relic.

Les rediffusions ne sont pas visibles dans l'UI

Problème

La fonctionnalité de relecture de session est activée, mais vous ne pouvez pas afficher les rediffusions.

Solution

Voici quelques correctifs possibles :

• Vérifiez vos taux d’échantillonnage. Il existe un échantillonnage pour les rediffusions et les erreurs.

• Assurez-vous d'avoir l'autorisation de visionner les rediffusions.

• Assurez-vous que vous utilisez la version Pro ou Pro+SPA de l'agent de navigateur. La relecture de session ne fonctionne pas avec l'agent de navigateur Lite .

• Assurez-vous que votre agent de navigateur répond à ces exigences :

  • Version de l'agent v1.260.0 ou ultérieure. Nous vous recommandons de mettre à niveau vers la dernière version de l'agent à mesure que nous continuons à apporter des améliorations.
  • Type d'agent : Pro ou Pro+SPA. La relecture de session ne fonctionne pas avec l'agent de navigateur Lite .
  • Le traçage de session est activé.

• Le navigateur de votre utilisateur final prend en charge les API au niveau du navigateur nécessaires pour enregistrer une relecture de session (vérifiez la compatibilité sur MutationObserver).

• Dans la boîte de réception des erreurs, filtrez vos vues afin d'avoir toujours une relecture. Par défaut, les données du navigateur événement sont stockées 8 jours, mais la rétention réelle des données dépend de votre compte.

• Si vous utilisez la méthode de déploiement copier/coller, assurez-vous d'avoir mis à jour votre code d'agent.

• Si vous utilisez la méthode de déploiement APM, vous devrez peut-être attendre que la relecture de session s'active automatiquement. Si les données ne sont toujours pas visibles, essayez de redémarrer l'agent.

• Si vous supprimez des données d'événement PageView, Session Replay peut ne pas apparaître dans l'UI.

Les rediffusions ne s'affichent pas correctement

Problème

Vous pouvez visionner les rediffusions, mais elles n'apparaissent pas correctement.

Cela peut être dû au fait que vos fichiers CSS sont hébergés sur un domaine distinct et que les mesures de sécurité du partage de ressources inter-origines (CORS) empêchent notre agent d'accéder aux fichiers CSS. Cela peut entraîner des rediffusions incomplètes ou inexactes, car des informations de style essentielles peuvent être manquantes.

Voici ce qui se passe dans les coulisses :

• Session Replay reconstruit le DOM de l'utilisateur, capturant la structure et les éléments visuels de votre site Web. Pour y parvenir, notre agent accède à vos fichiers CSS pour capturer avec précision les informations de style. Ces styles sont ensuite intégrés directement dans l'enregistrement de rediffusion, supprimant ainsi le besoin de référencer les fichiers CSS d'origine pendant la lecture.

• Si vos fichiers CSS sont hébergés sur un domaine distinct, CORS peut empêcher notre agent d'y accéder.

Solution

Pour garantir que vos fichiers CSS sont accessibles, ajoutez l'attribut crossorigin="anonymous" à vos éléments <link rel="stylesheet"> dans votre code HTML. Cet attribut indique au navigateur d'autoriser l'accès inter-origines pour ces fichiers CSS spécifiques, permettant à notre agent de navigateur d'enregistrer et d'intégrer les informations de style.

Voici un exemple d’ajout de l’attribut crossorigin="anonymous" :

<link
  rel="stylesheet"
  href="assets.yoursite.com/styles.css"
  crossorigin="anonymous"
/>

Les rediffusions ne sont pas visibles dans vos iframes

Problème

La fonctionnalité de relecture de session est activée, mais vous ne pouvez pas afficher les données de relecture pour le contenu iframe.

Solution

Le comportement de Session Replay dans les scénarios iframe dépend de l'origine de l'iframe et du placement de l'agent du navigateur.

En supposant qu'une page Web se compose d'une fenêtre de niveau supérieur avec un iframe enfant, voici quelques correctifs possibles :

• Iframes de même origine:

  • Si vous placez l'agent du navigateur dans la fenêtre de niveau supérieur, Session Replay capture à la fois la fenêtre et l'iframe.
  • Si vous placez l'agent du navigateur dans l'iframe, Session Replay capture uniquement ce qui se trouve dans l'iframe.
  • Si vous placez l'agent du navigateur à la fois dans la fenêtre de niveau supérieur et dans l'iframe, Session Replay capture ce qui se passe indépendamment dans la fenêtre et dans l'iframe, ce qui donne lieu à deux sessions distinctes.

• Iframes multi-origines:

  • Si vous placez l'agent du navigateur dans la fenêtre de niveau supérieur, Session Replay capture uniquement ce qui se trouve dans la fenêtre. L'iframe apparaîtra vide dans Session Replay.
  • Si vous placez l'agent du navigateur dans l'iframe de niveau supérieur, Session Replay capture uniquement ce qui se trouve dans l'iframe.

La relecture de session n'est pas compatible avec les éléments <frame> .