1. Les modes d'injection #
Comment le JavaScript arrive dans la page.
Choisir #
| Mode | Principe | Quand |
|---|---|---|
| Injection automatique | OneAgent insère le script RUM dans les pages HTML servies par les serveurs web ou applicatifs supervisés | Serveurs supervisés en Full-Stack |
| Sans agent (agentless) | On ajoute soi-même le snippet JavaScript dans les pages | Sites hébergés ailleurs (CDN, SaaS, PaaS sans OneAgent) |
| Extension de navigateur | Injection dans le navigateur d'un testeur | Démonstration, test sur un site tiers |
Le RUM complète l'article « XLA : pourquoi l'expérience utilisateur est le nouveau standard de l'observabilité ».
2. Applications web #
Créer, configurer, nettoyer.
Gestion #
- Les pages instrumentées sont rattachées à une application web selon des règles de détection (domaine, URL).
- Configurer pour chaque application : actions utilisateur (noms lisibles), propriétés de session, Core Web Vitals, confidentialité (masquage des saisies, consentement).
- Supprimer ou fusionner les applications créées par erreur (par exemple « My web application » par défaut).
<!-- Snippet agentless (copié depuis les paramètres de l'application) -->
<script type="text/javascript" src="https://js-cdn.dynatrace.com/jstag/<id>/<env>/<app>_complete.js" crossorigin="anonymous"></script>Erreur Courante : Placez le snippet en tout début de <head> : chargé trop tard, il manque le début du chargement de la page et les mesures sont fausses.3. Applications PaaS #
Quand OneAgent ne peut pas être installé sur l'hôte.
Approches #
- Intégrer la bibliothèque OneAgent au conteneur ou au runtime (images et buildpacks pris en charge) : l'injection redevient automatique.
- Sinon, utiliser le mode agentless et, côté serveur, OpenTelemetry pour relier les actions utilisateur aux traces.
4. Vérifier l'instrumentation #
Le bon réflexe avant toute analyse.
Contrôles dans le navigateur #
// Console du navigateur sur la page supervisée
typeof dtrum // "object" si le script RUM est chargé
dtrum.getVersion() // version du JavaScript RUM- Le code source contient un script
ruxitagentjsou un snippetjs-cdn.dynatrace.com. - L'onglet Réseau montre des requêtes de type
rb_(balises envoyées à Dynatrace). - Dans Dynatrace, des sessions et actions apparaissent pour l'application en quelques minutes.
À savoir : Bloqueurs de publicité et politiques de sécurité du contenu (CSP) peuvent empêcher l'envoi des balises : autorisez le domaine de Dynatrace dans la CSP et prévoyez un point de collecte sur votre domaine si nécessaire.
