Analyseur de trace et de journaux version 6.0.1 - Fichier README

Incidents identifiés et solutions palliatives

1.0 Analyseur de trace et de journaux
1.1 Vues
1.2 Importation des journaux
1.2.1 Erreurs lors de l'importation de fichiers journaux distants
1.2.2 Importation des fichiers journaux sous Linux et AIX
1.2.3 Importation du fichier journal trace.log de WebSphere Application Server
1.2.4 Impossible d'importer certains fichiers journaux à l'aide d'IBM Agent Controller version 5
1.2.5 Exception liée à une quantité de mémoire insuffisante
1.2.6 Index hors de la plage autorisée lors de l'ajout du fichier journal dans l'assistant d'importation des fichiers journaux avec le pilote Linux GTK Linux
1.2.7 Les événements CBE (Common Base Events) affichés pour le journal de diagnostic DB2 ne respectent pas la spécification
1.2.8 Les erreurs liées à l'importation des fichiers journaux ne s'affichent pas
1.2.9 Limitation pour l'importation des fichiers activity.log de WebSphere Application Server
1.2.10 Limitation pour l'importation des fichiers journaux générés dans un environnement local différent
1.2.11 Echec de l'importation avec le message d'exception InvocationTargetException
1.2.12 Exception NullPointerException pendant l'importation d'un journal vide
1.3 Support de base de données
1.4 Autres
1.4.1 L'assistant de création d'une corrélation de journal ne s'affiche pas correctement avec un pilote Linux GTK
1.4.2 Les modifications apportées au niveau de journalisation du plug-in après le premier démarrage du plan de travail ne sont pas prises en compte
1.4.3 Erreurs lors de la décompression à l'aide de l'utilitaire unzip de Windows XP
1.4.4 Arrêt brutal du logiciel lors de la création d'un exemple sous Red Hat Linux version 8.0 avec la machine virtuelle Java IBM
1.4.5 Restriction du navigateur pour afficher les fichiers journaux XMLCommon Logging
1.4.6 Seules les bases de données de symptômes au format TPTP peuvent être créées à partir de la barre d'outils et le menu en incrustation Navigateur de journaux
2.0 Outil de profilage
2.1 Les vues Interactions d'agents et Interactions de processus ne sont pas prises en charge par la vue Diagramme de séquences
2.2 L'option Régénérer les vues du navigateur de profilage ne fonctionne pas pour les interactions de trace
2.3 Le profilage sous Windows avec Sun JDK 1.4.x peut se terminer par un rapport d'erreurs Microsoft

Des informations complémentaires associées à l'analyseur de trace et de journaux sont disponibles dans les notes sur l'édition TPTP version 3.3.


1.0 Analyseur de trace et de journaux

1.1 Vues

N/A

1.2 Importation des journaux

1.2.1 Erreurs lors de l'importation de fichiers journaux distants

Lorsque vous importez un fichier journal distant (Fichier > Importer... > Fichier journal), aucune entrée de journal n'apparaît dans la vue Journal après l'actualisation des vues Moniteur de profilage (Profilage > Régénérer la vue) ou une boîte de dialogue Message de consignation s'affiche pour indiquer que le client local n'a pas commencé à surveiller l'analyseur syntaxique du journal distant à l'issue du délai de 30 secondes.

Cette erreur est due à un retard du réseau et peut être résolue en augmentant le délai d'attente du composant Agent Controller, à l'issue duquel le client local doit commencer à surveiller l'analyseur syntaxique du journal distant. Pour résoudre cette erreur, procédez comme suit :

  1. Essayez d'importer le fichier journal une nouvelle fois.
  2. Si l'erreur persiste, ajoutez l'entrée suivante à l'application distante RemoteLogParserLoader dans le fichier de configuration du composant Agent Controller (c'est-à-dire <répertoire d'installation du composant Agent Controller>/plugins/com.ibm.etools.logging.parsers/config/pluginconfig.xml) :
      
    <Application configuration="default" executable="RemoteLogParserLoader"
    extends="default" location="%SYS_TEMP_DIR%" path="%JAVA_PATH%">
    ...
    <Parameter position="prepend"
    value="-Dorg.eclipse.hyades.logging.parsers.maxWaitTimeInMillis=xxxxx"/>
    ...
    </Application>
    
    où xxxxx est le délai d'attente maximal en millisecondes (par exemple, supérieur à 30000).
  3. Une fois la modification effectuée, redémarrez le composant Agent Controller et essayez une nouvelle fois d'importer le fichier journal.

1.2.2 Importation des fichiers journaux sous Linux et AIX

Certaines importations de fichiers journaux échouent sous Linux et AIX.

