Consignation de messages d'application dans IBM Rational DOORS

Dans IBM® Rational DOORS, vous pouvez utiliser des messages d'application afin de contrôler les journaux de diagnostic pour l'identification des incidents.

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 modes de consignation, répertoriés ici du plus faible au plus élevé : Débogage, Info, Avertissement, Erreur et Fatal. Chaque niveau consignera des informations pour ce niveau et tous les niveaux supérieurs. Par exemple, le niveau d'avertissement comprend des informations provenant des modes Avertissement, Erreur et Fatal.

Le serveur de base de données Rational DOORS prend toujours en charge le type de consignation précédent, que vous pouvez activer grâce au commutateur de ligne de commande -logfile . Pour plus d'informations, voir Commutateurs de ligne de commande pour le serveur de base de données.

Les informations qui sont transmises aux fichiers journaux sont contrôlées par un fichier de configuration basé XML. Deux fichiers de configuration sont fournis :

Par défaut, ces fichiers se trouvent dans la racine Rational DOORS ; par exemple, C:\Program Files\IBM\Rational\DOORS\9.version.

Le fichier de configuration .xml

Les paramètres qui contrôlent la consignation de messages d'application se trouvent dans deux sections du fichier de configuration :
  • Les paramètres d'ajout fournissent des paramètres pour le chemin du fichier, le niveau de journalisation, la taille de fichier maximum, l'index de sauvegarde maximum et le format pour chacun des fichiers journaux.
  • Les paramètres du consignateur fournissent les paramètres pour le mode de consignation global et un ensemble d'ajouts qui peuvent être activés pour la consignation.
Tableau 1. Paramètres d'ajout
Nom Description Valeur
appender name Ce paramètre est le nom de l'ajout qui est utilisé pour décrire quels ajouts sont activés. Tout élément ; par exemple, SystemOutAppender
file Cette valeur de paramètre indique le nom et l'emplacement d'un fichier journal créé. Un emplacement accessible sur votre système ; par exemple, C:\IBM\DOORS\log\SystemError.log
append Si ce paramètre est défini sur true, les informations sont ajoutées au fichier mentionné dans le paramètre de fichier. Si ce paramètre est défini sur false, le fichier mentionné dans le paramètre de fichier est écrasé. true ou false
Threshold Ce paramètre définit le mode de consignation. off, fatal, error, warn, info ou debug (désactivé, fatal, erreur, avertissement, information ou débogage)
Si le seuil est défini sur fatal, seules les informations fatales sont consignées dans le fichier journal. fatal
Si le seuil est défini sur erreur, les informations fatales et d'erreur sont consignées dans le fichier journal. erreur
Si le seuil est défini sur avertissement, les informations fatal, erreur et avertissement sont consignées dans le fichier journal. avertissement
Si le seuil est défini sur info, les messages fatal, erreur, avertissement et information sont consignés dans le fichier journal. info
Si le seuil est défini sur débogage, toutes les informations sont consignées dans le fichier journal. débogage
Si le seuil est défini sur désactivé, la consignation est désactivée. désactivé
MaxFileSize Ce paramètre définit la taille maximale du fichier journal. Lorsque le fichier journal atteint sa taille maximale, un autre fichier journal est créé. Le nom du nouveau fichier comprend le nombre incrémentiel. Tout élément avec une unité ; par exemple, 1 000 ko.
MaxBackupIndex Ce paramètre définit le nombre maximal de fichiers qui sont créés pour le consignateur. Une fois le nombre maximum atteint, les fichiers sont écrasés, à commencer par le plus ancien. Tout entier.
Conversion Pattern Ce paramètre spécifie le format dans lequel les informations sont consignées dans le fichier journal. Vous pouvez inclure la date et l'heure, le mode du journal et un récapitulatif des informations qui sont consignées. Vous pouvez modifier la séquence selon le besoin. Cette valeur commence par la date : %d{dd MMM yyyy HH:mm:ss:SSS} [%p] %m%n
Cette valeur commence par le mode de consignation : [%p] %m%n %d{dd MMM yyyy HH:mm:ss:SSS}
Tableau 2. Paramètres de consignateur
Nom du paramètre Description Valeur
priority Ce paramètre définir le niveau de mode de journalisation pour la journalisation globale. Le paramètre par défaut est égal à "all". Pour désactiver la consignation, définissez cette valeur de paramètre sur "off". all, debug error, fatal, info, off ou warn (tout, erreur de débogage, fatal, information, désactivé ou avertissement)
appender-ref La valeur de référence contient le nom des ajouts que vous avez définis dans les sections d'ajout. Selon les ajouts devant être activés pour la consignation, vous devez fournir les noms des ajouts. <appender-ref ref="DOORSConsoleAppender"/>
Pour activer plusieurs ajouts, créez plusieurs instances de la balise <appender-ref>. <appender-ref ref="SystemOutAppender"/>

Vos commentaires