La consignation suit les opérations habituelles des utilisateurs de CM Server et de l'API CM, ainsi que toutes les erreurs pouvant se produire pendant l'exécution de CM Server ou de votre application reposant sur l'API CM. Les entrées de journal sont effectuées dans la langue de l'environnement local par défaut de la machine ou en anglais américain si l'environnement local de la machine n'est pas pris en charge.
Par défaut, la consignation pour CM Server est définie sur le niveau INFO. Il est conseillé d'activer la consignation pour votre application reposant sur l'API CM sur le niveau INFO.
Vous pouvez configurer l'API CM, WebSphere Application Server et les packages de consignation TSlogger.
La consignation de l'API CM sont contrôlés à l'aide du fichier logging.properties qui se trouve dans la structure des répertoires du JDK (kit de développement Java) du JRE (environnement d'exécution Java) utilisé pour exécuter votre application. Recherchez le fichier logging.properties dans le répertoire jre\lib de votre kit Java Development Kit (par exemple : C:\Program Files\IBM\WebSphere\AST\eclipse\jre\lib, C:\jdk_5.0\jre\lib ou C:\Program Files\Java\jre1.5.0_06\lib).
La consignation est désactivée par défaut ; il est conseillé de l'activer au niveau INFO.
############################################################ # Propriétés globales ############################################################ # # "handlers" indique une liste séparée par des virgules de classes # de gestionnaire de journal. Ces gestionnaires seront installés pendant le démarrage de la machine virtuelle. # Notez que ces classes doivent figurer dans le paramètre CLASSPATH système. # Par défaut, nous ne configurons qu'un ConsoleHandler qui affichera # uniquement les messages aux niveaux INFO et supérieurs. handlers = java.util.logging.ConsoleHandler # Si vous voulez ajouter aussi FileHandler, utilisez à la place la ligne suivante. #handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler # Niveau de consignation global par défaut. # Cela indique quelles catégories d'événements sont consignées dans # tous les journaux d'événements. Pour une fonction donnée, ce niveau global # peut être remplacé par un niveau spécifique à la fonction. # Notez que ConsoleHandler comporte aussi un paramètre de niveau # séparé pour limiter les messages imprimés sur la console. # La ligne suivante active la consignation (pour tous les objets de journal d'événements) pour le niveau INFO. .level=INFO ############################################################ # Propriétés spécifiques au gestionnaire. # Décrit les informations de configuration spécifiques aux gestionnaires. ############################################################ # CMLogger - doit toujours être activé au niveau INFO. # # Les applications utilisant l'API CM n'ont pas besoin d'être arrêtées et redémarrées. Les changements du # fichier logging.properties configuré sont automatiquement pris en compte et mis en oeuvre en 10 secondes. # # Les lignes suivantes configurent la consignation pour l'objet CMLogger pour le niveau INFO # et définissent que le fichier de sortie de journal sera nommé CMLogger[#].log et se trouvera dans le # répertoire personnel de l'utilisateur connecté. Le fichier de sortie de journal tournera entre 40 fichiers, chaque fichier étant # limité à 40000000 octets. Les entrées de journal seront ajoutées au fichier de sortie de journal # actuel à tour de rôle et seront écrites en format simple. # com.ibm.rational.stp.common.internal.util.CMLogger.level = INFO com.ibm.rational.stp.common.internal.util.LogHandler.pattern = %h/CMLogger%g.log com.ibm.rational.stp.common.internal.util.LogHandler.limit = 40000000 com.ibm.rational.stp.common.internal.util.LogHandler.count = 40 com.ibm.rational.stp.common.internal.util.LogHandler.append = true com.ibm.rational.stp.common.internal.util.LogHandler.formatter = java.util.logging.SimpleFormatter # CMTracer - Activez les entrées suivantes (en supprimant leur mise en commentaire) pour une utilisation uniquement temporaire, car le traçage # peut consommer beaucoup de ressources. # # Les applications utilisant l'API CM n'ont pas besoin d'être arrêtées et redémarrées. Les changements du # fichier logging.properties configuré sont automatiquement pris en compte et mis en oeuvre en 10 secondes. # # Les lignes suivantes configurent le traçage pour l'objet CMTracer au niveau FINER # et définissent que le fichier de sortie de trace sera nommé CMTracer[#].log et se trouvera dans le # répertoire personnel de l'utilisateur connecté. Le fichier de sortie de trace tournera entre 40 fichiers, chaque fichier étant # limité à 40000000 octets. Les entrées de trace seront ajoutées au fichier de sortie de trace # actuel à tour de rôle et seront écrites en format simple. # #com.ibm.rational.stp.common.internal.util.CMTracer.level = FINER #com.ibm.rational.stp.common.internal.util.TraceHandler.pattern = %h/CMTracer%g.log #com.ibm.rational.stp.common.internal.util.TraceHandler.limit = 40000000 #com.ibm.rational.stp.common.internal.util.TraceHandler.count = 40 #com.ibm.rational.stp.common.internal.util.TraceHandler.append = true #com.ibm.rational.stp.common.internal.util.TraceHandler.formatter = java.util.logging.SimpleFormatter
Ces paramètres engendrent un fichier journal nommé CMLogger[#].log et un fichier de sortie de trace nommé CMTracer[#].log (si les entrées CMTracer n'ont pas exclues sous forme de commentaire). Chaque fichier se trouve dans le répertoire personnel de l'utilisateur connecté (où [#] désigne le numéro de rotation du fichier). La sortie tourne d'un fichier à l'autre lorsqu'un fichier est plein.
L'utilisation des entrées ci-dessus de logging.properties signifie que les enregistrements de journal et de trace doivent être ajoutés à la fin du fichier applicable et que chaque entrée est stockée en format simple. Les changements du fichier logging.properties sont automatiquement pris en compte et mis en oeuvre en environ 10 secondes par l'application reposant sur l'API CM. L'application n'a pas besoin d'être arrêtée et redémarrée.
Lorsqu'un fichier de sortie journal arrive à saturation (40 Mo), un nouveau fichier est créé et le fichier précédent est renommé pour contenir la date et l'horodatage du roulement, de l'alternance entre les deux fichiers journaux. Chaque fichier contient 40 Mo de données et les nouvelles entrées sont ajoutées aux entrées existantes, y compris après les divers redémarrages de l'application. Lorsque le nombre de fichiers journaux atteint 40, la rotation vers un nouveau fichier entraîne le roulement entraîne la suppression automatique du fichier le plus ancien au profit du plus récent.
Pour de plus amples informations sur la manière de configurer la consignation Java, veuillez vous reporter à la documentation Java sur java.util.logging.Logger et java.util.logging.FileHandler dans votre kit Java Development Kit.
java -Djava.util.logging.config.file=C:\myLogPropsFile.properties votre_programme_java_client_utilisant_l'API_CM
http://<nom_du_serveur> :<numéro-de-port-de-la-console-d'administration>/ibm/consoleoù <nom_du_serveur> est le nom du système CM Server et <numéro-de-port-de-la-console-d'administration> est le numéro de port de la console d'administration (12060 par défaut avec CM Server ou 9060 pour d'autres versions de WebSphere Application Server).
Suivant la version de Websphere Application Server utilisée sur votre système CM Server, il se peut que vous puissiez effectuer des changements en temps réel sans avoir à arrêter et redémarrer CM Server. Sur la plupart des pages de configuration de la consignation sur la console d'administration, il y a deux onglets : un onglet Configuration et un onglet En temps réel.
Depuis la console d'administration, cliquez sur Identification et résolution des incidents->Consignation et traçage et sélectionnez le serveur à configurer dans la liste des serveurs. Sélectionnez Changer le niveau de détail de la consignation et cliquez sur l'onglet En temps réel. Les changements effectués dans l'onglet En temps réel s'appliquent dès que vous enregistrez vos changements. Les changements effectués dans l'onglet Configuration ne s'appliquent pas tant que vous ne redémarrez pas le serveur. Si vous voulez que les changements soient conservés, cochez la case Enregistrer également les changements de la configuration en temps réel. Sélectionnez le lien Components. Notez que la chaîne *=info est indiquée dans la zone. Ouvrez l'option com.ibm.rational.* et sélectionnez com.ibm.rational.stp.*. Sélectionnez le niveau en cliquant sur l'option Niveaux de message et de trace. Cliquez sur OK, puis sur le lien Enregistrer dans la zone Messages située en haut de la page qui s'ouvre. Les changements prennent effet sans redémarrage du serveur.
Si la version ou classe de Websphere Application Server sur votre système CM Server ne comporte pas d'onglet En temps réel permettant les changements de configuration en temps réel, utilisez l'onglet Configuration, puis redémarrez le serveur pour que les changements enregistrés s'appliquent.
Le fichier tslogger.properties comporte des zones étiquetées où des changements peuvent être effectués et qui indiquent l'intervalle de valeurs acceptables. La consignation est activée par défaut sur le niveau INFO. Tous les messages de type INFO, WARNING et SEVERE sont enregistrés dans le fichier journal. Les fichiers journaux peuvent être configurés en éditant le fichier tslogger.properties. Toutefois, le fichier est correctement configuré lors de l'installation et aucun changement n'est nécessaire.
Les paramètres par défaut dans le fichier tslogger.properties sont définis sur des valeurs qui ne devraient pas nécessiter de modifications. Lorsque les fichiers de sortie sont pleins, la sortie passe au fichier suivant. Une fois que le nombre maximum de fichiers en rotation est atteint, le plus ancien fichier est supprimé pour faire de la place pour le fichier suivant du cycle de rotation.