Cet incident se produit lorsque l'utilisateur ne possède pas les droits appropriés pour accéder aux fichiers journaux. Pour résoudre l'erreur, copiez les fichiers journaux dans le répertoire principal de l'utilisateur et importez-les à partir de cet emplacement.

1.2.3 Importation du fichier journal trace.log de WebSphere Application Server

Une corrélation interne est créée pendant l'importation du fichier trace.log de WebSphere Application Server.

Vous ne devez pas supprimer ces corrélations car elles contiennent des informations sur la structure interne de l'agent correspondant.

1.2.4 Impossible d'importer des fichiers journaux à l'aide d'IBM Agent Controller version 5

A l'exception du fichier activity.log, les fichiers journaux distants ne peuvent pas être importés à l'aide d'IBM Agent Controller version 5. Lorsque vous importez des fichiers journaux à distance, le composant Agent Controller du système éloigné doit se trouver à un niveau identique ou supérieur à celui de Log and Trace Analyzer for Autonomic Computing.

Pour éviter cette limitation, installez le composant IBM Agent Controller fourni avec l'analyseur de trace et de journaux sur le système distant.

1.2.5 Exception liée à une quantité de mémoire insuffisante

Vous pouvez importer les fichiers journaux dont la taille peut atteindre 25 Mo dans l'espace de travail et les ouvrir dans l'analyseur de trace et de journaux. Le délai nécessaire pour ouvrir le fichier journal varie en fonction du nombre d'enregistrements dans le fichier. Une exception indiquant que la quantité de mémoire est insuffisante peut être générée.

Pour résoudre ce problème, utilisez la fonction de prise en charge des journaux volumineux.

1.2.6 Index hors de la plage autorisée pendant l'ajout du fichier journal dans l'assistant d'importation des fichiers journaux avec le pilote Linux GTK

Pendant l'importation d'un fichier journal, une erreur indiquant que l'index n'est pas dans la plage autorisée est générée lorsque vous tentez de cliquer sur OK dans l'assistant Ajout d'un fichier journal. Cette erreur se produit car la version du fichier journal ajouté n'a pas été sélectionnée.

Vérifiez qu'une version valide est sélectionnée dans la liste déroulante de l'onglet Détails de l'assistant Ajout d'un fichier journal.

1.2.7 Les événements CBE (Common Base Events) affichés pour le journal de diagnostic DB2 ne respectent pas la spécification

Si vous importez un journal de diagnostic DB2, les données CBE (Common Base Events) présentées dans l'analyseur de trace et de journaux ne respectent pas certains éléments de la spécification CBE. Cet incident est dû au dysfonctionnement de l'utilitaire db2diag.exe qui permet de convertir les journaux de diagnostic DB2 en données CBE (Common Base Events). L'incident ne doit pas avoir d'incidence sur la procédure. Tant que le fichier db2diag.exe ne sera pas corrigé, il n'y aura pas de solution disponible.

1.2.8 L'analyseur de trace et de journaux ne valide pas le type de fichier journal importé

L'analyseur de trace et de journaux ne valide pas le type de fichier journal importé. Lorsque vous importez un fichier journal, veillez à sélectionner le type et la version appropriées pour le fichier journal importé. Si cette erreur se produit pendant l'importation, la vue Journal n'affiche pas les enregistrements ou présente des enregistrements incorrects et un message d'erreur apparaît. Pour plus d'informations sur l'erreur, affichez les données de la fenêtre d'erreur ou reportez-vous au fichier .metadata\.plugins\org.eclipse.hyades.logging.adapter\hgla.log, s'il existe dans le répertoire workspace. Ce fichier peut contenir des informations sur les erreurs détectées pendant l'analyse syntaxique du fichier journal.

Si une erreur se produit pendant l'importation d'un fichier journal, un message d'erreur s'affiche et aucun enregistrement n'apparaît dans la vue Journal ou des données incorrectes sont présentées dans les enregistrements de la vue.

1.2.9 Limitation pour l'importation des fichiers activity.log de WebSphere Application Server

Lorsque vous importez des journaux d'activités WebSphere Application Server à l'aide de systèmes qui ne sont pas en anglais, le programme d'analyse syntaxique du fichier journal fondé sur des règles ne parvient pas à mapper correctement les données des enregistrements du journal à un événement CBE (Common Base Event). Certaines données des enregistrements du journal peuvent apparaître dans une zone incorrecte de l'événement CBE (Common Base Event).

Pour résoudre cette erreur, utilisez le programme d'analyse syntaxique statique lorsque vous importez les journaux d'activités de WebSphere Application Server en utilisant des systèmes en anglais.

1.2.10 Limitation pour l'importation des fichiers journaux générés dans un environnement local différent

