En mode autonome, les options de profilage sont spécifiées dans un fichier.
La section ci-après décrit le format de fichier et les options de profilage valides
pouvant être utilisés dans ce fichier.
Des commentaires peuvent être ajoutés dans le fichier des options de profile en
utilisant le caractère *.
Par exemple, la ligne
* Commentaire dans le fichier des profils
est ignorée par le profileur lors du traitement du fichier.
Les autres lignes du fichier respectent toutes le format suivant :
Clé d'option |
Valeur d'option |
- MONITOR_MODE
- Cette option contrôle si les événements du moniteur apparaissent dans la trace. Il
existe deux types d'événements de moniteur : les événements de moniteur en conflit
et les événements de moniteur en attente. Des événements de moniteur en conflit sont
générés lorsqu'une unité d'exécution essaye d'acquérir un moniteur déjà acquis par
une autre unité d'exécution. Des événements de moniteur en attente sont générés lorsqu'une
unité d'exécution attend un moniteur (par exemple, en exécutant la méthode wait()).
|
- all
- Tous les événements de moniteur apparaissent dans la trace.
- none
- Aucun événement de moniteur n'apparaît dans la trace.
|
- FILTERS
- Permet de spécifier si les filtres utilisés sont imprimés au début de la trace.
|
- vrai
- Imprime les filtres au début de la trace.
- faux
- N'imprime pas les filtres au début de la trace.
|
- TRACK_GC_EVENT_TYPES
- Permet d'indiquer le type d'événements de récupération de place (GC) à imprimer
dans la trace. Les deux types d'événement GC sont les événements de libération et
de déplacement d'objets.
|
- none
- N'imprime aucun événement GC.
- deletes
- frees
- N'imprime que les événements sans objet
- moves
- N'imprime que les événements de déplacement d'objet
- deletesAndMoves
- movesAndFrees
- Imprime les événements de libération et de déplacement d'objet.
|
- ID_STYLE
- Permet de spécifier les types d'ID objet à imprimer. Les types possibles sont
ID statique et ID déplaçable.
Un ID statique est un ID à usage unique affecté à un objet de la trace, la première fois
qu'il est détecté. En outre, cet ID n'est pas modifié pendant toute la durée
de l'exécution (même si la machine JVM déplace l'objet en interne). Les ID statiques sont
généralement utilisés par le profileur.
Un ID déplaçable correspond à l'ID que la machine JVM associe aux objets et qu'elle
peut modifier en cours d'exécution (si, par exemple, lors de la récupération de place,
un événement de déplacement d'objet survient).
|
- static
- N'imprime que les ID statiques
- relocatable
- N'imprime que les ID déplaçables
- staticAndRelocatable
- Imprime les ID statiques et déplaçables
|
- OPTIONS
- Permet de spécifier si les options de profilage doivent être imprimées dans la trace.
|
- vrai
- Imprime les options de profilage dans la trace.
- faux
- N'imprime pas les options de profilage dans la trace.
|
- TIMESTAMPS
- Permet de spécifier si les horodatages sont imprimés dans la trace.
|
- vrai
- Imprime les horodatages
- faux
- N'imprime pas les horodatages
|
- METHOD_COUNTS
- Permet de spécifier si le nombre de méthodes doit être imprimé à la fin de la trace.
|
- vrai
- Pour les méthodes tracées, imprime le nombre total de fois que les méthodes ont
été appelées, à la fin de la trace, juste avant l'arrêt de la machine JVM.
- faux
- N'imprime pas le nombre de méthodes.
|
- OBJ_ALLOC_IS_ARRAY
- Permet de spécifier si l'attribut isArray des affectations d'objet
doit être imprimé. (lorsqu'un objet est affecté, il s'agit ou non d'un tableau ;
l'attribut isArray contient ces informations.)
|
- vrai
- Imprime l'attribut isArray.
- faux
- N'imprime pas l'attribut isArray.
|
- STACK_INFORMATION
- Permet de spécifier le type de traçage de méthode à effectuer.
|
- none
- Ne procède à aucun traçage de méthode. Cela revient à NE PAS sélectionner
Analyse de la durée d'exécution dans la fenêtre de configuration du profil du plan
de travail.
- normal
- Trace toutes les méthodes non filtrées.
- boundary
- Trace toutes les méthodes non filtrées ET les méthodes boundary. Cela revient à
sélectionner Configuration du profil > Analyse de la durée d'exécution >
Collecter les classes boundary exclues par le jeu de filtres dans le plan de
travail.
- contiguous
- Trace toutes les méthodes non filtrées ET toutes les méthodes filtrées de la
pile d'appel des méthodes comprises entre deux méthodes non filtrées. Supposons par
exemple que la méthode A appelle la méthode B, qui appelle la méthode C, qui appelle
à son tour la méthode D.
Supposons par ailleurs que les méthodes A et D ne sont pas filtrées, mais que les
méthodes B et C le sont. Comme les méthodes B et C sont comprises entre deux méthodes
non filtrées, elles sont également tracées.
- boundaryAndContiguous
- Revient à définir les valeurs d'option "contiguous" et "boundary" pour
STACK_INFORMATION.
|
- BOUNDARY_DEPTH
- Permet de spécifier la profondeur de traçage boundary lorsque STACK_INFORMATION=boundary
ou boundaryAndContiguous.
|
- Entier
- Entier spécifiant la profondeur du traçage boundary.
|
- TICKET
- Permet de spécifier si l'attribut ticket doit apparaître dans la trace.
|
- vrai
- L'attribut Ticket doit apparaître dans la trace.
- faux
- L'attribut Ticket ne doit pas apparaître dans la trace.
|
- TRACE_MODE
- Permet de spécifier le mode de traçage. De manière générale, le mode de
traçage indique si les informations sur les objets (segment de mémoire) sont tracées ou
non. (La valeur "none" a une signification particulière.)
|
- full
- Trace toutes les informations possibles sur les objets. Il s'agit de tracer
les affectations d'objet et les objets associés à des appels de méthode (si le
traçage des méthodes est activé pour STACK_INFORMATION).
- none
- Ne procède à aucun traçage. (Si cette valeur est définie, l'option
STACK_INFORMATION est remplacée même si elle est définie de sorte à tracer les appels
de méthode.)
- noObjectCorrelation
- Ne trace pas les informations sur les objets. Cette valeur est différente de
la valeur "none" dans la mesure où le traçage des appels de méthode peut quand même
avoir lieu (si STACK_INFORMATION est correctement défini), mais les objets associés aux
appels de méthode et les informations relatives aux affectations d'objet ne seront pas
tracés.
|
- TRACE_ID_REFS
- Permet d'indiquer si l'attribut de référence d'ID trace doit être imprimé. La
référence d'ID trace est un identificateur unique à la trace.
|
- vrai
- Imprime l'attribut de référence d'ID trace.
- faux
- N'imprime pas l'attribut de référence d'ID trace.
|
(C) Copyright IBM Corporation 2000, 2006. Tous droits réservés.