Fichiers journaux pour Rational DOORS et Rational DOORS Web Access

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 Aide > Afficher le journal diagnostic. 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 journalisation
Niveau 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 :

icône des vidéos Regarder des vidéos

Liste de lecture CLM
Chaîne Jazz.net
Chaîne de formation des utilisateurs

icône d'apprentissage En savoir plus

Cercle d'apprentissage CLM
Cercle d'apprentissage Agile
Cercles d'apprentissage

icône de demande Poser des questions

Forum Jazz.net
Forum developerWorks

icône d'aide Obtenir de l'aide

Portail de support
Wiki sur le déploiement
Blogue du support