Fichiers journaux pour DOORS et DWA

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® Engineering Requirements Management DOORS (DOORS), le client et le serveur d'interopérabilité, et sur le serveur IBM Engineering Requirements Management DOORS - Web Access (DWA) 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 DWA, 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 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 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 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 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 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 DOORS.

Journalisation pour le serveur d'interopérabilité DOORS et le serveur DWA et le courtier de messages

Par défaut, les composants DWA 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é DOORS et le serveur DWA 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 DWA. 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 DWA.
  • 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 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 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 Vidéo

Chaîne Jazz.net
Canal Software Education

icône d'apprentissage Cours

IoT Academy
Skills Gateway

icône de demande Communauté

Jazz.net
Forums Jazz.net
Bibliothèque Jazz.net

icône d'aide Support

Communauté de support IBM
Wiki sur le déploiement