Lorsque vous importez des fichiers journaux contenant des horodatages dont l'environnement local diffère de celui utilisé pour l'exécution de l'analyseur de trace et de journaux, le programme d'analyse syntaxique basé sur des règles ne peut pas traiter correctement l'horodatage ni les autres données des enregistrements de journaux. Par exemple, lorsque vous importez la version anglaise du journal des accès d'IBM HTTP Server dans un environnement japonais où l'analyseur syntaxique de trace et de journaux s'exécute, les valeurs creationTime des données CBE (Common Base Events) correspondent à 0 et la zone de message CBE est vierge.

Pour corriger cet incident, utilisez un programme d'analyse syntaxique statique lorsque vous importez des fichiers journaux contenant des horodatages dont l'environnement local diffère de celui du système utilisé.

1.2.11 Echec de l'importation avec le message d'exception InvocationTargetException

Si l'analyseur de trace et de journaux n'a pas été installé correctement et que certains de ses fichiers sont manquants, l'importation d'un fichier journal risque d'échouer en générant le message suivant :

java.lang.reflect.InvocationTargetException

Pour résoudre cet incident, réinstallez l'analyseur de trace et de journaux. Remarque : Si vous effectuez l'installation sous Windows XP, ne lancez pas l'utilitaire unzip Windows XP natif. Pour plus d'informations, voir Erreurs lors de la décompression avec l'utilitaire unzip de Windows XP ci-dessous.

1.2.12 Exception NullPointerException pendant l'importation d'un journal vide

Lorsqu'un journal vide est importé ou qu'un filtre d'importation est utilisé pour éliminer tous les événements de journal, la vue Journal est vide et une exception NullPointerException (dans XMLLoader.endElement) peut être générée. Vérifiez le fichier journal ou essayez un autre filtre qui permet le chargement de certains événements.

1.3 Support de base de données

Non applicable

1.4 Autres

1.4.1 L'assistant de création d'une corrélation de journal ne s'affiche pas correctement avec un pilote Linux GTK

L'assistant Nouvelle corrélation de journaux affiche uniquement une liste Journaux disponibles vide. Cet incident se produit car seule la partie de gauche de la page de l'assistant est affichée.

Pour résoudre cet incident, essayez de redimensionner la page de l'assistant pour afficher la liste Journaux sélectionnés et les boutons d'action. Une autre solution consiste à sélectionner les fichiers journaux pour corrélation dans la vue Navigateur de journaux avant de cliquer sur le bouton Nouvelle corrélation de journaux.

1.4.2 Les modifications apportées au niveau de journalisation du plug-in après le premier démarrage du plan de travail ne sont pas prises en compte

Si vous modifiez le niveau de journalisation d'un plug-in dans son fichier plugin.xml (via les points d'extension com.ibm.etools.common.logging.commonLoggingOptions ou com.ibm.etools.logging.util.loggingOptions) après le premier lancement d'un plan de travail, cette modification n'est pas prise en compte lors des lancements ultérieurs du plan de travail. L'environnement d'exécution Eclipse met en mémoire cache le niveau de journalisation indiqué dans le fichier plugin.xml du plug-in lors du premier lancement du plan de travail. Même si vous avez modifié le fichier plugin.xml, les lancements ultérieurs du plan de travail utilisent la valeur mise en cache du niveau de journalisation du plug-in.

Pour résoudre cet incident, relancez le plan de travail en utilisant l'argument de ligne de commande -clean. Cette option nettoie les mémoires cache utilisées pour stocker les résolutions de dépendances de bundles et les données de registre des extensions Eclipse. Elle force Eclipse à réinitialiser les mémoires cache. Ajoutez l'option après eclipse.exe dans <répertoire d'installation du plan de travail>\eclipse\ac.bat (Windows) ou <répertoire d'installation du plan de travail>/eclipse/ac.sh (Linux). Vous pouvez également modifier le niveau de journalisation du plug-in dans la page de préférences Journalisation (Fenêtre > Préférences > Journalisation) et relancer le plan de travail.

1.4.3 Erreurs lors de la décompression à l'aide de l'utilitaire unzip de Windows XP

Lorsque vous installez l'analyseur de trace et de journaux sous Windows XP, des erreurs se produisent si vous décompressez le fichier d'exécution de l'analyseur avec l'utilitaire unzip natif de Windows XP. Certains répertoires et fichiers ne sont pas décompressés. En conséquence, certains types de fichier journal ne peuvent pas être importés à l'aide de l'analyseur de trace et de journaux.

Pour résoudre cet incident, choisissez un autre utilitaire, tel que WinZip ou Unzip, pour effectuer l'installation sous Windows XP.

