Vous trouverez des informations supplémentaires relatives à TPTP Generic Log Adapter dans les notes sur l'édition de TPTP V3.3.
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é que si Generic Log Adapter s'arrête.
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.
Lors de l'analyse syntaxique des journaux binaires de service ou d'activité de WebSphere Application Server sur des plateformes 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 remédier à cette limitation, déplacez le journal de service ou d'activité dans un répertoire dont les droits sont identiques à ceux de l'utilisateur de Generic Log Adapter, avant d'analyser le journal.
Lors de l'analyse syntaxique des journaux d'erreurs de WebSphere MQ sur des plateformes 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 remédier à cette limitation, déplacez les journaux d'erreurs MQ dans un répertoire dont les droits sont identiques à ceux de l'utilisateur de Generic Log Adapter, avant d'analyser les journaux.
Lorsque vous essayez d'utiliser les fichiers runregex_showlog_example.bat et runregex_showlog_example.sh pour analyser un journal d'activité WebSphere Application Server, l'utilitaire showlog de l'application WebSphere est introuvable.
Pour résoudre cet incident, éditez le fichier regex_showlog_example.adapter dans l'éditeur de règle et mettez à jour la propriété Converter du détecteur pour qu'elle fasse référence à l'emplacement de répertoire approprié de WebSphere Application Server.
L'analyse syntaxique de certains journaux génère des informations de fuseau horaire incorrectes.
Seuls les fichiers journaux dont les horodatages contiennent des informations de fuseau horaire génèrent des données analysées pour lesquelles les valeurs creationTime utilisent le fuseau horaire approprié. Si les horodatages des fichiers journaux ne contiennent pas d'informations de fuseau horaire, Generic Log Adapter génère les valeurs creationTime avec des informations de fuseau horaire incorrectes.
Generic Log Adapter génère un élément CBE (Common Base Event) extendedDataElements non valide pour un enregistrement de journal s'il n'existe aucune règle correspondant à la valeur du nom ou du type. L'élément extendedDataElement ne doit pas être généré si aucun nom ou type n'est analysé à partir de l'enregistrement de journal, mais Generic Log Adapter en génère un avec la zone valeur uniquement.
Pour résoudre cet incident, assurez-vous que des règles spécifiant la vérification des trois zones (nom, valeur et type) de l'élément extendedDataElement ont bien été fournies.
La décompression des fichiers runtime.zip et rules.zip sous z/OS à l'aide de la commande unzip génère parfois des fichiers de script illisibles.
Pour éviter cela, suivez bien la procédure ci-après lors de la décompression des fichiers runtime.zip et rules.zip sur un système z/OS à l'aide de la commande unzip.
unzip -a runtime.zip unzip -a rules.zip unzip -o rules.zip *.adapter unzip -o runtime.zip *.xsd
Lorsque Generic Log Adapter est exécuté en dehors d'un environnement Eclipse, il consigne les messages et les erreurs dans le fichier hgla.log. Lors d'une exécution en mode autonome, le fichier hgla.log est créé dans le répertoire de travail en cours. Lors d'une exécution dans le cadre d'une opération d'importation de journaux éloignés à l'aide de l'analyseur de trace et de journaux, le fichier hgla.log se trouve sur le système éloigné, dans le répertoire temporaire indiqué par la variable SYS_TEMP_DIR dans le fichier de configuration d'Agent Controller serviceconfig.xml. Par exemple, le fichier hgla.log se trouve dans le répertoire /tmp ou /var/tmp sur un système UNIX ou Linux, ou dansc:\Documents and Settings\ID_utilisateur\Local Settings\Temp sous Windows.
Lors d'une exécution dans un environnement Eclipse (par exemple, dans le cadre d'une opération d'importation des journaux locaux à l'aide de l'analyseur de trace et de journaux, Generic Log Adapter consigne des messages et des erreurs dans le fichier hgla.log, dans le répertoire .metadata\.plugins\org.eclipse.hyades.logging.adapter sous celui de travail d'Eclipse.
Generic Log Adapter consigne des événements avec les niveaux de journalisation 10, 20, 30, 50 et 60. Le fichier hgla.log ne peut pas être importé dans l'analyseur de trace et de journaux pour diagnostiquer les incidents rencontrés par Generic Log Adapter lors de l'analyse syntaxique du 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 d'adaptateur.Par exemple, si le type du fichier journal spécifié dans la configuration du détecteur du fichier d'adaptateur ne correspond pas à celui attendu par la configuration de l'extracteur et les règles de substitution de 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.
Lors de l'analyse syntaxique des fichiers journaux 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).Au lieu de cela, des données d'enregistrement des journaux peuvent apparaître dans la zone incorrecte de l'événement CBE (Common Base Event).
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, lors de l'analyse d'un fichier journal des accès d'un serveur IBM HTTP Server en anglais sur une machine japonaise à l'aide du fichier config\IHS\access\v1.3.19.3\runregex_example.bat/sh, les valeurs creationTime des événements CBE (Common Base Events) résultants sont égales à zéro et la zone msg de ces événements est vide.
Pour résoudre cet incident, modifiez le fichier runregex_example.bat/sh en ajoutant les paramètres JVM suivants à la commande java :
-Duser.language=code-langue-à-2-car -Duser.region=code-pays-à-2-car
Les codes de langue et de pays correspondent à ceux de l'environnement local des horodatages.Pour l'exemple mentionné, les paramètres JVM sont les suivants :
-Duser.language=en -Duser.region=US
Vous pouvez également modifier le fichier de l'adaptateur basé sur les règles en indiquant les codes de langue et de pays pour l'environnement local d'horodatage dans les attributs Instance de contexte associés.
Lors de l'installation de Generic Log Adapter sous Windows XP, des incidents se produisent lors de la décompression du fichier rules.zip de Generic Log Adapter à l'aide de l'utilitaire unzip natif de Windows XP.Certains répertoires et fichiers ne sont pas décompressés.Certains types de fichier journal ne peuvent donc pas être analysés à l'aide de Generic Log Adapter. Pour remédier à cet incident, lors de l'installation sous Windows XP, utilisez un autre utilitaire unzip, tel que WinZip ou UnZip.
Avec l'analyse syntaxique en continu du journal d'activité d'IBM WebSphere Application Server et des fichiers journaux d'erreurs d'IBM HTTP Server à l'aide de l'analyseur statique correspondant, des enregistrements sont parfois manquants dans la sortie analysée. Plus précisément, lorsque de nouveaux enregistrements sont ajoutés au fichier journal, le premier n'est pas analysé et n'est donc pas intégré à la sortie analysée. Cet incident se produit lorsque l'instance de contexte est configurée avec continuousOperation="true" dans le fichier de configuration d'adaptateur de l'analyseur statique pour les journaux. Comme solution palliative, analysez le fichier journal en configurant l'instance de contexte avec continuousOperation="false" ou servez-vous de l'adaptateur basé sur les règles pour un contrôle continu.
Lors de la conversion de fichiers journaux utilisant des symboles de fuseau horaire de trois lettres au format CBE avec l'adaptateur de journaux, vous pouvez obtenir des heures de création 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).
Retour au fichier Readme principal
©Copyright IBM Corporation 2000, 2005. All Rights Reserved.