Ajout d'une fonction de consignation et de trace à votre application

Vous pouvez ajouter une fonction de consignation et de trace à vos applications pour analyser les incidents liés aux performances et au diagnostic dans WebSphere Application Server.

Pourquoi et quand exécuter cette tâche

Recommandation : Il est déconseillé d'utiliser la structure JRas décrite dans le centre de documentation. Toutefois, vous pouvez atteindre les mêmes résultats à l'aide de la consignation Java™.

Les concepteurs et développeurs d'applications fonctionnant avec ou sous WebSphere Application Server, tels que les servlets, les fichiers JSP (JavaServer Pages), les beans enterprise, les applications client et leurs classes de support apprécieront de pouvoir utiliser la consignation Java pour générer la consignation de leurs applications.

Cette approche présente des avantages par rapport à celle qui consiste à ajouter des instructions System.out.println au code :
  • Vos messages s'affichent dans les fichiers journaux standard de WebSphere Application Server, dans un format de message standard avec des données supplémentaires, comme une date et un horodatage qui sont ajoutés automatiquement.
  • Vous pouvez plus facilement mettre en corrélation des incidents et des événements de votre propre application avec des incidents et des événements liés aux composants de WebSphere Application Server.
  • Vous pouvez bénéficier des fonctions de gestion des fichiers journaux de WebSphere Application Server.
  • [AIX Solaris HP-UX Linux Windows]Vous pouvez afficher les messages avec l'outil Log and Trace Analyzer.

Gestionnaire de journal

Procédure

  1. Activez et configurez le type de consignation de votre choix pris en charge. Utilisez l'une des méthodes suivantes :
  2. Personnalisez les propriétés afin de répondre à vos besoins de consignation. Par exemple, activez ou désactivez un journal particulier, indiquez le nombre de journaux à conserver et spécifiez un format de sortie pour le journal.
  3. Si vous ne souhaitez pas que le journal et la trace de Jakarta Commons Logging utilise l'infrastructure de journal et de trace de WebSphere, reconfigurez Jakarta Commons Logging.
    Pratiques recommandées Pratiques recommandées: Utilisez l'infrastructure de trace et de journal WebSphere pour le contenu de tous les journaux afin de simplifier l'identification de la source du problème.bprac
  4. Redémarrez le serveur d'applications une fois que vous avez apporté les modifications à la configuration statique.

Exemple

La règle de sécurité exemple qui suit permet l'accès au système de fichiers et aux classes d'exécution. Incluez cette règle de sécurité à l'entrée permission java.util.logging.LoggingPermission "control" dans le répertoire META-INF de l'application si vous souhaitez que vos applications modifient par programme les propriétés contrôlées des programmes de consignation et des gestionnaires. Le fichier META-INF se trouve dans les emplacements suivants des différents types de module :

Nom du projet Emplacement
Projets EJB ejbModule/META-INF/MANIFEST.MF
Projets du client d'application appClientModule/META-INF/MANIFEST.MF
Projets Web dynamiques WebContent/META-INF/MANIFEST.MF
Projets du connecteur connectorModule/META-INF/MANIFEST.MF

Here is a sample security policy that grants permission to modify logging properties:

//////////////////////////////////////////////////
//
// WebSphere Application Server Security Policy
//
//////////////////////////////////////////////////

////////////////////////////////////////////////////////////////////////
// Allow all access to the file system and runtime classes
////////////////////////////////////////////////////////////////////////
grant codeBase "file:${application}" {
   permission java.util.logging.LoggingPermission "control";
};

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=ttrb_addtrace
Nom du fichier : ttrb_addtrace.html