Ajout du composant de surveillance JavaScript à votre application

Pour vous permettre de comprendre les performances de vos pages Web dans un navigateur, ainsi que les erreurs, l'agent Response Time Monitoring doit pouvoir collecter les données de temporisation du navigateur. Pour activer cette fonction, vous devez configurer l'application que vous voulez surveiller.

Pourquoi et quand exécuter cette tâche

Avant de pouvoir surveiller les interactions dans vos pages Web, vous devez ajouter le composant de surveillance JavaScript à chaque page Web pour votre application. Le composant de surveillance JavaScript capture l'état de chaque page Web et de leurs interactions JavaScript associées. Ajoutez le composant de surveillance JavaScript à l'application que vous voulez surveiller. Le contenu et les actions appropriés sont automatiquement capturés et envoyés au serveur Cloud APM à des fins d'analyse et de corrélation.

Procédure

Pour activer la collecte des données de surveillance utilisateur réelles à partir du navigateur, procédez comme indiqué ci-après. Ces étapes ne doivent être exécutées qu'une seule fois, sauf si la configuration de l'application change.

Ajoutez le composant de surveillance JavaScript à l'application. La procédure à utiliser dépend du type d'application :
1. Pour les applications Java EE, décompressez le fichier rép_installation/clienttime/ClientTime.war depuis le module d'installation vers un répertoire auquel le serveur HTTP peut accéder.
2. Pour les applications autres que les applications non Java EE, par exemple Ruby, .NET, Python et Node.js, sauvegardez rép_install/clienttime/wrtInstrumentation.js depuis le module d'installation dans un répertoire auquel le serveur HTTP peut accéder.
  
  Décompressez le fichier rép_install/clienttime/ClientTime.war dans un chemin temporaire. Copiez ensuite le fichier wrtTimingTarget.dat extrait à la racine de document. La racine de document (document root) est un paramètre du serveur HTTP (Apache, IIS, etc). Il s'agit d'un répertoire destiné à stocker vos documents. Par défaut, toutes les demandes proviennent de ce répertoire mais des liens symboliques et des alias peuvent être utilisés pour pointer vers d'autres emplacements. Par exemple, la racine de document pour Apache est /opt/IBM/HTTPServer/htdocs.
  
  Le fichier wrtInstrumentation.js peut être placé dans n'importe quel répertoire. Veillez à mettre à jour le chemin d'accès à ce fichier dans l'en-tête HTML.
Associez le composant de surveillance JavaScript à l'application.
Normalement, vous pouvez effectuer cette association en modifiant un script d'en-tête d'application. En général, il suffit de modifier un script d'en-tête seulement pour chaque composant ou application à surveiller.
Pour les applications Java EE et non Java EE, ajoutez le code JavaScript suivant à l'en-tête d'application, avant tout autre code JavaScript :
```
<script language="JavaScript" src="chemin/wrtInstrumentation.js" 
type="text/JavaScript"></script>
```
où chemin est le chemin d'accès relatif au composant de surveillance JavaScript.
Par exemple :
```
<script language="JavaScript" src="/ClientTime/wrtInstrumentation.js" 
type="text/JavaScript"></script>
```

Résultats

Les pages qui sont instrumentées avec le composant de surveillance JavaScript sont surveillées, et les données provenant de ces pages sont analysées et affichées dans des tableaux de bord Transactions utilisateur final.