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
- Journal des transactions du serveur de base de données
- Journal des transactions du client
- Journaux du serveur Rational
DOORS Web
Access, du serveur d'interopérabilité et du courtier de messages
- Journaux des 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 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 et désactivez la journalisation, comme décrit dans la
rubrique d'aide
Activation d'un journal des transactions dans le serveur de base de données Rational DOORS.
Remarque : Pour éviter une dégradation des performances, n'activez la journalisation de la base de
données que pour des périodes de diagnostic limitées.
Journalisation client pour Rational
DOORS
Vous pouvez activer la journalisation pour résoudre des problèmes de connexion sur le serveur
de base de données. Le journal ne contient pas de données de module ou d'objet qui peuvent
contenir des informations sensibles au contenu ; il contient uniquement les détails de transaction du fichier. 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. Une fois que vous avez reproduit le comportement, envoyez le fichier journal généré au service et désactivez la journalisation, comme décrit dans la rubrique d'aide Activation d'un journal des transactions dans le client 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 élevé. Pour inclure plus de détails, autorisez les composants à fonctionner au niveau de débogage.
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
Pour générer des informations détaillées avec la journalisation au niveau débogage, consultez les liens connexes de la journalisation de 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 permet de vérifier que les demandes ont été reçues. Ce journal est utile pour diagnostiquer les processus qui s'étendent sur plusieurs
applications.
- response.log permet de confirmer que les réponses ont été renvoyées à
l'application appelante. Ce journal est utile pour confirmer que la demande reçue
est terminée et qu'elle a renvoyé un résultat.
Les messages d'erreur sont écrits dans différents fichiers journaux selon leur origine. La plupart des erreurs sont écrites dans
exception.log, mais les
autres fichiers journaux d'erreurs peuvent également être utilisés. Les trois fichiers journaux d'erreurs
sont les suivants :
- 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 effectuer ces tâches sans redémarrer le serveur :
- Limitation de la taille du fichier journal
- Configuration du nettoyage automatique des anciens fichiers
- Choix du format des fichiers des journaux de sortie
- Modification du niveau de consignation et des configurations de consignation
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 de traitement des
incidents 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 trois 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 un enregistrement des informations automatiquement
collectées sur le système d'exploitation, des informations de produit Rational
DOORS, des fichiers de bibliothèque associés dynamiques
(.DLL) et du 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 :