Notes sur l'édition de l'analyseur de trace et de journaux

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

Notes sur l'édition

1.0 Limitations connues, problèmes identifiés et leurs solutions
   1.1 Erreurs concernant les fonctions de filtrage et de mise en évidence dans la vue Journal
   1.2 Erreurs lors de l'importation de fichiers journaux distants
   1.3 Importation des fichiers journaux sous Linux et AIX
   1.4 Importation du fichier journal trace.log de WebSphere Application Server
   1.5 Exception liée à une quantité de mémoire insuffisante
   1.6 Les événements affichés pour le journal de diagnostic DB2 ne respectent pas la spécification
   1.7 Aucune validation n'est donnée sur le type de fichier journal importé
   1.8 Limitation pour l'importation des fichiers journaux générés dans un environnement local différent
   1.9 Echec de l'importation du journal d'activité de WebSphere Application Server avec l'analyseur syntaxique de règles en provenance d'AIX
   1.10 Le filtrage des types d'événements de base commun complexe n'est pas pris en charge pour les importations de fichier journal
   1.11 Erreurs lors de l'importation simultanée de plusieurs fichiers journaux
   1.12 Les accès client simultanés à une base de données avec le même compte ne sont pas pris en charge
   1.13 Conflit entre les chemins d'accès d'une ressource
   1.14 Les préférences du support pour ressources volumineuses restent inactivées malgré la validation
   1.15 Amélioration des performances du support pour journaux volumineux
   1.16 Exception SQL intermittente
   1.17 Le test de connexion renvoie une erreur si vous n'avez pas validé de préférences
   1.18 L'expression XPath n'est pas prise en charge lors de l'analyse de fichiers volumineux
   1.19 Seul un contextDataElement est affiché pour les journaux volumineux
   1.20 L'assistant de création d'une corrélation de journal ne s'affiche pas correctement avec un pilote Linux GTK
   1.21 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.22 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
   1.23 Les messages qui dépassent 1024 octets ne sont pas traités
   1.24 L'éditeur de symptômes génère des règles XPATH qui ne sont pas valides lors de l'utilisation d'éléments complexes
   1.25 Les vues Interactions d'agents et Interactions de processus ne sont pas prises en charge par la vue Diagramme de séquences
   1.26 L'option Régénérer les vues du navigateur de profilage ne fonctionne pas pour les interactions de trace

1.0 Limitations connues, problèmes identifiés et leurs solutions

1.1 Erreurs concernant les fonctions de filtrage et de mise en évidence dans la vue Journal

Dans la vue Journal, les fonctions de filtrage et de mise en évidence ne fonctionnent pas sur des éléments complexes de l'événement du journal (par exemple, sourceComponentId)

1.2 Erreurs lors de l'importation de fichiers journaux distants

