Spécification des critères de profilage

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.

Conditions requises :

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. Sélectionnez l'un des jeux de profilage par défaut disponibles. Cliquez sur le jeu de profilage pour afficher la description de la nature des données collectées pour le jeu de profilage.
  3. Si vous devez utiliser une combinaison de jeux de profilage par défaut, vous pouvez créer un jeu de profilage personnalisé :
    1. Cliquez sur Ajouter pour ajouter votre jeu de profilage. L'assistant Ajout d'un jeu de profilage s'ouvre.
    2. Dans la page Jeu de profilage, nommez et décrivez votre jeu de profilage. Cliquez sur Suivant.
    3. Dans la page Type de profilage, cochez les cases appropriées pour spécifier les informations à collecter. Référez-vous au tableau ci-dessous pour voir quels types de profilage doivent être activés pour générer différentes vues et les applications possibles pour chaque type de profilage.
      Type de profilage Options sélectionnées Vues disponibles Application
      Analyse de la mémoire N/A Vue Statistiques de la mémoire (Package, Classe, Méthode), Vue Références d'objets* Analyse de fuite de la mémoire, Identification des classes consommant une quantité de mémoire importante
      Analyse de la mémoire Avancée > Case Informations de niveau d'instance cochée Vue Statistiques de la mémoire (Package, Classe, Méthode, Instance) Vue Références d'objets* Analyse de fuite de la mémoire, Etude de la récupération de place
      Analyse du délai Affiche les statistiques d'exécution (données compressées) Statistiques d'exécution (Package, Classe, Méthode) Statistiques de couverture Affichage des appels d'une méthode
      Analyse du délai Affiche les statistiques d'exécution (données compressées), Avancée > Collecter les informations de niveau d'instance Statistiques d'exécution (Package, Classe, Méthode, Instance) Statistiques de couverture Affichage des statistiques de package, classe et méthode pour chaque instance, Affichage des appels d'une méthode
      Analyse du délai Affiche les détails graphiques de l'exécution Statistiques d'exécution (Package, Classe, Méthode), Statistiques de couverture, Vue Flux d'exécution, Vues Diagrammes de séquences UML2 (objet, classe, unité d'exécution) Identification des unités d'exécution actives, Identification des phases de l'exécution d'un programme
      Analyse du délai Afficher les détails graphiques de l'exécution, Avancée > Collecter les informations de niveau d'instance Statistiques d'exécution (Package, Classe, Méthode, Instance), Statistiques de couverture, Vue Références d'objets*, Vue Exécution de flux, Vues Diagrammes de séquence UML2 (objet, classe, unité d'exécution) Identification des unités d'exécution actives, Identification des phases de l'exécution d'un programme
      Couverture du code N/A Statistiques de couverture (Package, Classe, Méthode) Affichage de la couverture du code

      * Remarque : pour la vue Références d'objets, vous aurez besoin de collecter des références d'objets en appelant l'action Collecter les références d'objets pour afficher les données de profilage à l'aide de la vue Références d'objets. Vous pouvez appeler Collecter les références d'objets à partir de la barre d'outils de la vue Moniteur de profilage ou en cliquant avec le bouton droit de la souris sur l'agent dans la vue Moniteur de profilage.

    4. Cliquez sur Suivant.
    5. Dans la page Jeu de filtres, spécifiez le jeu de filtres que vous voulez appliquer en le sélectionnant à partir de la liste Sélectionner un jeu de filtres. Vous pouvez utiliser le jeu Default.
    6. 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. Vous pouvez utiliser un astérisque * comme caractère générique dans un modèle lorsque vous spécifiez des noms de package ou de méthode.
      Remarque 1. Lorsque vous entrez un modèle pour le nom du package ou de la méthode, il peut être spécifié de trois manières différentes :
      • Un modèle sans caractère générique, par exemple org.eclipse.tptp.
      • Un modèle avec un caractère générique au début, par exemple *.sample.myapplication.
      • Un modèle avec un caractère générique à la fin, par exemple org.eclipse.*.

      Remarque 2. 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.

    7. Spécifiez le package ou la classe, le nom de méthode, puis sélectionnez Include dans la liste Règle.
    8. Cliquez sur OK. Les critères de filtre sont ajoutés à la liste du contenu.
    9. 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.
    10. Cliquez sur Fin. Un jeu de profilage est créé dans la liste des jeux de profilage.
  4. Cliquez sur Appliquer pour sauvegarder les modifications.

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 Profil pour démarrer le profilage de 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