Outils de Profilage et de journalisation - Notes sur l'édition

1.0 Introduction
2.0 Spécifications et logiciels pris en charge
3.0 Restrictions
   3.1 Fonction de sécurité non disponible
   3.2 Mise à niveau d'Agent Controller sous Linux
   3.3 Echec du démarrage d'Agent Controller sous AIX
   3.4 Autres erreurs lors de l'installation et de la désinstallation
   3.5 Mémoire insuffisante
4.0 Problèmes connus
   4.1 Ouverture et affichage des fichiers de trace
   4.2 Importation de fichiers journaux
   4.3 Affichage de fichiers de grande taille dans la vue Interactions de journaux
   4.4 Masquage d'appels auto-référencés ignorés par les vues Interactions de journaux
   4.5 Prise en charge des vues Interactions des agents et Interactions des processus
   4.6 Importation de fichiers journaux à partir de Solaris
   4.7 Impossibilité d'importer un fichier journal contenant des caractères non ASCII
   4.8 Duplication des données de classe et de méthode après une nouvelle association de l'agent
   4.9 IBM HTTP Server 1.3.26.2 n'est pas répertorié dans l'assistant d'importation
   4.10 Impossibilité de modifier les propriétés de l'agent après lancement ou connexion

1.0 Introduction

Les présentes notes sur l'édition décrivent les performances et les outils d'analyse et de profilage de mémoire disponibles dans la perspective Profilage et journalisation du plan de travail (y compris les vues Journal).

Sources supplémentaires d'informations


Document Guide for using the samples
A partir du programme d'analyse de trace et de journal, sélectionnez Fichier > Nouveau > Exemple... puis l'arborescence Exemples d'analyseur et de corrélation de journal. Sélectionnez l'option d'exemples d'analyseur et de corrélation de journal Apache et cliquez sur le bouton Suivant. Puis, cliquez sur le bouton Fin. L'exemple sera automatiquement créé.


Guide permettant de créer des analyseurs syntaxiques, des moteurs de corrélation et des moteurs d'analyse
Ces guides sont disponibles sur Internet à l'adresse suivante  http://dev.eclipse.org/viewcvs/indextools.cgi/~checkout~/hyades-home/docs/doc.html

2.0 Spécifications et logiciels pris en charge

Profilage d'une applet Java
Pour profiler une applet Java créée sous Eclipse, procédez comme suit :

1. A partir du menu Exécuter, sélectionnez Exécuter
2. Sélectionnez Applet Java et cliquez sur Nouveau.
3. Sélectionnez l'onglet Arguments.
4. Indiquez les données suivantes dans la section Arguments VM : -XrunpiAgent:server=controlled
5. Cliquez sur Exécuter. L'application ne s'exécutera pas tant que n'avez pas associé de processus.
6. Accédez à la perspective Profilage et journalisation.
7. Dans le menu Profil, sélectionnez Associer->Processus Java.
8. A l'aide de l'assistant, associez le processus.
9. Démarrez le contrôle de l'agent. L'application doit alors s'exécuter.
Le processus peut également être profilé en mode Activé. Pour obtenir plus de détails, reportez-vous à la documentation RAC.

Le fichier Readme nommé Working with the Hyades Apache Commons Logging Sample n'indique pas le nom de l'agent de journalisation correct à l'étape 3 de la section relative à la procédure d'exécution. Le nom correct de l'agent de journalisation est org.eclipse.hyades.logging.commons.sample.HyadesLoggingCommonsSample.

3.0 Restrictions

3.1 Fonction de sécurité non disponible

La fonction de sécurité d'IBM Agent Controller n'est pas disponible. Lorsque vous êtes invité à activer la sécurité lors de l'installation, sélectionnez Désactiver ou Non.

3.2 Mise à niveau d'Agent Controller sous Linux

Si vous mettez à niveau Agent Controller sous Linux à partir de la version 5.0.1 ou d'une version antérieure, vous devez tout d'abord désinstaller cette version à l'aide d'une commande du type suivant :

rpm -e ibmrac-5.0.1-0
Après avoir désinstallé l'ancienne version, vous pouvez installer la nouvelle version à l'aide de la commande :
rpm -U ibmrac-5.1.0-0.i386.rpm

3.3 Echec du démarrage d'Agent Controller sous AIX

Le démarrage d'Agent Controller peut ne pas aboutir sous AIX et le message suivant peut être généré :

Le démarrage de RAServer a échoué.
Cette erreur est généralement provoquée par le fait que le port TCP/IP 10002 est utilisé par un autre processus en cours d'exécution sur le système ou par le fait qu'Agent vient d'être arrêté.

Solution : Si le port 10002 est utilisé par un autre processus, vous pouvez changer le numéro de port en modifiant le fichier serviceconfig.xml. Cette procédure est décrite dans la documentation.

3.4 Autres erreurs lors de l'installation et de la désinstallation

