Generic Log Adapter - Notes sur l'édition

© Copyright International Business Machines Corporation 2000, 2006. All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Problèmes connus et leurs solutions

1.0 Le dernier enregistrement n'est pas traité lorsque Generic Log Adapter s'exécute en continu
1.1 Limitation affectant l'analyse des journaux de WebSphere Application Server sous UNIX
1.2 Limitation affectant l'analyse des journaux d'erreurs de WebSphere MQ sous UNIX
1.3 Problèmes d'analyse des fichiers journaux à l'aide de runregex_showlog_example.bat/sh
1.5 Des éléments de données étendues non valides sont générés
1.7 Informations de journalisation de Generic Log Adapter
1.8 Aucune validation effectuée sur le type de fichier journal
1.9 Limitation affectant l'analyse des fichiers activity.log de WebSphere Application Server
1.10 Limitation affectant les fichiers journaux générés dans un environnement local différent
1.12 L'analyse de fichiers journaux utilisant des symboles de fuseau horaire à trois lettres non uniques peut produire des heures de création incorrectes pour les événements
1.13 Les événements CBE produits par l'analyse d'un journal DB2 Express Diagnostic ne respectent pas la spécification Common Base Event
1.14 Erreur de validation de l'adaptateur lors de l'analyse d'un fichier journal
1.15 Erreurs du formateur lors de l'analyse d'un fichier journal
1.16 Problèmes de configuration lors de l'analyse de journaux

Vous trouverez d'autres informations de dernière minute sur TPTP Generic Log Adapter dans le document TPTP V4.2 release notes.

1.0 Le dernier enregistrement n'est pas traité lorsque Generic Log Adapter s'exécute en continu

Lorsque Generic Log Adapter surveille un fichier journal en continu, il ne traite pas le dernier enregistrement si aucune marque de fin n'est spécifiée. Le dernier enregistrement n'est traité qu'à la fermeture de Generic Log Adapter.

Pour vous assurer que le dernier enregistrement est traité lors de la surveillance, fournissez une marque de fin pour les enregistrements, dans le fichier de configuration de Generic Log Adapter.

1.1 Limitation affectant l'analyse des journaux de WebSphere Application Server sous UNIX

Lors de l'analyse (interprétation) des journaux binaires de service ou d'activité de WebSphere Application Server sur une plateforme UNIX à l'aide de Generic Log Adapter, l'utilisateur doit disposer de droits égaux ou supérieurs à ceux de la personne ayant installé WebSphere Application Server.

Pour contourner cette limitation, avant d'analyser les journaux binaires d'activité ou de service, déplacez-les dans un répertoire accessible avec les mêmes privilèges que ceux de l'utilisateur de Generic Log Adapter.

1.2 Limitation affectant l'analyse des journaux d'erreurs de WebSphere MQ sous UNIX

Lors de l'analyse (interprétation) des journaux d'erreurs de WebSphere MQ sur une plateforme UNIX à l'aide de Generic Log Adapter, l'utilisateur doit disposer de droits égaux ou supérieurs à ceux de la personne ayant installé WebSphere MQ.

Pour contourner cette limitation, avant d'analyser les journaux d'erreurs MQ, déplacez-les dans un répertoire accessible avec les mêmes privilèges que ceux de l'utilisateur de Generic Log Adapter.

1.3 Problèmes d'analyse des fichiers journaux à l'aide de runregex_showlog_example.bat/sh

Lorsque vous essayez d'utiliser le script runregex_showlog_example.bat ou runregex_showlog_example.sh pour analyser un journal d'activité WebSphere Application Server, l'utilitaire showlog de WebSphere Application Server est introuvable.

Pour remédier à cette situation, éditez le fichier regex_showlog_example.adapter dans l'éditeur de règles et mettez à jour l'attribut converter de la propriété sensor afin de le faire pointer sur le répertoire approprié de WebSphere Application Server.

1.5 Des éléments de données étendues non valides sont générés

Generic Log Adapter génère un élément CBE (Common Base Event) extendedDataElement non valide pour un enregistrement de journal s'il n'existe aucune règle correspondant à la valeur de l'attribut name ou type. L'élément extendedDataElement ne doit normalement pas être généré si aucun nom ou type n'est tiré de l'analyse de l'enregistrement de journal, mais Generic Log Adapter en génère quand même un avec le champ value uniquement.

