Spécification des critères de profilage

Conditions requises :

Les actions suivantes sont effectuées dans la page Profilage de la configuration de profilage que vous avez créée lors du lancement ou de l'association de votre application.

La spécification de jeux de profilage et la création de filtres de profilage permet de spécifier le sous-ensemble d'informations à analyser. Les jeux de profilage spécifient le type de données à collecter et les filtres permettent de ne transmettre aux vues que les détails appropriés. L'utilisation des filtres est particulièrement utile lorsque la vitesse et l'efficacité sont cruciales : plus la quantité des données est faible, moins elles ont d'incidence sur le système et plus la vitesse de collecte est élevée.

La configuration des critères de profilage d'une application comprend les trois sections suivantes :

Configuration des généralités sur le profilage

  1. Dans la page Profilage de votre configuration de profilage, sélectionnez l'onglet Généralités.
  2. Cliquez sur Ajouter pour ajouter votre jeu de profilage. La boîte de dialogue Ajout d'un jeu de profilage s'ouvre.
  3. Entrez un nom et une description pour votre jeu de profilage. Cliquez sur OK. Un jeu de profilage est créé dans la liste des jeux de profilage.
  4. Sélectionnez le jeu de profilage nouvellement créé et cliquez sur Editer. La boîte de dialogue Edition d'un jeu de profilage s'ouvre.
  5. Cochez les cases appropriées pour spécifier les informations à collecter. Pour savoir quels jeux de profilage doivent être activés pour générer les différentes vues, reportez-vous à Jeux de profilage et vues disponibles.
  6. Cliquez sur Suivant.
  7. Dans la page Edition d'un filtre, spécifiez le jeu de filtres à appliquer en le sélectionnant dans la liste Sélectionnez un jeu de filtres. Vous pouvez utiliser le jeu Default.
  8. Sous Contenu du jeu de filtres sélectionné, cliquez sur Ajouter pour ajouter les packages dont vous voulez collecter les données. La boîte de dialogue Ajout d'un filtre s'affiche.
    Remarques : Certaines classes seront toujours visibles dans les vues de profilage, quels que soient les paramètres du filtre. L'agent de profilage collectera toujours les données des objets ou des classes associés à la tâche examinée lors de la collecte des données spécifiques à cette tâche. Vous pouvez par exemple spécifier un filtre pour la collecte des données d'une classe (MaClasseUtilisateurs) et un autre filtre pour exclure les classes java.lang.*. Lorsqu'une instance de MaClasseUtilisateurs est chargée, la définition de classe associée est également chargée. Cette définition de classe est associée à un objet de classe de type java.lang.Class. Les données sont donc collectées pour l'objet java.lang.Class et pour la classe MaClasseUtilisateurs.
    Ce comportement s'applique également aux unités d'exécution. La classe java.lang.Thread est toujours affichée dans les vues de profilage car l'agent de profilage recherche toutes les unités d'exécutions actives et collecte par conséquent les données des objets ou des classes associées à ces unités d'exécution.
  9. Spécifiez le package ou la classe, le nom de méthode, puis sélectionnez Include dans la liste Règle.
    Conseil : lorsque vous spécifiez les noms de package ou de méthode, vous pouvez spécifier * comme caractère générique (par exemple, org.eclipse.* ou *.sample.myapplication)
  10. Cliquez sur OK. Les critères de filtre sont ajoutés à la liste du contenu.
  11. Pour exclure d'autres packages de la liste du contenu des filtres, cliquez sur Include sous la colonne Règle du package et remplacez cette valeur par Exclude.
  12. Cliquez sur Fin.
  13. Cliquez sur Appliquer pour sauvegarder les modifications.
  14. Cliquez sur Exécuter pour commencer à profiler votre application.

Configuration des limites de profilage

Vous pouvez spécifier la quantité de données à collecter en spécifiant une limite par appel de méthode ou délai.

  1. Dans la page Profilage de votre configuration de profilage, sélectionnez l'onglet Limites.
  2. Pour limiter la quantité de données collectée par appel de méthode, cochez la case Arrêter le profilage après le nombre d'appels de méthodes indiqué. Spécifiez le nombre d'appels de méthode dans la zone de saisie fournie.
  3. Pour limiter la quantité de données collectée par délai, cochez la case Arrêter le profilage après le délai indiqué. Spécifiez le délai en secondes dans la zone de saisie fournie.

Configuration de la destination des données de profilage

Vous pouvez spécifier le projet et le moniteur à utiliser pour votre session de profilage. Vous pouvez également enregistrer les données de profilage dans un fichier.

  1. Dans la page Profilage de votre configuration de profilage, sélectionnez l'onglet Destination.
  2. Spécifiez le projet de profilage à utiliser pour votre session de profilage.
  3. Spécifiez le moniteur à utiliser.
  4. Pour sauvegarder les données de profilage dans un fichier, sélectionnez l'option Envoyer les données de profilage dans un fichier et spécifiez le nom du fichier dans la zone de saisie Fichier de profilage.
  5. Cliquez sur Appliquer pour sauvegarder les modifications.
  6. Cliquez sur Exécuter pour commencer à profiler votre application.
Conseil : Lors du filtrage, seul le premier filtre applicable est appliqué. Lorsque vous spécifiez des filtres, assurez-vous que vous déclarez bien les critères de filtre les plus spécifiques en premier.

Concepts connexes
Présentation de l'outil de profilage

Tâches connexes
Profilage d'une application
Définition des préférences de profilage