Vous pouvez utiliser les fichiers journaux pour identifier et résoudre des incidents qui se produisent sur le
serveur de base de données IBM® Rational DOORS, le client et le serveur d'interopérabilité, et sur le serveur Rational DOORS Web
Access et le courtier de messages.
En fonction de votre configuration, ces outils de journalisation sont disponibles pour diagnostiquer
un comportement inattendu :
- Journal de diagnostic pour le client
- Journalisation de transaction du serveur de base de données
- Journalisation de transaction client
- Journalisation du serveur d'accès Web Rational DOORS, du serveur d'interopérabilité et du courtier de messages
- Journalisation de messages d'application et utilitaire de collecte de données
Journal de diagnostic pour le client Rational DOORS
Le client dispose d'un mécanisme de journalisation intégré qui enregistre
tous les événements inhabituels qui se produisent à la suite d'une erreur
interne pendant votre session. Pour afficher le journal
de diagnostic, cliquez sur . Si nécessaire, vous pouvez copier
les informations de la fenêtre de sortie et les enregistrer
en tant que fichier texte local.
Pour enregistrer un journal plus
détaillé, vous pouvez également activer une journalisation supplémentaire basée sur les transactions,
sur le serveur de client et de base de données. Pour plus d'informations, voir les
sections suivantes.
Journalisation de serveur de base de données pour Rational DOORS
Le serveur de base de données fournit une fonction de journalisation qui peut enregistrer l'activité à
différents niveaux de détail. Par défaut, cette journalisation n'est pas activée, car elle peut augmenter
l'utilisation du processeur pour les transactions et ralentir la vitesse pour effectuer une fonction demandée, ou
dégrader les performances globales. Les détails du journal sortant s'appuient sur la valeur de niveau
de journalisation que vous définissez. Les valeurs ton du niveau 1, le plus concis, au niveau 6, le plus
prolixe. Avant d'activer la journalisation du serveur, consultez le service de support logiciel IBM pour déterminer
quel niveau est nécessaire pour résoudre le problème.
Tableau 1. Niveaux de journalisationNiveau de journalisation |
Détails des informations de journal |
1 |
Connexions, déconnexions et paquets
de problèmes |
2 |
Connexions, déconnexions et types de paquets |
3 |
Connexions, déconnexions, types de paquets et arguments
de paquet dans un format compact |
4 |
Connexions, déconnexions, types de paquet et arguments
de paquet au format prolixe |
5 |
Seules les opérations de cache de données |
6 |
Connexions, déconnexions, opérations de cache de données,
types de paquets et arguments de paquets au format
prolixe |
Pour vous aider à identifier une erreur non spécifiée, vous devriez démarrer la journalisation au niveau 6 pour
capturer toutes les activités. Une fois la journalisation de la base de données activée et lorsque vous pouvez reproduire le comportement, envoyez
le fichier journal généré au service de support logiciel IBM et désactiver la journalisation, comme décrit dans la
rubrique d'aide de journalisation du serveur.
Activation de la journalisation de transaction dans le serveur de base de données Rational DOORSRemarque : Activez la journalisation de base de données pour des périodes de diagnostic
limitées uniquement. Pour désactiver la journalisation dans arrêter votre serveur, définissez la valeur
du niveau de journalisation sur 0 en utilisant la commande dbadmin -serverlogging ; par
exemple, dbadmin -d 36677@IBMEDSERV -serverlogging 0.
Journalisation client pour Rational DOORS
Vous pouvez activer une capacité de journalisation pour résoudre des problèmes de connexion sur le serveur
de base de données. Depuis l'ordinateur présentant le problème, ouvrez le client
Rational DOORS et exécutez une commande DXL pour activer la journalisation de client et générer un fichier de journal local. Lorsque
vous reproduisez le comportement, envoyez le fichier journal généré au service de support logiciel IBM et désactivez
la journalisation tel que décrit dans la rubrique d'aide de journalisation du client.
Activation de la journalisation de transaction dans le client Rational DOORS Rational DOORS
Journalisation pour le serveur d'interopérabilité Rational DOORS et le serveur Rational DOORS Web Access et le courtier de messages
Par défaut, les composants Rational DOORS Web Access fournissent des enregistrements de journal au niveau Information. Au niveau Information, les enregistrements de journal contiennent des message d'information qui décrivent la progression de l'application à un niveau supérieur.
Pour diagnostiquer les problèmes avec votre installation, vous pouvez activer des composants à exécuter en mode de débogage.
Au niveau du débogage, les enregistrements du journal contiennent des événements d'informations plus détaillés qui sont
utiles pour déboguer une application.
Le serveur d'interopérabilité
Rational DOORS et le serveur
Rational DOORS Web Access et le courtier de messages fournissent des enregistrements de journal de niveau Information dans ces répertoires :
- DWA_INSTALL_DIR\broker\data\activemq.log
- DWA_INSTALL_DIR\server\festival\logs
Si vous avez besoin d'informations plus détaillées pour diagnostiquer des problèmes, activez la journalisation de niveau
Débogage. Pour configurer la journalisation étendue, consultez les liens connexes pour Rational DOORS Web
Access. Il existe plusieurs fichiers journaux dans le répertoire de journaux.
Pour diagnostiquer un problème,
commencez par ces fichiers :- festival.log contient tous les messages de journal écrits par le serveur
Rational DOORS Web Access.
- request.log est utilisé pour vérifier que les requêtes sont bien reçues.
Cette fonction est utile lors du traitement de processus qui s'étendent sur plusieurs applications.
- response.log est utilisé pour confirmer que les réponses ont été renvoyées à
l'application appelante. Cette fonction est utile pour confirmer que la requête reçue
a terminé et renvoyé un résultat.
Les messages d'erreur sont écrits dans différents journaux selon leur origine.
La plupart des erreurs sont écrites dans exception.log, mais les autres fichiers journaux des erreurs peuvent également être utilisés.
Il existe 3 fichiers journaux des erreurs :- exception.log
- error_view.log
- error_misc.log
Journalisation de messages d'application et utilitaire de collecteur de données
La version 9.4 introduit la consignation des messages d'application qui est basée sur les services de consignation
Apache log4cxx. Vous pouvez limiter la taille du fichier journal, configurer la suppression automatique des anciens
fichiers, sélectionner le format des fichiers journaux de sortie et modifier le niveau de consignation et les configurations
de consignation sans redémarrer le serveur. Le fichier de configuration est surveillé toutes
les 60 secondes pour détecter les modifications.
Il existe cinq niveau de journalisation, répertoriés du plus bas au plus haut : Debug, Info, Warn,
Error et Fatal (Débogage, Info, Avertissement, Erreur et Fatal). Chaque niveau journalise des informations pour ce niveau et tous les niveaux supérieurs. Par
exemple, le niveau Avertissement inclut des informations des modes Avertissement, Erreur et Fatal.
Les versions antérieures de
Rational DOORS nécessitaient un rassemblement itératif manuel des informations de l'environnement et des ressources, ainsi que des
journaux de diagnostic au cours de la phase d'identification et résolution des problèmes initiale. Grâce à l'introduction de
la messagerie d'application dans la version 9.4, vous pouvez exécuter un outil de collecte de données de ligne de commande pour
collecter des journaux générés selon les instructions de configuration de
messagerie d'application. L'outil de collecte de données crée également 3 fichiers texte :
- readme.txt fournit des indications sur l'utilisation lorsque le problème
se produit.
- problemDetails.txt est un fichier modèle dans lequel vous pouvez entrer
manuellement des détails de problèmes.
- collectedInformation.txt est l'enregistrement des informations automatiquement
collectées sur le système d'exploitation, les informations de produit Rational DOORS, les fichiers de bibliothèque associés dynamiques
(.DLL) et le fichier config.ini.
Pour plus d'informations sur la configuration des fichiers journaux, consultez ces rubriques :
- Journalisation dans Rational DOORS :
- Journalisation dans Rational DOORS Web Access :