Pour éviter cette situation, assurez-vous que des règles spécifiant la vérification des trois champs (name, value et type) de l'élément extendedDataElement ont bien été fournies.

1.7 Informations de journalisation de Generic Log Adapter

Lorsque Generic Log Adapter est exécuté indépendamment, c'est-à-dire en dehors de tout environnement Eclipse, il consigne les messages et les erreurs dans un fichier appelé hgla.log, stocké dans le répertoire de travail courant. S'il existe déjà un fichier hgla.log dans le répertoire de travail courant, un nouveau fichier journal est créé avec un nom de la forme hgla.nnnnnnnn.log (où nnnnnnnn est un numéro unique). Lorsque Generic Log Adapter est exécuté dans le cadre d'une opération d'importation de journal, les messages d'erreur qu'il consigne sont affichées dans une fenêtre d'erreurs, dans l'outil Log and Trace Analyzer (analyseur de journaux et de traces).

En cas d'exécution à l'intérieur d'un environnement Eclipse, dans la perspective Adaptateur de journal générique, les messages et les erreurs consignés par Generic Log Adapter sont listés dans la vue Erreurs.

Generic Log Adapter consigne les événements avec les niveaux de journalisation 5, 10, 20, 30, 50 et 60, selon la valeur attribuée à loggingLevel pour les contextes et les composants dans le fichier de configuration de l'adaptateur (.adapter). Vous pouvez importer le fichier hgla.log en tant que fichier de type CBE XML dans l'outil Log and Trace Analyzer (analyseur de journaux et de traces) afin de diagnostiquer les problèmes rencontrés par Generic Log Adapter lors de l'interprétation du fichier journal.

1.8 Aucune validation effectuée sur le type de fichier journal

Aucune validation n'est effectuée par Generic Log Adapter pour déterminer si le type de fichier journal analysé correspond à la configuration du fichier de l'adaptateur (.adapter).Par exemple, si le type du fichier journal spécifié dans la configuration du détecteur (sensor), dans le fichier de l'adaptateur, ne correspond pas à celui attendu par la configuration de l'extracteur et les règles de substitution dans la configuration de l'analyseur syntaxique, vous pouvez obtenir des résultats imprévisibles.L'analyse syntaxique peut aboutir sans générer d'erreurs, mais les données CBE (Common Base Event) résultantes seront incorrectes.L'analyse syntaxique peut échouer avec des messages d'erreur indiquant que des données incorrectes ont été détectées.

Pour résoudre cet incident, assurez-vous que le type du fichier journal spécifié dans la configuration du composant détecteur est correct.

1.9 Limitation affectant l'analyse des fichiers activity.log de WebSphere Application Server

Lors de l'analyse syntaxique des fichiers journaux binaires d'activité de WebSphere Application Server sur des machines non anglaises à l'aide de runregex_showlog_example.bat/sh, les données d'enregistrement des journaux ne sont pas mappées correctement vers un événement CBE (Common Base Event).Certaines données d'enregistrement des journaux peuvent apparaître dans le champ incorrect de l'événement CBE (Common Base Event).

1.10 Limitation affectant l'analyse des fichiers journaux générés dans un environnement local différent

Lors de l'analyse syntaxique de fichiers journaux contenant des horodatages dans un environnement local différent de celui dans lequel est exécuté Generic Log Adapter, à l'aide d'un fichier d'adaptateur basé sur des règles configuré pour utiliser l'attribut Format de l'heure dans la règle de substitution de creationTime, l'horodatage et les autres données d'enregistrement des journaux risquent de pas être analysés correctement. Par exemple, dans les événements CBE résultants, les valeurs creationTime peuvent être zéro et le champ msg peut être vide.

Pour éviter cette situation, assurez-vous que les valeurs des attributs de code de langue ISO et de code pays ISO de l'élément ContextInstance, dans le fichier .adapter à base de règles, correspondent à l'environnement local des horodatages figurant dans le fichier journal à analyser.

1.12 L'analyse de fichiers journaux utilisant des symboles de fuseau horaire à trois lettres non uniques peut produire des heures de création incorrectes pour les événements