Lorsque vous importez un fichier journal distant (Fichier > Importer > Profilage et journalisation >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 contrôleur d'agent, à l'issue duquel le client local doit commencer à surveiller l'analyseur syntaxique du journal distant. Pour contourner ce problème, procédez comme suit :


Essayez d'importer le fichier journal une nouvelle fois.

Si l'erreur persiste, ajoutez l'entrée suivante à l'application distante RemoteLogParserLoader dans la configuration du contrôleur d'agent (par exemple, <le répertoire d'installation du contrôleur d'agent>/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).
Une fois la modification effectuée, redémarrez le contrôleur d'agent et essayez une nouvelle fois d'importer le fichier journal.

1.3 Importation des fichiers journaux sous Linux et AIX

Certaines importations de fichiers journaux ne fonctionnent pas sur les plateformes 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.4 Importation du fichier journal trace.log de WebSphere Application Server

Une corrélation interne est créée lors de l'importation d'un fichier trace.log 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.5 Exception liée à une quantité de mémoire insuffisante

Vous pouvez importer des fichiers journaux dont la taille peut atteindre 25 Mo dans l'espace de travail. 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.6 Les événements affichés pour le journal de diagnostic DB2 ne respectent pas la spécification

Si vous importez un journal IBM DB2 Express Diagnostic, les événements affichés ne suivent pas complètement les spécifications d'événement de journal. Cet incident est dû au dysfonctionnement de l'utilitaire db2diag.exe qui permet de convertir les journaux de diagnostic DB2 en événements de journal. L'incident ne doit pas avoir d'incidence sur l'opération d'importation. Il n'existe pas de solution palliative connue tant que db2diag.exe n'est pas corrigé. 

1.7 1.7 Aucune validation n'est donnée sur le type de fichier journal importé

Aucune validation n'est donnée sur 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 le détail de la fenêtre d'erreur. 

1.8 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 du plan de travail, 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, lors de l'importation d'un fichier journal d'accès à IBM HTTP Server anglais vers une machine japonaise, les valeurs creationTime affichées dans les événements de journal correspondants présentent une valeur de zéro et la zone de message de l'événement de journal est vide.

Pour corriger cet incident, lorsque vous importez des fichiers journaux contenant des horodatages dont l'environnement local diffère de celui du système utilisé, indiquez l'environnement local correspondant au fichier journal dans l'onglet Détails de l'assistant d'importation de journaux, s'il existe une zone pour l'environnement local.

1.9 Echec de l'importation du journal d'activité de WebSphere Application Server avec l'analyseur syntaxique de règles en provenance d'AIX

L'importation d'un journal d'activité WAS binaire avec l'analyseur syntaxique de règles à partir d'un système AIX échoue et provoque l'apparition du message d'erreur :

IWAT0030E An error occurred during the execution of the remote log (Une erreur s'est produite lors de l'exécution de l'analyseur de journal distant)
parser "com.ibm.etools.logging.adapter.config.StaticParserExtension":

IWAT0412E Errors occurred parsing the log file /home/tfoun/logs/activity.log (Des erreurs se sont produites lors de l'analyse syntaxique du fichier journal /home/tfoun/logs/activity.log.).
java.lang.Exception: IWAT0239E Converter command failed (Echec de la commande de conversion) : java.lang.Exception:
IWAT0238E Converter process ended with exit value 1 (le processus de conversion s'est terminé avec une valeur de sortie de 1)

La commande du convertisseur permettant de convertir le fichier journal binaire en texte pour qu'il puisse être analysé a échoué sous AIX. Pour contourner ce problème, utilisez l'analyseur syntaxique statique pour importer le fichier journal d'activité binaire ou convertissez le fichier journal d'activité binaire en texte à l'aide de l'utilitaire WAS showlog et importez le fichier texte résultant. L'utilitaire showlog WAS figure dans le répertoire bin dans le répertoire d'installation de WAS. Par exemple, la commande suivante permet de convertir du fichier journal binaire en un fichier texte appelé activity.txt :

/opt/WebSphere/AppServer/bin/showlog activity.log activity.txt

Ensuite, importez le fichier activity.txt.

1.10 Le filtrage des types d'événements de base commun complexe n'est pas pris en charge pour les importations de fichier journal

Lorsque vous spécifiez les fichiers journaux à importer, vous pouvez créer des filtres avancés. La boîte de dialogue d'ajout de propriété de filtre contient une zone de liste déroulante pour la zone Attribut. Cette zone de liste déroulante présente un ensemble de propriétés d'événement de journal. Notez qu'il ne présente pas les types complexes de propriétés d'événement de journal. 

1.11 Erreurs lors de l'importation simultanée de plusieurs fichiers journaux

Lors de l'importation simultanée de plusieurs fichiers journaux, les dates figurant sur les enregistrements importés peuvent être incorrectes. Pour contourner ce problème, importez les fichiers un par un. 

1.12 Les accès client simultanés à une base de données avec le même compte ne sont pas pris en charge

Des accès client concurrents à la base de données peuvent entraîner le verrouillage de certaines tables. Pour déverrouiller les tables, redémarrez le plan de travail et le serveur de la base de données.

1.13 Conflit entre les chemins d'accès d'une ressource

Si vous utilisez la même base de données et le même compte dans plusieurs espaces de travail, les chemins d'accès de la ressource entrent en conflit et la ressource n'est pas conservée dans la base de données.

Pour contourner ce problème, servez-vous des différents noms de moniteur et de projet dans chaque espace de travail pour éviter que les chemins d'accès de la ressource n'entrent en conflit.

1.14 Les préférences du support pour ressources volumineuses restent inactivées malgré la validation

Sous Linux/GTK, sur la page des préférences du support pour ressources volumineuses, les zones de paramétrage de la base de données restent désactivées même si le type de base de données sélectionné est valide.

Pour contourner ce problème, sélectionnez DB2 comme type de base de données et appliquez les paramètres. Fermez, puis rouvrez la boîte de dialogue des préférences ; les zones sont à présent activées.

1.15 Amélioration des performances du support pour journaux volumineux

Pour améliorer les performances du support pour journaux volumineux, exécutez la commande suivante après avoir importé les journaux volumineux :

db2 -tvf plugins/com.ibm.etools.ac.resources.database_x_x_x /scripts/runStatsForAllHyadesTablesDB2-8.1.sql
x_x_x correspond au numéro de version inscrit dans le répertoire de plug-in.

1.16 Exception SQL intermittente

L'exception SQL suivante peut parfois survenir :

com.ibm.db2.jcc.b.SQLException: NULLID.SYSSH203 0X5359534C564C3031

Si ce problème survient, redémarrez le plan de travail et la base de données, en mode réseau si vous utilisez DB2 ou Cloudscape. Les journaux importés lorsque cette exception survient ne seront pas valides et devront être réimportés.

1.17 Le test de connexion renvoie une erreur si vous n'avez pas validé de préférences

Sur la page du support pour journaux volumineux de la section Profilage et Journalisation de la boîte de dialogue Préférences, si vous cliquez sur Test de connexion avant d'avoir appliqué les modifications aux paramètres, une erreur de connexion peut survenir. Pour éviter cela, cliquez sur Appliquer après avoir modifié les paramètres puis cliquez sur Test de connexion.

1.18 L'expression XPath n'est pas prise en charge lors de l'analyse de fichiers volumineux

L'expression XPath n'est pas prise en charge lors de l'analyse de fichiers volumineux.
    <expression:xpathExpression>/CommonBaseEvent</expression:xpathExpression>

1.19 Seul un contextDataElement est affiché pour les journaux volumineux

Si DB2 est utilisé pour la prise en charge de journaux volumineux, seul un contextDataElement par événement est affiché dans la vue Journal, même s'il existe plusieurs contextDataElements pour cet événement.

1.20 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.21 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 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. Ce problème survient sous Red Hat Linux v8.0 avec IBM Java Virtual Machine (JVM). Il s'agit d'un bogue 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.22 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. 

1.23 Les messages qui dépassent 1024 octets ne sont pas traités

Dans les règles XPath et les règles de corrélation IBM, la chaîne correspondant à la propriété d'événement de journal du message ne doit pas dépasser 1024 octets. Si la chaîne dépasse 1024 octets, l'événement n'est pas traité.

1.24 L'éditeur de symptômes génère des règles XPATH qui ne sont pas valides lors de l'utilisation d'éléments complexes

Lors de l'utilisation d'éléments complexes de l'événement de journal (par exemple, sourceComponentID), l'éditeur de symptôme génère des règles XPATH qui ne sont pas valides. 

1.25 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.

1.26 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.