Test complet de l'agent

Utiliser le test complet de l'agent pour tester tous les groupes d'attributs de l'agent ensemble. Vous pouvez également utiliser le test complet de l'agent pour tester des sources de données qui ne peuvent pas l'être à l'aide de la fonction de test de groupe d'attributs.

1. Ouvrez la perspective Test de l'agent :
   1. Dans l'éditeur d'agent, ouvrez l'onglet Informations sur l'agent.
   2. Cliquez sur Tester l'agent.

      

      Vous pouvez également, à partir du menu d'Agent Builder, sélectionner Fenêtre > Ouvrir la perspective > Autre, sélectionner Test de l'agent et cliquer sur OK.

   La perspective Test de l'agent s'ouvre (Figure 3). La vue Test de l'agent répertorie les agents ouverts dans l'éditeur d'agent ; vous pouvez tester tous ces agents. La vue Test du groupe d'attribut s'affiche également ; à l'origine, cette vue est vide. La vue Test du groupe d'attribut affiche des données qui sont collectées à partir d'un groupe d'attributs sélectionné lorsque l'agent est en cours d'exécution.

   Conseil : Si aucun agent n'est en cours d'édition, la perspective Test de l'agent est vide. Pour remplir la vue, allez à la perspective IBM Tivoli Monitoring et ouvrez un agent dans l'Editeur d'agent. Lorsqu'un agent est ouvert dans l'Editeur d'agent, retournez à la perspective Test de l'agent pour tester l'agent.
