Options de profilage pour le profilage d'une application en mode autonome

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é_option> = <valeur_option>
Le tableau suivant répertorie les paires clé d'option/valeur d'option valides pour le profilage :
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.

Tâches connexes
Profilage d'une application
Profilage d'une application en mode autonome

Références connexes
Limitations lors du profilage d'une application sous AS/400