Sondes J2EE Request Profiler

Introduction

Cet exemple contient la sonde J2EE Request Profiler qui permet de collecter des données dans n'importe quelle application J2EE. Il est possible d'injecter la sonde dans n'importe quelle application J2EE en suivant les instructions ci-dessous. Pour plus d'informations sur Hyades Probekit, consultez les fichiers d'aide. Pour plus d'informations sur J2EE Request Profiler, consultez le fichier readme.html de l'exemple 'J2EE Request Profiler - Sample' en sélectionnant les options Nouveau > Exemple.

Contenus

Fichier JAR Description
j2rp_probe.probe Sonde J2EE Request Profiler utilisée pour collecter des données dans les applications J2EE
sdrt.jar Contient le composant J2EE Request Profiler dans lequel les collaborateurs sont désactivés. La sonde ci-dessus est utilisée pour exécuter les tâches des collaborateurs.

Conditions requises

WebSphere Application Server (version 5.0 ou suivante) est requise pour exécuter cet exemple.
Remarque :
Cette application n'est pas fournie.

Hypothèses

Lors de la connexion à J2EE Request Profiler à l'aide du plan de travail, le composant Agent Controller est installé et actif.

Etapes d'exécution

Suivez les instructions ci-dessous pour appliquer la sonde à une application J2EE et démarrer le profilage :

  1. Arrêtez WebSphere Application Server (version 5.0 ou suivante).
  2. Ajoutez le fichier sdrt.jar contenu dans cet exemple au répertoire lib de WebSphere Application Server, par exemple, x:\Program Files\WebSphere\AppServer\lib sous Windows ou /opt/WebSphere/AppServer/lib sous UNIX.
  3. Cliquez à l'aide du bouton droit de la souris sur j2rp_probe.probe > probekit > compiler
  4. Lors de la compilation de la sonde, une classe java et un fichier probescript ont dû être générés. Si l'option 'compiler automatiquement' est sélectionnée, la classe java est compilée et quelques erreurs de chemin de compilation s'affichent. Cliquez à l'aide du bouton droit de la souris sur le projet et sélectionnez > Propriétés > Chemin de compilation Java > Bibliothèques > Ajouter des JAR externes > et sélectionnez l'emplacement du fichier sdrt.jar inclus avec cet exemple. Vous pouvez afficher l'emplacement de ce fichier en cliquant dessus à l'aide du bouton droit de la souris et en sélectionnant Propriétés. Ajoutez également le fichier j2ee.jar à partir du répertoire lib de WebSphere (c'est-à-dire <WAS_HOME>\lib\j2ee.jar). Les erreurs du chemin de compilation doivent à présent être résolues.
  5. Une fois le projet compilé, quatre fichiers .class sont générés dans le répertoire bin du projet (c'est-à-dire <Workbench_Home>\<Espace de travail>\<Nom_projet>\bin). Il s'agit des fichiers j2rp_probe_probe.class, j2rp_probe_probe$Probe_0.class, j2rp_probe_probe$Probe_1.class et j2rp_probe_probe$Probe_2.class. Copiez ces classes dans le même répertoire que l'application J2EE.
  6. Vérifiez que la variable d'environnement CLASSPATH contient le chemin complet et le nom du fichier probekit.jar. Ce dernier se trouve dans le sous-dossier org.eclipse.hyades.probekit du dossier des plug-ins Eclipse. Vérifiez que la variable d'environnement PATH contient le chemin complet d'un sous-dossier de org.eclipse.hyades.probekit adapté à votre plateforme :
         os\win32\x86 pour Windows
         os/solaris/sparc pour Solaris
         os/linux/x86 pour Linux
    Les autres plateformes possèdent leur propre sous-répertoire.
  7. Passez au répertoire <Workbench_Home>\<Espace de travail>\<Nom_projet>\bin.
    Appliquez la sonde à l'application J2EE en utilisant la commande suivante : java ProbeInstrumenter j2rp_probe.probescript "C:\myservlet\myclass.class" Vous pouvez également appliquer la sonde à un groupe de classes en spécifiant un répertoire ou un fichier JAR dans la commande ci-dessus. Pour plus d'informations sur cette dernière, voir le fichier d'aide de probekit.
    Les sondes ne peuvent pas être appliquées aux classes déjà instrumentées. Si vous appliquez les sondes à vos classes et souhaitez ensuite appliquer une version modifiée de la sonde au même ensemble de classes, renommez au préalable tous les fichiers *.class.bak en *.class.
  8. Démarrez WebSphere Application Server.
  9. Activez le profilage dans les préférences Profilage et journalisation du plan de travail :
    1. Dans la barre d'outils, sélectionnez Fenêtre > Préférences.
    2. Sélectionnez Profilage et journalisation.
    3. Dans le panneau Profilage et journalisation, sélectionnez Activer le profilage.
    4. Pour appliquer les modifications, cliquez sur OK.
  10. Ouvrez la perspective Profilage et journalisation dans le plan de travail :
    1. Sélectionnez Fenêtre > Ouvrir la perspective > Autre.
    2. Sélectionnez Profilage et journalisation.
    3. Cliquez sur OK.
  11. Connectez-vous à l'agent de profilage J2EE Request Profiler :
    1. Sélectionnez Profil dans la barre d'outils. La fenêtre de lancement de la configuration s'affiche.
    2. Sélectionnez Connexion - Processus Java dans la liste Configurations.
    3. Pour créer une configuration, cliquez sur Nouveau.
    4. Dans le panneau de la nouvelle configuration, indiquez le nom de la configuration du profil dans la zone Nom.
    5. Cliquez sur l'onglet Agents.
    6. Sélectionnez J2EE Request Profiler dans la liste Agents à l'aide des touches de déplacement du curseur.
    7. Pour commencer le profilage de l'application, cliquez sur Profil.
  12. Dans la vue Moniteur de profilage, cliquez à l'aide du bouton droit de la souris sur l'agent de profilage et sélectionnez Lancer la surveillance. Les données sont alors collectées.
  13. Exécutez l'application J2EE.
  14. Ouvrez l'une des vues de profilage de la perspective Profilage et journalisation afin d'afficher les données de profilage qui ont été collectées. Pour ouvrir une vue, procédez comme suit :
    1. Dans la vue Moniteur de profilage, cliquez à l'aide du bouton droit de la souris sur l'agent de profilage et sélectionnez Ouvrir avec.
    2. Sélectionnez l'une des vues répertoriées.
    Remarque : Des informations supplémentaires sur le profilage de l'application et les vues de profilage de la perspective Profilage sont disponibles dans la documentation en ligne (Aide > Contenu de l'aide > Rechercher : > 'Perspective Profilage d'application' > GO).
  15. Dans la vue Moniteur de profilage, cliquez sur le bouton Régénérer les vues.
  16. Sachez que vous pouvez modifier les sondes comme il convient et les réappliquer aux classes. Par exemple, vous pouvez cibler les sondes sur des classes/méthodes spécifiques en incluant des instructions <target>, telles que :
                         <target type='exclude' package='*' method='myMethod'/>
    Il est vivement conseillé à l'utilisateur de lire les fichiers d'aide de probekit pour déterminer comment les fichiers de sonde peuvent être modifiés pour répondre à ses besoins.



(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.