2. Facultatif : Définissez les variables d'environnement et les propriétés de configuration avant de démarrer le test.
   Vous pouvez accéder aux fenêtres Variables d'environnement et Configuration d'exécution de deux manières à partir de la vue Test de l'agent :
   • Cliquez avec le bouton droit de la souris sur l'agent dans la vue Test de l'agent pour ouvrir un menu de sélection. Vous pouvez sélectionner Définir l'environnement dans le menu pour ouvrir la fenêtre Variables d'environnement. Vous pouvez sélectionner Configuration dans le menu pour ouvrir la fenêtre Configuration d'exécution.
   • Cliquez sur l'icône du menu de la vue sur la barre d'outils de la vue Test de l'agent pour accéder aux éléments de menu Définir l'environnement et Configuration, comme dans la sélection précédente.
   Pour plus d'informations sur l'utilisation des fenêtres Variables d'environnement et Configuration d'exécution, voir Test des groupes d'attributs.

   Important :

   1. L'agent est rempli automatiquement avec le dernier ensemble de configuration correspondant à chaque groupe d'attributs testé.
   2. Certaines variables d'environnement peuvent présenter des valeurs par défaut différentes pour le test de groupe d'attributs et le test complet de l'agent. Pour plus d'informations sur les variables d'environnement possédant des valeurs spéciales pour le test de groupe d'attributs (Variables d'environnement de test).
   3. Si une source de données JMX se connecte à un serveur WebSphere Application Server distant, assurez-vous qu'un serveur WebSphere Application Server local est installé et que l'emplacement Java est associé à l'environnement d'exécution Java utilisé par ce serveur. Pour plus de détails sur la configuration de la connexion, voir Surveillance de beans gérés (MBeans) JMX (Java Management Extensions).
   4. Dans une source de données SOAP, HTTP, JMX, JDBC ou API Java, vous pouvez utiliser le paramètre Java > Arguments JVM pour contrôler la consignation des traces d'agent. Définissez la valeur suivante :

      -DJAVA_TRACE_MAX_FILES=fichiers -DJAVA_TRACE_MAX_FILE_SIZE=taille

      où fichiers correspond au nombre maximal de fichiers journaux de trace conservés (valeur par défaut = 4) et taille correspond à la taille maximale des fichiers journaux en ko (valeur par défaut = 5 000). Par exemple, vous pouvez définir la valeur suivante :

      -DJAVA_TRACE_MAX_FILES=7 -DJAVA_TRACE_MAX_FILE_SIZE=100

      L'agent écrit alors 100 kilooctets dans le premier fichier journal, puis passe au second fichier journal, et ainsi de suite. Après avoir écrit sept fichiers journaux de 100 kilooctets chacun, l'agent écrase le premier fichier journal.
   5. Si, dans une version installée, votre agent comporte des sous-noeuds, vous pouvez définir des valeurs de configuration différentes pour chaque sous-noeud ainsi que des valeurs distinctes pour les groupes d'attributs de l'agent de base. Toutefois, dans une configuration de test d'agent complète, vous ne pouvez définir chaque valeur de configuration qu'une seule fois ; le paramètre s'applique à l'agent de base et à ses sous-noeuds. Vous ne pouvez tester qu'une instance de chaque sous-noeud.
3. Dans la vue Test de l'agent, sélectionnez l'agent que vous souhaitez tester, puis cliquez sur l'icône Démarrer l'agent.

   Une fenêtre indique que l'agent est en cours de démarrage. Lorsque l'agent démarre, ses groupes d'attributs sont affichés comme enfants de l'agent dans la vue Test de l'agent. Les groupes d'attributs sont signalés par l'icône de groupe d'attributs .

   Les groupes d'attributs de statut qui donnent des informations sur l'agent (Statut de l'objet de performances, Statut du pool d'unités d'exécution et Statut de l'action) sont affichés comme enfants de l'agent dans la vue Test de l'agent. Les groupes d'attributs de statut sont signalés par l'icône d'information .

   Vous pouvez démarrer et exécuter plusieurs agents en même temps.

   L'icône Arrêter l'agent devient disponible lors du démarrage de l'agent.

   Si votre agent comporte des sous-noeuds ou des groupes de navigation, ils sont affichés comme noeuds dans la vue Test de l'agent. Les définitions de sous-noeud s'affichent dans l'agent. Une instance de sous-noeud s'affiche dans le noeud de définition de sous-noeud. Des groupes d'attributs et des groupes de navigation apparaissent dans le noeud d'instance de sous-noeud. Par exemple :

   

   Vous pouvez cliquer avec le bouton droit de la souris sur l'un des noeuds de la vue Test de l'agent pour accéder aux sélections de menu telles que Editer et Arrêter l'agent. L'option Editer permet d'ouvrir la vue Définition de la source de données pour le noeud sélectionné dans l'éditeur d'agent.

   Remarque : Les modifications que vous apportez à l'éditeur d'agent ne sont pas visibles dans l'agent en cours d'exécution tant que vous ne l'avez pas arrêté puis redémarré.
4. Dans la vue Test de l'agent, sélectionnez le premier groupe d'attributs que vous souhaitez tester.
   Lors de la sélection d'un groupe d'attributs, la collecte de données commence pour le groupe d'attributs sélectionné. Si la collecte requiert un certain temps, une fenêtre indique que la collecte de données est en cours. Lorsque la collecte de données est terminée, les données collectées sont affichées dans la vue Test de groupe d'attributs, par exemple :

   

   Si aucune donnée ne s'affiche, un message indiquant0 ligne(s) de données renvoyée(s) apparaît dans la vue Test du groupe d'attributs. Le non renvoi d'informations par l'agent peut s'expliquer de diverses façons. Ces raisons sont notamment les suivantes :

   • Absence de données
   • Définition incorrecte
   • Configuration incorrecte

   Vous pouvez vérifier la raison pour laquelle aucune donnée n'est renvoyée en consultant la valeur du Code_Erreur dans le groupe d'attributs Statut de l'objet de performances. Pour plus d'informations sur l'affichage du groupe d'attributs Statut de l'objet de performances, voir l'étape 9.

   Pour collecter des données pour un autre groupe d'attributs dans l'agent en cours d'exécution, sélectionnez le groupe d'attributs voulu.

   Lorsque vous sélectionnez un groupe d'attributs dans la vue Test de l'agent, le groupe d'attributs correspondant est affiché dans la vue Editeur d'agent.
5. Facultatif : Pour certains types de groupe d'attributs, après la collecte initiale de données, vous devez lancer une seconde collecte de données pour obtenir des valeurs de données utiles.
   Pour exécuter une collecte de données, cliquez sur l'icône de collecte de données dans la vue Test du groupe d'attributs.

   Si la collecte requiert un certain temps, une fenêtre indique qu'une collecte de données est en cours. Lorsque la collecte de données est terminée, les données collectées sont affichées dans la vue Test du groupe d'attributs.

6. Facultatif : Cliquez sur un en-tête de colonne d'attribut dans la vue Test du groupe d'attributs pour ouvrir les Informations d'attribut dans l'onglet Définition de la source de données de l'éditeur d'agent. Vous pouvez également accéder à ces mêmes Informations d'attribut en cliquant avec le bouton droit de la souris sur une cellule de données dans la table et en choisissant Editer dans le menu.
   Vous pouvez modifier les propriétés de l'attribut normalement. Les modifications que vous apportez ne sont pas visibles dans l'agent en cours d'exécution tant que vous ne l'avez pas arrêté puis redémarré.
7. Facultatif : Vous pouvez ouvrir plusieurs vues Test du groupe d'attributs en même temps.
   Pour ouvrir une autre vue Test du groupe d'attributs, cliquez sur l'icône de menu de la vue sur la barre d'outils de la vue Test du groupe d'attributs, puis sélectionnez Ouvrir la vue pour le groupe d'attributs.

   Remarque : Lorsqu'une vue Test du groupe d'attributs supplémentaire est ouverte, elle affiche les mêmes informations d'attribut que la vue Test du groupe d'attributs initiale. Vous pouvez ensuite sélectionner un autre groupe d'attributs dans la vue Test de l'agent pour afficher les informations d'un groupe d'attributs différent dans la vue Test de groupe d'attributs originale. Lorsqu'une vue Test du groupe d'attributs supplémentaire est ouverte pour la première fois, elle s'ouvre au même emplacement que la vue initiale, mais dans un onglet différent. Pour afficher les deux vues simultanément, vous pouvez faire glisser l'onglet vers un autre emplacement dans l'espace de travail.
8. Facultatif : Si votre agent possède des sous-noeuds, vous pouvez sélectionner le groupe d'attributs d'informations pour l'instance de sous-noeud pour voir comment les sous-noeuds sont répertoriés dans votre agent (Figure 2). La sélection du groupe d'attributs d'informations pour l'instance de sous-noeud affiche les informations de l'instance de sous-noeud dans la vue Test de groupe d'attributs (pour tous les sous-noeuds en ligne du type sélectionné).
9. Facultatif : Pour consulter plus d'informations sur le fonctionnement de l'agent, vous pouvez sélectionner les groupes d'attributs Statut de l'objet de performances et Statut du pool d'unités d'exécution dans la vue Test de l'agent. Ces groupes d'attributs de statut sont signalés par l'icône d'informations . Sélectionnez ces groupes pour afficher les informations d'état sur les collectes de données précédentes des groupes d'attributs.
   Par exemple :

   

10. Une fois que vous avez fini de tester votre agent, cliquez sur l'icône d'arrêt de l'agent .