1.4.4 Arrêt brutal du logiciel lors de la création d'un exemple sous Red Hat Linux version 8.0 avec la machine virtuelle Java IBM

Lorsque vous créez un exemple dans l'analyseur de trace et de journaux en utilisant l'assistant de création d'exemple (Nouveau > Exemple), le plan de travail s'arrête brutalement. Cet incident se produit lorsque l'assistant de création d'exemple tente d'ouvrir le fichier readme.html pendant la procédure de création. Il a été détecté sous Red Hat Linux version 8.0 avec la machine virtuelle d'IBM et correspond à un dysfonctionnement de SWT (https://bugs.eclipse.org/bugs/show_bug.cgi?id=76515).

Pour résoudre cet incident, essayez d'ajouter l'argument JVM "-Xj9" dans ac.sh pour lancer la procédure à l'aide de la machine virtuelle Java J9 d'IBM, (par exemple ./eclipse -vmargs -Xj9 -Xmx500m). Pour plus d'informations sur l'exécution de SWT sous Red Hat Linux version 8.0, reportez-vous à la foire aux questions de SWT (http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/platform-swt-home/faq.html).

Remarque : Comme indiqué dans le tableau des plateformes de référence Eclipse (http://www.eclipse.org/eclipse/development/eclipse_project_plan_3_0.html#TargetOperatingEnvironments), seuls les systèmes Linux suivants sont pris en charge : version 2.2.1 de GTK+ widget toolkit et bibliothèques associées (GLib, Pango); L'afficheur HTML SWT requiert Mozilla 1.4 GTK2. Pour Motif sous d'autres systèmes Linux : Open Motif 2.1 (inclus) ; L'afficheur HTML SWT requiert Mozilla 1.4 GTK2.

1.4.5 Restriction du navigateur pour visualiser les fichiers journaux XML Common Logging

Il est recommandé de visualiser le fichier CommonBaseEvents.log généré par le plan de travail à l'aide des vues Journal fournies par les outils de journalisation. Vous pouvez également utiliser un navigateur XML pour visualiser le journal au format XML (c'est-à-dire le fichier CommonBaseEvents.log_Viewer.xml dans le sous-répertoire workspace\.metadata du répertoire d'installation). Ce fichier peut être affiché uniquement avec Microsoft Internet Explorer version 6.0.28 et suivantes.

1.4.6 Seules les bases de données de symptômes au format TPTP peuvent être créées à partir de la barre d'outils et le menu en incrustation Navigateur de journaux

En raison d'une limitation de TPTP, vous ne pouvez pas créer les deux types de base de données de symptômes en utilisant le bouton de la barre d'outils et le menu en incrustation Navigateur de journaux. La solution proposée consiste à sélectionner Fichier > Nouveau > Autres > Profilage et journalisation dans le menu du plan de travail et à choisir le type de base de données de symptômes à créer.

2.0 Outil de profilage

2.1 Les vues Interactions d'agents et Interactions de processus ne sont pas prises en charge par la vue Diagramme de séquences

Les vues Interactions d'agents et Interactions de processus ne sont pas prises en charge à partir de la vue Diagramme de séquences pour les fichiers journaux.

A l'heure actuelle, il n'y pas de solution disponible pour résoudre cet incident.

2.2 L'option Régénérer les vues du navigateur de profilage ne fonctionne pas pour les interactions de trace

L'option Régénérer les vues du navigateur de profilage ne fonctionne pas pour les interactions de trace. Toutefois, les interactions de trace sont automatiquement régénérées par elles-mêmes à des intervalles réguliers.

Une solution consiste à sélectionner un autre noeud dans l'arborescence Profilage et à sélectionner le noeud précédent une seconde fois.

2.3 Le profilage sous Windows avec Sun JDK 1.4.x peut se terminer par un rapport d'erreurs Microsoft

Incident Bugzilla : 103058

Le profilage ou l'application s'arrête et génère un message indiquant que java.exe a détecté une erreur et doit s'arrêter. Le message contient des informations et des options pour soumettre un rapport d'erreurs à Microsoft. Pour afficher la capture d'écran du message, voir la référence bugzilla 103058.

Cet incident a été observé sur un certain nombre de noeuds : Analyse du délai (avec ou sans l'option "Afficher des instances"), Analyse de la mémoire et dans les combinaisons de ces modes. Vous pouvez corriger cette erreur en réexécutant le profilage ou l'application avec JIT désactivé, par exemple en indiquant "-Djava.compiler=NONE" comme argument JVM. Cette erreur a été détectée avec SUN JDK version 1.4.2_08-b03 pour Windows.


(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.

Retour au fichier Readme principal

Copyright et notes