Journalisation et traçage dans WebSphere Application Server Community Edition

Pour activer la journalisation et le traçage des informations d'IMS TM Resource Adapter dans WebSphere Application Server Community Edition, affectez la sortie de trace à un fichier ou un tampon mémoire et spécifiez le niveau de journalisation pour les packages contenant des informations d'IMS TM Resource Adapter.

Pourquoi et quand exécuter cette tâche

Pour obtenir une sortie des informations de journalisation et de traçage d'IMS TM Resource Adapter :

Procédure

  1. Ouvrez le fichier logging.properties. Ce fichier se trouve dans le répertoire JAVA_HOME/jre/lib. Par exemple : C:\Program Files\IBM\Java60\jre\lib.

    Vous pouvez identifier le répertoire de base de Java (JAVA_HOME) en examinant la propriété java.home dans la console d'administration de WebSphere Application Server Community Edition, sous la section Java System Info.

  2. Spécifiez le niveau de journalisation pour IMS TM Resource Adapter en ajoutant la propriété com.ibm.j2ca.RAIMSTM.level avec la valeur FINEST :
    com.ibm.j2ca.RAIMSTM.level=FINEST
  3. Par défaut, le gestionnaire (handler) de console est activé, mais pas le gestionnaire de fichier. Activez ce dernier en supprimant la mise en commentaire de la ligne suivante :
    handlers= java.util.logging.FileHandler
  4. Par défaut, le formateur XML est utilisé pour l'affichage du journal. Vous pouvez utiliser le formateur simple à la place. Pour passer au formateur simple, mettez en commentaire la ligne du formateur XML par défaut et ajoutez une ligne pour le formateur simple, comme ceci :
    //java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter
    java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter 
  5. Redémarrez le serveur WebSphere.
  6. Exécutez votre application Java™ puis examinez le fichier de trace. Par défaut, le fichier de trace est situé dans le répertoire WASCE_HOME/var/temp, comme le définit la ligne suivante dans le fichier logging.properties :
    java.util.logging.FileHandler.pattern = %t/java%u.log
    Par exemple, C:\Program Files\IBM\WebSphere\AppServerCommunityEdition\var\temp\java0.log.
    A la place, vous pouvez spécifier le fichier journal dans le fichier geronomi-ra.xml, sous la section <resourceadapter-instance>. Par exemple :
    <resourceadapter-instance>
      <!-- Spécifiez un nom pour l'adaptateur de ressources -->
      <resourceadapter-name>IMSTMRA</resourceadapter-name>
        <config-property-setting name="traceFilename">imsico-trace.log</config-property-setting>
    Avec cette configuration, le fichier imsico-trace.log est placé sous WASCE_HOME\bin\logs\. Par exemple, C:\Program Files\IBM\WebSphere\AppServerCommunityEdition\bin\logs\imsico-trace_x.log.

Résultats

Voici des exemples de sorties du formateur XML, du formateur simple et du fichier journal d'IMS TM Resource Adapter spécifié dans le fichier geronomi-ra.xml :
  • Formateur XML
    <?xml version="1.0" encoding="GBK" standalone="no"?>
    <!DOCTYPE log SYSTEM "logger.dtd">
    <log>
    <record>
      <date>2012-01-18T10:11:27</date>
      <millis>1326852687578</millis>
      <sequence>0</sequence>
      <logger>com.ibm.j2ca.RAIMSTM</logger>
      <level>FINER</level>
      <class>com.ibm.j2ca.base.WBIResourceAdapter</class>
      <method>start(BootstrapContext)</method>
      <thread>10</thread>
      <message>Entering method.</message>
    </record>
    <record>
      <date>2012-01-18T10:11:27</date>
      <millis>1326852687640</millis>
      <sequence>1</sequence>
      <logger>com.ibm.j2ca.RAIMSTM</logger>
      <level>INFO</level>
      <class>com.ibm.j2ca.base.WBIResourceAdapter</class>
      <method>start(BootstrapContext)</method>
      <thread>10</thread>
      <message>AFC Version : 7.0.0.4 IF02</message>
    </record>
    <record>
      <date>2012-01-18T10:11:27</date>
      <millis>1326852687687</millis>
      <sequence>2</sequence>
      <logger>com.ibm.j2ca.RAIMSTM</logger>
      <level>FINER</level>
      <class>com.ibm.j2ca.base.WBIResourceAdapter</class>
      <method>start(BootstrapContext)</method>
      <thread>10</thread>
      <message>Exiting method.</message>
    </record>
  • Formateur simple
    2012-1-18 10:22:13 com.ibm.j2ca.base.WBIResourceAdapter start(BootstrapContext)
    FINER: Entering method.
    2012-1-18 10:22:13 com.ibm.j2ca.base.WBIResourceAdapter start(BootstrapContext)
    INFO: AFC Version : 7.0.0.4 IF02
    2012-1-18 10:22:13 com.ibm.j2ca.base.WBIResourceAdapter start(BootstrapContext)
    FINER: Exiting method.
  • Fichier journal d'IMS TM Resource Adapter spécifié dans le fichier geronomi-ra.xml :
    [[12/01/18 10:22:13:453 CST ][ThreadID: 10 ][SequenceNumber: 0][ClassName:
    com.ibm.j2ca.base.WBIResourceAdapter ][MethodName: start(BootstrapContext) ]
    [Type: INFO ][Logger: com.ibm.j2ca.RAIMSTM ][Level: FINER ][Msg: Entering method. ]]
    [[12/01/18 10:22:13:453 CST ][ThreadID: 10 ][SequenceNumber: 1][ClassName:
    com.ibm.j2ca.base.WBIResourceAdapter ][MethodName: start(BootstrapContext) ][Type:
    INFO ][Logger: com.ibm.j2ca.RAIMSTM ][Level: INFO ][Msg: AFC Version : 7.0.0.4 IF02 ]]
    [[12/01/18 10:22:13:468 CST ][ThreadID: 10 ][SequenceNumber: 2][ClassName:
    com.ibm.j2ca.base.WBIResourceAdapter ][MethodName: start(BootstrapContext) ][Type:
    INFO ][Logger: com.ibm.j2ca.RAIMSTM ][Level: FINER ][Msg: Exiting method. ]]

Vos commentaires