Activation du traçage étendu pour JPA

Dans certains cas, les informations de traçage générées par les fournisseurs JPA (Java™ Persistence API) mis à disposition avec WebSphere Application Server ne permettent pas de diagnostiquer un incident. Dans une telle situation, il est possible d'activer un mécanisme d'extension de trace afin de générer des informations supplémentaires dans le fichier de trace. La trace étendue ne peut fonctionner qu'avec les fournisseurs de persistance fournis par IBM. Elle est incompatible avec des fournisseurs tiers, y compris les autres versions de OpenJPA regroupées dans une application ou configurées en tant que bibliothèque partagée.

Pourquoi et quand exécuter cette tâche

Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications.

Vous pouvez activer la fonction de traçage étendu de JPA d'une application s'exécutant sous WebSphere Application Server conformément à des méthodes simples qui recommandent l'utilisation de scripts wsadmin ou de la console d'administration. Les étapes de cette rubrique expliquent comment configurer la fonction de traçage étendu en utilisant la console d'administration. L'exécution de la procédure modifie les paramètres du serveur. Il est donc recommandé de sauvegarder la configuration du serveur avant de lancer l'opération.

Procédure

  1. Activez l'agent de trace. Vous devez activer un agent de trace par serveur d'applications en transmettant un argument à la machine JVM (Java Virtual Machine) du serveur. Vous pouvez activer l'agent de trace en utilisant la console d'administration. Pour ce faire, procédez comme suit :
    1. Dans le panneau de navigation, sélectionnez Serveurs. Sélectionnez Serveurs d'applications.
    2. Dans le panneau de la liste des serveurs, sélectionnez le serveur qui nécessite le traçage étendu JPA. Si plusieurs serveurs spécifient une fonctionnalité JPA pour votre application, suivez la procédure ci-après pour chaque serveur.
    3. Dans l'en-tête Infrastructure du serveur, sélectionnez Gestion des processus et Java. Sélectionnez Définition de processus.
    4. Dans l'en-tête Propriétés supplémentaires, sélectionnez Machine virtuelle Java.
    5. Ajoutez l'argument suivant dans la zone Arguments JVM génériques, où <racine_serveur_app> correspond au chemin complet du répertoire d'installation du serveur d'applications. Veillez à utiliser le caractère de séparation de chemin pris en charge par votre système d'exploitation.
      -javaagent:<racine_serveur_app>/optionalLibraries/IBM/wsjpa/wsjpatrace.jar
      Important : Si vous utilisez des arguments JVM génériques dans la console d'administration, ces derniers ne peuvent pas contenir d'espaces. Si des espaces figurent dans la zone, le serveur risque de ne pas démarrer. Cette situation risque plus d'arriver dans un environnement Windows parce que le chemin d'installation par défaut C:\Program Files\IBM\WebSphere\AppServer, contient un espace. Afin de résoudre ce problème rencontré dans un environnement Windows, utilisez un nom de chemin abrégé pour <racine_serveur_app>. Par exemple, C:\Progra~1\IBM\WebSphere|AppServer. Sous Unix, vous pouvez utiliser un lien symbolique pour supprimer les espaces figurant dans <racine_serveur_app>. Par exemple, si le chemin d'installation de WebSphere Application est /opt/app_server_root/AppServer, vous pouvez créer un lien symbolique dans /opt entre <app_server_root> et AppServerRoot, et éliminer ainsi de l'espace. Spécifiez ensuite /opt/AppServerRoot/AppServer en tant que <racine_serveur_app> de l'argument JVM générique.
  2. Activez des composants de trace supplémentaires et réglez les options du fichier de trace. Pour ce faire, utilisez le script wsadmin ou la console d'administration. Ces étapes expliquent comment régler les paramètres du fichier de trace et comment activer des composants via la console d'administration :
    1. Dans le panneau de navigation, sélectionnez Résolution des incidents. Cliquez sur Journaux et Trace.
    2. Sélectionnez le nom du serveur à tracer.
    3. Sous Propriétés générales, sélectionnez Trace des diagnostics.
    4. Assurez-vous que la case Activer le journal est cochée et, si nécessaire, augmentez les valeurs des zones Taille maximale du fichier et Nombre maximal de fichiers historiques. En fonction du nombre de catégories et du niveau de trace choisis, le fichier de trace peut devenir volumineux.
    5. Dans l'en-tête Propriétés supplémentaires, sélectionnez Modifier les niveaux de détails du journal.
    6. Activez différentes catégories de trace étendu en spécifiant une ou plusieurs catégories de trace du tableau suivant. Voici un exemple de chaîne de trace : *=info:JPA=all:openjpa.*=finer:openjpa.kernel=finest. La trace étendue effectue un traçage de niveau FINER ou FINEST. Le niveau FINEST inclue plus de détails que FINER. Si vous spécifiez ALL, la trace étendue effectue un traçage au niveau FINEST.
      Tableau 1. Catégories de trace. Sauvegardez votre configuration de serveur avant d'activer le traçage amélioré.
      Catégorie Niveaux de trace appropriés Description
      JPA OFF, ALL, FINER, FINEST Ajoute une trace étendue au groupe de traces de l'API JPA.
      openjpa.* OFF, ALL, FINER, FINEST Trace OpenJPA normale ajoutée à la fonction de traçage étendu de toutes les catégories de l'implémentation OpenJPA lorsque la fonction de traçage étendu est activée.
      openjpa.xtrace.* OFF, ALL, FINER, FINEST Trace étendue de toutes les catégories de l'implémentation OpenJPA lorsque la fonction de traçage étendu est activée.
      openjpa.xtrace.Jdbc OFF, ALL, FINER, FINEST Trace étendue des classes JDBC OpenJPA lorsque la fonction de traçage étendu est activée.
      openjpa.xtrace.Lib OFF, ALL, FINER, FINEST Trace étendue des classes de bibliothèque OpenJPA lorsque la fonction de traçage étendu est activée.
      openjpa.xtrace.Persist OFF, ALL, FINER, FINEST Trace étendue des classes persistantes OpenJPA lorsque la fonction de traçage étendu est activée.
      openjpa.xtrace.Kernel OFF, ALL, FINER, FINEST Trace étendue des classes noyau OpenJPA lorsque la fonction de traçage étendu est activée.
      openjpa.xtrace.General OFF, ALL, FINER, FINEST Trace étendue des classes OpenJPA n'appartenant pas aux catégories JDBC, Lib, Persist ou Kernel, lorsque la fonction de traçage étendu est activée.
      openjpa.xtrace.ApiSpi OFF, ALL, FINER, FINEST Trace étendue des interfaces API/SPI publiques définies pour WsJPA, OpenJPA et JPA lorsque la fonction de traçage étendu est activée.
  3. Sauvegardez la configuration du serveur d'applications, puis redémarrez-le.

Résultats

Une fois le serveur d'applications redémarré, les nouveaux paramètres de trace sont utilisés.

Que faire ensuite

Eviter les incidents Eviter les incidents: Le traçage constitue un facteur important de baisse des performances. Vous devez, par conséquent, désactiver cette option lorsqu'elle est inutile. Pour ce faire, supprimez l'argument JVM générique ainsi que les niveaux de détail de trace éventuellement ajoutés en vue d'un traçage étendu.gotcha

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tejb_jpatracejee
Nom du fichier : tejb_jpatracejee.html