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 Impossibilité de profiler un serveur WebSphere Application Server 5.0.2 autonome
4.9 Données de méthode et de classe en double après la reconnexion à l'agent
4.10 IBM HTTP Server 1.3.26.2 n'est pas répertorié dans l'assistant d'importation
4.11 Impossibilité de modifier les propriétés de l'agent après lancement ou connexion
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
Profilage d'une applet Java
Pour profiler une applet Java créée sous Eclipse, procédez comme suit :Le processus peut également être profilé en mode Activé. Pour obtenir plus de détails, reportez-vous à la documentation RAC.
- 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 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.
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.
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-0Aprè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
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.
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.
- Terminez tous les processus qui contiennent Java Profiling Agent ou J2EE Request Profiler.
- Fermez la fenêtre Services.
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.
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.
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.
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.
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.
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.
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.
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.
Le profilage de WebSphere Application Server version 5.0.2 bloque ou arrête le serveur sauf si vous utilisez le serveur d'applications intégré à ce produit.
Solution : Si vous voulez profiler des instances WebSphere Application Server version 5.0.2 qui ne font pas partie de ce produit, vous devez contacter le service d'assistance WebSphere pour obtenir un correctif. Vous pouvez obtenir des informations supplémentaires sur le site référencé ici.
Une nouvelle association au même agent sous le même projet et la même destination de contrôle provoque la génération d'un rapport signalant les classes et les méthodes en double.
Le détachement de l'agent est utile lorsque vous pensez que l'agent est associé par une autre ressource.
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.
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.
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
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.