Spécification des options du profileur

La boîte de dialogue Profiler Options (Options du profileur) comprend les onglets suivants:

• Mode (Mode)

• IDM Object Filters (Filtres à objets IDM)

• Java Filters (Filtres Java)

• Miscellaneous (Divers)

Utilisez les options de ces onglets pour indiquer les objets à profiler et les éléments à afficher dans le profil.

Après la spécification des options du profileur, cliquez sur OK pour démarrer le profileur. Selon la configuration de votre projet, le profileur effectuera l'une ou l'autre des séries d'opérations suivantes :

• Si vous utilisez un projet Identity Manager normal avec une instance imbriquée d'Identity Manager, le profileur effectue une compilation complète, un déploiement dans le serveur d'application de NetBean et démarre le profileur.

• Si vous utilisez un projet Identity Manager normal avec une instance externe d'Identity Manager ou le projet Identity Manager distant, le profileur se rattache à l'instance d'Identity Manager configurée pour le projet.

Vous pouvez sélectionner IdM -> Set Identity Manager Instance (Définir l'instance d'Identity Manager) pour contrôler l'action de l'instance d'Identity Manager pour le projet.

Mode (Mode)

L'onglet Mode comporte les options suivantes :

• IDM Objects Only (Objets IDM uniquement) : sélectionnez cette option pour profiler les objets formulaire, règle, flux de travaux et XPRESS. Exclut les objets Java du profil.

• Java and IDM Objects (Objets Java et IDM) : sélectionnez cette option pour profiler les objets formulaire, règle, flux de travaux et XPRESS.

  ---

  Remarque –

  • L'option Java and IDM Objects n'est pas disponible si vous si vous utilisez un projet Identity Manager normal avec une instance externe d'Identity Manager ou un projet Identity Manager distant.

  • Vous ne pouvez pas modifier l'option Mode pendant l'exécution du profileur : vous devez arrêter ce dernier pour la modifier.

  ---

IDM Object Filters (Filtres à objets IDM)

L'onglet IDM Object Filters (Filtres à objets IDM) comporte les options suivantes :

