1.0 Introduction
2.0 Spécifications et logiciels pris en charge
3.0 Limitations
3.1 Dispositif de sécurité non disponible
3.2 Mise à niveau d'Agent Controller sous Linux
3.3 Echec possible du démarrage d'Agent Controller sous AIX
3.4 Autres erreurs au cours de l'installation et de la désinstallation
3.5 Erreur de saturation de mémoire
4.0 Problèmes connus
4.1 Ouverture et affichage des fichiers de trace
4.2 Importation de fichiers journaux
4.3 Affichage des fichiers volumineux dans la vue Interactions de journaux
4.4 Masquer les 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 Impossible d'importer un fichier journal contenant des caractères non-ASCII
4.8 Impossible de profiler WebSphere Application Server 5.0.2 en mode autonome
4.9 Duplication des données de méthode et de classe après la réassociation de l'agent
4.10 IBM HTTP Server 1.3.26.2 ne figure pas dans l'assistant d'importation
4.11 Impossible de modifier les propriétés de l'agent après son lancement ou son association
Cette note d'édition traite des outils de création et d'analyse de profils de mémoire et de performance qui sont disponibles dans la perspective Profilage et Journalisation du plan de travail (y compris les vues Journal).
Sources de documentation supplémentaires
Guide d'utilisation des exemples
A partir de l'analyseur de journaux et de trace, appelez Fichier > Nouveau > Exemple... et sélectionnez l'arborescence Exemples d'analyseur et de corrélation de journal. Sélectionnez l'option de menu Exemple de corrélation/analyseur de journal Apache et cliquez sur le bouton Suivant. Cliquez ensuite sur le bouton Fin. L'exemple est créé automatiquement.
Guide de création d'analyseurs syntaxiques, de moteurs de corrélation et de moteurs d'analyse.
Ces guides sont disponibles à l'adresse suivante :http://dev.eclipse.org/viewcvs/indextools.cgi/~checkout~/hyades-home/docs/doc.html
Profilage d'un applet Java
Pour profiler un applet Java créé sous Eclipse, procédez comme suit :Notez que le processus peut également être profilé en mode activé. Pour plus d'informations, reportez-vous à la documentation RAC.
- 1. Utilisez le menu Exécuter pour sélectionner Exécuter...
- 2. Sélectionnez Applet Java et cliquez sur Nouveau.
- 3. Sélectionnez l'onglet Arguments.
- 4. Spécifiez ce qui suit dans Arguments VM :
-XrunpiAgent:server=controlled
- 5. Cliquez sur Exécuter. Notez que l'application ne s'exécutera pas tant que vous ne l'aurez pas liée au processus.
- 6. Accédez à la perspective Profilage et journalisation.
- 7. Utilisez le menu Profil pour sélectionner Associer->Processus Java.
- 8. Utilisez l'assistant pour effectuer l'association au processus.
- 9. Commencez à contrôler l'agent. A ce stade, l'application devrait s'exécuter.
Le fichier readme, Working with the Hyades Apache Commons Logging Sample, n'indique pas le nom d'agent de journalisation correct à l'étape 3 de la section des étapes d'exécution. Le nom correct de l'agent de journalisation est org.eclipse.hyades.logging.commons.sample.HyadesLoggingCommonsSample.
Le dispositif de sécurité d'IBM Agent Controller n'est pas disponible. Lorsque le système vous invite à activer la sécurité au cours de l'installation, sélectionnez Désactiver ou non.
Si vous effectuez une mise à niveau d'Agent Controller sous Linux à partir de la version 5.0.1 ou d'une version antérieure, vous devez d'abord désinstaller cette version à l'aide d'une commande similaire à ce qui suit :
rpm -e ibmrac-5.0.1-0Après avoir désinstallé l'ancienne version, vous pouvez installer la nouvelle version à l'aide de la commande suivante :rpm -U ibmrac-5.1.0-0.i386.rpm
Le démarrage d'Agent Controller peut échouer sous AIX et afficher le message suivant :
RAServer failed to start.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, changez le numéro de port en modifiant le fichier serviceconfig.xml. Cette procédure est décrite dans la documentation.
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 :
- Arrêtez le plan de travail.
- Arrêtez tous les processus java.exe comportant Java Profiling Agent ou J2EE Request Profiler.
- Fermez la fenêtre Services.
Le plan de travail peut parfois manquer de mémoire lors de la gestion de grandes quantités de données. Cela peut se produire à des phases différentes en fonction du JRE que vous utilisez. Par exemple, dans certaines situations, SUN 1.4.1 peut manquer de mémoire plus rapidement qu'IBM 1.3.1 ou IBM 1.4.1.
Solution : Utilisez l'argument JVM -Xmx pour augmenter votre allocation de segment de mémoire. -Xmx200M est la quantité recommandée ; toutefois, des quantités plus importantes peuvent être nécessaires en fonction de votre configuration et des besoins des applications.
Les fichiers de trace WebSphere Application Server générés avec le format de sortie de trace de l'Analyseur de journaux ne peuvent pas être ouverts ni affichés à l'aide des outils de journalisation.
Solution :Affectez au format de sortie de trace de WebSphere Application Server la valeur De base ou Avancé avant de générer des fichiers de trace pouvant être ouverts et affichés à l'aide des outils de journalisation.
Les fichiers journaux jusqu'à 25 Mo peuvent être importés dans le plan de travail et ouverts dans l'Analyseur de journaux et de trace. Le délai nécessaire à l'ouverture du fichier journal dépend du nombre d'enregistrements de journal qu'il contient et vous pouvez obtenir une exception "mémoire saturée".
Solution Augmentez la mémoire en démarrant Eclipse de la façon suivante :
"eclipse.exe -vmargs -Xmx800M" ou ajoutez de la mémoire physique à la machine.
Lorsque des fichiers journaux volumineux sont affichés dans la vue Interactions de journaux, la vue Diagramme de séquence ne contient aucun fichier journal. Le bouton Aperçu est déplacé du bas vers le haut de la vue, mais la vue elle-même n'a pas de largeur.
Solution : Aucune.
L'option de masquage des appels auto-référencés est présente dans la page Préférences pour les vues Diagramme de séquence (Fenêtre > Préférences > Profilage et journalisation > Diagramme de séquence) est ignorée par les vues Interactions de journaux.
Solution : Aucune.
Les vues Interactions des agents et Interactions des processus ne sont pas prises en charge à partir de la vue Diagramme de séquence pour les fichiers journaux.
Solution : Aucune.
Les fichiers journaux ne peuvent pas être importés correctement à partir de Solaris.
Solution : Aucune. Le pilote Solaris n'est pas stable et une mise à jour sera disponible très prochainement.
Si un fichier journal contient des caractères non-ASCII (par exemple, 0xFF 0xFB ... ), il ne pourra pas être importé correctement.
Solution : Supprimez ces caractères non-ASCII du fichier journal.
Le profilage de WebSphere Application Server version 5.0.2 bloque ou arrête le serveur à moins que vous n'utilisiez le serveur d'applications incorporé à ce produit.
Solution : Si vous souhaitez profiler des instances de WebSphere Application Server version 5.0.2 qui ne font pas partie de ce produit, vous devrez contacter le service d'assistance WebSphere pour obtenir un correctif. Vous trouverez plus d'informations ici.
La réassociation au même agent sous la même destination de projet et de moniteur entraîne le signalement de classes et de méthodes en double.
Le détachement de l'agent peut être utile si l'agent doit être associé par une autre ressource.
Solution : Sélectionnez Arrêter le contrôle pour arrêter la collecte de données de profil et ensuite, sélectionnez de nouveau Démarrer le contrôle pour reprendre le profilage.
L'IBM HTTP Server version 1.3.26.2 ne figure pas 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 de IBM HTTP Server 1.3.26.2 avec la version 1.3.26.1.
Une fois qu'un agent est créé par lancement ou association, les modifications des propriétés de l'agent, par exemple, ses options ou ses filtres, ne peuvent pas être appliquées.
Solution : Détachez et réassociez l'agent à un moniteur différent avec les nouvelles options et les nouveaux filtres.
Retour au fichier Readme principal
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.