Profilage d'une application en mode autonome

Les informations ci-dessous s'appliquent à Windows. Les informations ci-dessous s'appliquent à AIX. Les informations ci-dessous s'appliquent à Linux. Les informations ci-dessous s'appliquent à Solaris. Vous pouvez profiler une application en mode autonome (c'est-à-dire, à partir de la ligne de commande), sans avoir installé les outils Hyades. Cependant, vous devez installer Agent Controller sur la machine sur laquelle l'application à profiler réside.

Pour profiler une application en mode autonome, vous pouvez appeler l'agent de profilage Java qui correspond à une bibliothèque associée à une machine virtuelle Java (JVM) afin de capturer et enregistrer le comportement de votre application Java. La sortie de l'agent se présente sous la forme de fragments XML.

Utilisez l'option Java -Xrun pour appeler l'agent de profilage Java :

-XrunpiAgent:agent_parm[,agent_parm]*

Par exemple, pour profiler PerformanceExample.java à l'aide des filtres définis dans le fichier myFilters.txt et en dirigeant les données de la session de profilage vers un fichier appelé PEProfilingData, entrez la commande suivante à partir d'une ligne de commande :
java -XrunpiAgent:server=standalone,filters=myFilters.txt,file=PEProfilingData.trcxml PerformanceExample

En augmentant le paramètre -XrunpiAgent, vous pouvez spécifier plusieurs modes différents pour l'exécution de l'agent de profilage. Le paramètre param_agent peut comporter une des valeurs suivantes :

Format du fichier de filtres de classe

Le fichier de filtres doit spécifier trois champs, package/classe, méthode et mode dans le format suivant :
   package/classe méthode mode

où :

package/classe
Ce champ est utilisé pour spécifier un modèle pour un nom de package ou de classe. Le modèle doit être spécifié sous forme de chaîne ne comportant aucun caractère blanc. Un astérisque (*) peut figurer au début ou à la fin de cette chaîne, par exemple *.mypackage ou org.mycompany.*. L'astérisque (*) correspond à zéro ou plusieurs caractères, ce qui fait du modèle un modèle de suffixe ou de préfixe générique. Un astérisque (*) unique peut également être indiqué pour représenter toutes les chaînes.
méthode
Ce champ est utilisé pour spécifier un modèle pour un nom de méthode. Le modèle doit être spécifié sous forme de chaîne ne comportant aucun caractère blanc avec les mêmes règles de spécification que le champ classe.
mode
Ce champ spécifie si le package ou la classe correspondant au modèle doit être inclus dans le profilage ou exclu du profilage. Le paramètre mode a pour valeur INCLUDE ou EXCLUDE.

Les modèles de filtre sont traités dans l'ordre de leur spécification jusqu'à ce que le premier critère de concordance aboutisse. Si le nom de classe ne correspond à aucun modèle de filtre spécifié, la classe doit par défaut est incluse (INCLUDE).

Contrôle de l'agent de profilage Java

Lors du démarrage de l'agent de profilage Java avec le paramètre server=enabled ou server=controlled, les communications de l'agent s'effectuent via le plan de travail client à l'aide d'Agent Controller sur la machine hôte.

Remarques

Concepts connexes
Présentation de l'outil de profilage
Ressources de profilage

Tâches connexes
Profilage d'une application en mode autonome sous AS/400
Lancement ou association d'un processus Java
Utilisation de la vue Moniteur de profilage