Si vous rencontrez des erreurs lors de l'installation ou de la désinstallation, cela peut être dû au fait que les fichiers objets d'Agent Controller sont chargés par les processus d'exécution. Afin de vous assurer que les fichiers objet peuvent être modifiés, procédez comme suit :

  1. Arrêtez le plan de travail.
  2. Terminez tous les processus qui contiennent Java Profiling Agent ou J2EE Request Profiler.
  3. Fermez la fenêtre Services.

3.5 Mémoire insuffisante

Lorsque le plan de travail traite un grand nombre de données, la mémoire peut être insuffisante. Cette situation peut survenir à différentes étapes, en fonction de l'environnement JRE que vous utilisez. Par exemple, dans certaines situations, SUN 1.4.1 s'exécute plut tôt qu'IBM 1.3.1 ou qu'IBM 1.4.1.

Solution : Utilisez l'argument JVM -Xmx afin d'augmenter votre attribution de mémoire dynamique. L'utilisation de -Xmx200M est recommandée. Toutefois, des montants plus élevés peuvent être requis en fonction de la configuration de la machine et des éléments requis par l'application.

4.0 Problèmes connus

4.1 Ouverture et affichage des fichiers de trace

Les fichiers de trace WebSphere Application Server générés à l'aide du format de sortie de trace Log Analyzer ne peuvent pas être ouverts et affichés à l'aide des outils de journalisation.

Solution : Attribuez la valeur De base ou Avancé pour le format de sortie de trace WebSphere Application Server avant de générer les fichiers de trace à ouvrir et à afficher à l'aide des outils de journalisation.

4.2 Importation de fichiers journaux

Des fichiers journaux dont la taille maximale est de 25 Mo peuvent être importés dans l'espace de travail et ouverts dans le programme d'analyse de trace et de journal. Le temps nécessaire à l'ouverture du fichier journal dépend du nombre d'enregistrements de journal dans le fichier et il est possible d'obtenir une exception indiquant que la mémoire est insuffisante.

Solution : Augmentez la mémoire en démarrant Eclipse de la manière suivante :

"eclipse.exe -vmargs -Xmx800M" ou ajoutez de la mémoire physique supplémentaire à la machine.

4.3 Affichage de fichiers de grande taille dans la vue Interaction de journaux

Lorsque des fichiers journaux de grande taille sont affichés dans la vue Interactions de journaux, l'aperçu du Diagramme de séquence n'affiche aucun fichier journal. Le bouton Aperçu est déplacé de la partie inférieure à la partie supérieure de la vue mais la largeur de la vue elle-même est nulle.

Solution : Aucune.

4.4 Masquage d'appels auto-référencés ignorés par les vues Interactions de journaux

L'option permettant de masquer les appels auto-référencés se trouve dans la page Préférences des vues Diagramme de séquence (Fenêtres > Préférences > Profilage et journalisation > Diagramme de séquence) est ignorée par les vues Interactions de journaux.

Solution : Aucune.

4.5 Prise en charge des vues Interactions des agents et Interactions des processus

Les vues Interactions des agents et Interactions des processus ne sont pas prises en charge dans la vue Diagramme de séquence pour les fichiers journaux.

Solution : Aucune.

4.6 Importation de fichier journaux à partir de Solaris

Il n'est pas possible d'importer correctement les fichiers journaux à partir de Solaris.

Solution : Aucune. Le pilote Solaris n'est pas stable, une mise à jour sera fournie très prochainement.

4.7 Impossibilité d'importer un fichier journal contenant des caractères non ASCII

Si le contenu d'un fichier journal contient des caractères non ASCII (par exemple, 0xFF 0xFB ... ), le fichier journal ne sera pas importé correctement.

Solution : Supprimez ces caractères non ASCII du fichier journal.

4.8 Duplication des données de classe et de méthode après une nouvelle association de l'agent

Le programme signale qu'il existe des classes et des méthodes en double lorsque vous vous reconnectez au même agent, pour le même projet et la même destination de contrôle.

Il peut être utile de se déconnecter de l'agent lorsque vous pensez qu'une autre ressource doit s'y connecter.

Solution : Sélectionnez Arrêter le contrôle pour interrompre la collecte des données de profil puis sélectionnez Démarrer le contrôle pour reprendre le profilage.

4.9 IBM HTTP Server 1.3.26.2 n'est pas répertorié dans l'assistant d'importation

IBM HTTP Server version 1.3.26.2 n'est pas répertorié dans l'assistant d'importation en tant que format de journal pris en charge. Ce serveur est utilisé dans WebSphere Application Server version 5.0.2. Vous pouvez importer des journaux à partir d'IBM HTTP Server 1.3.26.2 à l'aide de la version 1.3.26.1.

4.10 Impossibilité de modifier les propriétés de l'agent après lancement ou connexion

Une fois qu'un agent est créé par une opération de lancement ou de connexion, les modifications apportées aux propriétés de l'agent (par exemple, les options ou les filtres) ne peuvent être appliquées.

Solution : Déconnectez et reconnectez l'agent à un moniteur différent avec les nouvelles options et les nouveaux filtres.

Retour au fichier Readme principal