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
  • 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 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 logiciel IBM 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 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 DOORS
Remarque : 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
Remarque : Le journal ne contient pas de données de module ou d'objet qui peuvent être des informations sensibles au contenu ; il contient uniquement les détails de transaction du fichier. Si la sécurité DXL est activée, vous devez être un utilisateur avec des droits pour éditer et exécuter le DXL.../../com.ibm.doors.configuring.doc/topics/t_setupdxlsecurity.html#t_setupdxlsecurity

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 :

Vos commentaires