Lorsque vous utilisez Generic Log Adapter pour convertir au format CBE des fichiers journaux utilisant des symboles de fuseau horaire de trois lettres, les heures de création des événements peuvent être incorrectes si ces symboles ne sont pas uniques. Par exemple, le symbole "IST" peut être interprété comme "Israeli Standard Time" (heure standard d'Israël), "Iran Standard Time" (heure standard d'Iran) ou "Irish Summer Time" (heure d'été d'Irlande).

1.13 Les événements CBE produits par l'analyse d'un journal DB2 Express Diagnostic ne respectent pas la spécification Common Base Event

Si vous analysez un fichier journal IBM(R) DB2(R) Express Diagnostic avec les adaptateurs se trouvant dans %GLA_Install%\GenericLogAdapter\config\DB2\diag\tool, les événements CBE générés et écrits dans le fichier de sortie peuvent ne pas respecter entièrement la spécification Common Base Event. La raison est un bogue dans l'utilitaire db2diag.exe servant à convertir les journaux de diagnostic DB2 en événements CBE. Exception faite de ce défaut, l'opération d'analyse n'est pas entravée. Il n'existe pas de solution connue tant que db2diag.exe n'est pas corrigé.

1.14 Erreur de validation de l'adaptateur lors de l'analyse d'un fichier journal

L'analyse d'un fichier journal avec un fichier adaptateur créé dans une version précédente de l'éditeur de configuration d'adaptateur peut entraîner l'écriture du message d'erreur suivant dans le fichier journal de Generic Log Adapter, hgla.log :

IWAT0383E Erreur lors de la validation de l'adaptateur : cvc-complex-type.4 : L'attribut 
'lineBreakSymbol' doit apparaître dans l'élément 'ex:Extractor'.

Les anciennes versions de l'éditeur de configuration d'adaptateur créaient les fichiers adaptateur sans inclure l'attribut lineBreakSymbol dans l'élément Extractor. Or, cet attribut doit figurer dans l'élément Extractor, même si sa valeur est vide. Désormais, avant d'utiliser un fichier adaptateur, Generic Log Adapter contrôle sa validité en le confrontant au schéma Generic Log Adapter. Dans ce schéma, lineBreakSymbol est déclaré comme attribut requis.

Pour contourner ce problème, ouvrez le fichier adaptateur dans l'éditeur de configuration d'adaptateur, ajoutez une valeur non vide au champ lineBreakSymbol de l'élément Extractor et enregistrez le fichier. Ensuite, supprimez cette valeur si elle n'est pas nécessaire et enregistrez à nouveau le fichier. Celui-ci contiendra l'attribut lineBreakSymbol dans l'élément Extractor.

1.15 Erreurs du formateur lors de l'analyse d'un fichier journal

L'analyse d'un fichier journal avec un fichier adaptateur créé dans une version précédente de l'éditeur de configuration d'adaptateur peut entraîner l'écriture de messages d'erreur tels que le suivant dans le fichier journal de Generic Log Adapter, hgla.log :

IWAT0438E La classe Formatter CBE (Common Base Event) N76D20B0042411D98000E0362B33D6F0 ne peut pas créer
de propriété CommmonBaseEvent car la propriété requise sourceComponentId est manquante.

Ce message indique que le composant formateur de Generic Log Adapter n'a pas pu créer d'événement CBE, car il manque la propriété sourceComponentId alors qu'elle est requise par la spécification Common Base Event. Generic Log Adapter vérifie désormais que toutes les propriétés requises sont présentes dans l'événement CBE. S'il en manque, il ne renvoie pas d'événement formaté. Il est possible que le fichier adaptateur ne contienne pas de règles d'analyse des propriétés indiquées dans ce type de message ou qu'il en contienne mais qu'elles soient incorrectes.

Pour remédier à cette situation, ajoutez au fichier adaptateur des règles d'analyse des propriétés manquantes ou vérifiez que les règles existantes sont correctes.

1.16 Problèmes de configuration lors de l'analyse de journaux

Lors de l'analyse de journaux, les messages d'erreur suivants peuvent s'afficher dans la console :

Pour corriger ce problème, apportez les modifications suivantes à l'option -classpath dans le fichier script d'exécution gla.bat ou gla.sh (selon la plateforme) :