• Show IDM Object details (Afficher les détails des objets IDM)

  • Sélectionnez cette case pour inclure tous les éléments de type formulaire, flux de travaux et XPRESS dans l'instantané.

  • Désélectionnez-la pour n'inclure que les éléments suivants dans l'instantané :

    • <invoke>

    • <new>

    • <Rule>

    • <Form>

    • <WFProcess>

    • <ExScript>

    • <ExDefun>

    • <FieldRef>

    • <Action> (pour les légendes de l'application de flux de travaux)

• Include Anonymous Sources (Inclure les sources anonymes) :

  ---

  Remarque –

  Les sources anonymes sont des formulaires (ou des portions de formulaire) qui sont générées à la volée (par exemple des formulaires Login et MissingFields) et ne correspondent à aucun formulaire persistant résidant dans le référentiel d'Identity Manager.

  ---

  • Cochez cette case pour inclure que les sources anonymes dans l'instantané.

  • Désélectionnez cette case pour exclure que les sources anonymes dans l'instantané.

Java Filters (Filtres Java)

Sélectionnez l'onglet Java Filters (Filtres Java) pour

• inclure ou exclure des filtres Java ;

• créer de nouveaux filtres ;

• supprimer des filtres existants ;

• restaurer les filtres par défaut.

Les filtres Java sont formulés en termes de modèles de méthode et sont exprimés sous la forme de modèles qui incluent ou excluent les éléments sur la base du nom de méthode canonique. Lorsqu'un nom de méthode canonique est du type :

nom-classe-complet.nom-méthode( type-paramètre-1, type-paramètre-2, ... )

Pour les constructeurs, nom-méthode est <init>.

Voici quelques exemples :

• Pour exclure tous les constructeurs, activez la case Exclude (Exclure) et ajoutez le filtre suivant :

  *.<init>(*)

• Pour exclure tous les constructeurs ayant un unique paramètre org.w3c.dom.Element, activez la case Exclude (Exclure) et ajoutez le filtre suivant :

  *.<init>(org.w3c.dom.Element)

• Pour exclure toutes les classes d'Identity Manager, activez la case Exclude (Exclure) et ajoutez les filtres suivants :

  "com.waveset.*"
  "com.sun.idm.*"

• Pour instrumenter uniquement votre code personnalisé, désactivez la case Exclude (Exclure), supprimez le filtre * include initial puis ajoutez le filtre suivant :

  "com.yourcompany.*"

Ces deux derniers exemples sont en fait équivalents car les filtres ne sont appliqués qu'aux classes personnalisées et aux classes d'Identity Manager.

Si nécessaire, vous pouvez instrumenter d'autres JAR en modifiant comme approprié les lignes suivantes dans build.xml. Par exemple :

<instrument todir="${lighthouse-dir-profiler}/WEB-INF"
verbose="${instrumentor.verbose}" includeMethods="${profiler.includes}"
excludeMethods="${profiler.excludes}">
           <fileset dir="${lighthouse-dir}/WEB-INF">
               <include name="lib/idm*.jar"/>
               <include name="classes/**/*.class"/>
           </fileset>
</instrument>

Par défaut, la configuration inclut toutes vos classes personnalisées et la plupart des classes d'Identity Manager . Un nombre de classes d'Identity Manager sont obligatoirement exclues car les activer signifierait interrompre le profileur.

Par exemple, les classes provenant des moteurs de flux de travaux, de formulaires et XPRESS sont exclues, sinon le profileur produirait un instantané incompréhensible lors du profilage des objets Java et Identity Manager.

Vous remarquerez que les filtres Java assurent un filtrage bien plus fin que les filtres à objets IDM. L'instrumentation Java allonge considérablement le temps d'exécution ce qui dévie drastiquement les résultats de profilage. Les objets d'Identity Manager étant interprétés plutôt que compilés, le temps d'instrumentation est négligeable. Ainsi, à titre d'exemple, il n'y a pratiquement aucune raison d'exclure le flux de travaux A et d'inclure le flux de travaux B, et ainsi de suite.

Vous ne pouvez pas modifier les filtres Java pendant l'exécution du profileur. Vous devez arrêter le profileur avant de changer les filtres Java.

Miscellaneous (Divers)

L'onglet Miscellaneous (Divers) comporte les options suivantes :

• Prune snapshot nodes where execution time is 0 (Élaguer les nœuds d'instantané lorsque le temps d'exécution est 0) :

  • Désactivez cette option (valeur par défaut) si vous voulez que l'instantané inclue les informations d'appel pour toutes les entités exécutée, même de celles dont le temps d'exécution est null.

    Il peut être utile de disposer du nombre des appels même pour les nœuds sans temps d'exécution.

  • Activez cette option pour supprimer ces nœuds et mieux pouvoir vous concentrer sur les données de profilage les plus pertinentes. De plus, activer cette option peut permettre de limiter considérablement la taille de l'instantané du profileur.

• Automatically Open Browser Upon Profiler Start (Ouvrir automatiquement le navigateur au démarrage du profileur) :

  • Activez cette option (valeur par défaut) lorsque vous lancez le profileur pour ouvrir automatiquement un navigateur qui pointe sur l'instance d'Identity Manager dont le profilage est en cours.

  • Désactivez cette option si vous ne voulez pas ouvrir de navigateur.

• Include Java Sources in Snapshot (Inclure les sources Java dans l'instantané) :

  • Activez cette option (valeur par défaut) pour inclure les sources Java pour toutes les méthodes Java référencées par les données de profilage dans l'instantané. Vous devriez toujours utiliser ce paramètre pour les instantanés dans le champ. Custom Java est relativement petit et se révèle un atout précieux pour le support.

  • Ne désactivez cette option que si vous profilez Identity Manager et disposez de l'ensemble de la source d'Identity Manager.

    Dans ce cas, il ne convient pas d'inclure la source d'Identity Manager car cela pourrait créer des instantanés gigantesques. (pour plus d'informations, voir Mode de localisation et de gestion de la source par le profileur).