Configuration de l'infrastructure PMI (Performance Monitoring Infrastructure) à l'aide de scripts

L'outil wsadmin permet de configurer l'infrastructure PMI (Performance Monitoring Infrastructure) au sein de votre environnement. Cette infrastructure PMI permet au serveur de collecter des données de performances à partir de différents composants du produit. Elle fournit des informations sur les statistiques d'utilisation moyenne des ressources système, sans corrélation entre les données des différents composants.

Pourquoi et quand exécuter cette tâche

Il existe deux façons d'effectuer cette tâche. Grâce à la procédure détaillée dans cette rubrique, vous allez modifier la configuration de votre serveur à l'aide de l'objet AdminConfig. Mais vous pouvez aussi configurer l'infrastructure PMI à l'aide du script Jython configurePerformanceMonitoringService de la bibliothèque AdminServerManagement. Lorsque l'outil wsadmin démarre, il charge automatiquement le script. Pour configurer les paramètres PMI à l'aide du script configurePerformanceMonitoringService, respectez la syntaxe suivante :
AdminServerManagement.configurePerformanceMonitoringService(nodeName,
    serverName, enable, initialSpecLevel, otherAttributeList)
Pour plus d'informations et pour obtenir des définitions d'arguments, voir la documentation relative à la bibliothèque de scripts AdminServerMananagment.

Procédure

  1. Démarrez l'outil de scriptage wsadmin.
  2. Identifiez le serveur d'applications approprié.
    L'objet AdminConfig et la commande getid permettent d'extraire l'ID de configuration du serveur d'applications approprié. Attribuez ensuite cet ID à la variable s1. Exemple :
    • A l'aide de Jacl :
      set s1 [$AdminConfig getid /Cell:mycell/Node:mynode/Server:server1/]
    • Avec Jython :
      s1 = AdminConfig.getid('Cell:mycell/Node:mynode/Server:server1/') 
    Tableau 1. Description des éléments. Les commandes précédentes comprennent les éléments suivants :
    Elément Description
    set Commande Jacl
    s1 nom de variable ;
    $ Opérateur Jacl pour remplacer le nom d'une variable par la valeur correspondante
    AdminConfig Objet représentant la configuration du produit
    getid Commande AdminConfig
    Cell Attribut
    mycell Valeur de l'attribut Cell
    Node Attribut
    mynode Valeur de l'attribut Node
    Server Attribut
    server1 Valeur de l'attribut Server
    Exemple de sortie :
    server1(cells/mycell/nodes/mynode/servers/server1|server.xml#Server_1)
  3. Identifiez le service PMI qui appartient au serveur.
    L'objet AdminConfig et la commande list permettent d'identifier le service PMI. Attribuez ensuite ce service à la variable pmi. Exemple :
    • Avec Jacl :
      set pmi [$AdminConfig list PMIService $s1]
    • Avec Jython :
      pmi = AdminConfig.list('PMIService', s1)
      print pmi 
    Tableau 2. Description des éléments. Les commandes précédentes comprennent les éléments suivants :
    Elément Description
    set Commande Jacl
    pmi nom de variable ;
    $ Opérateur Jacl pour remplacer le nom d'une variable par la valeur correspondante
    AdminConfig Objet représentant la configuration du serveur d'applications
    list Commande AdminConfig
    PMIService Objet AdminConfig
    s1 Prend pour valeur l'ID du serveur d'applications concerné
    Exemple de sortie :
    (cells/mycell/nodes/mynode/servers/server1|server.xml#PMIService_1)
  4. Modifiez les attributs de la configuration de l'infrastructure PMI.
    L'objet AdminConfig et la commande modify permettent de modifier les attributs de la configuration de l'infrastructure PMI. Exemple :
    • Avec Jacl :
      $AdminConfig modify $pmi {{enable true} {statisticSet all}}
    • Avec Jython :
      AdminConfig.modify(pmi, [['enable', 'true'], ['statisticSet','all']]
    Cet exemple active le service PMI et définit les niveaux de spécification pour tous les composants du serveur.
    Important : Les valeurs des niveaux de spécification sont sensibles à la casse.
    Tableau 3. Description des niveaux de spécification. Les niveaux de spécification suivants sont valides pour les composants.
    Niveau de spécification Description
    Aucun Les statistiques ne sont pas activées.
    basic L'ensemble des statistiques indiquées dans Java Enterprise Edition (Java EE) et des grandes statistiques (comme le taux d'utilisation des microprocesseurs et le nombre de sessions HTTP actives) est activé. Cet ensemble est activé sans configuration et fournit des données de performances de base sur les composants d'exécution et les composants d'application.
    [IBM i][AIX Solaris HP-UX Linux Windows]étendu [IBM i][AIX Solaris HP-UX Linux Windows]L'ensemble des statistiques de base et des statistiques principales issues de différents composants du serveur d'applications (comme WLM et la mise en mémoire cache dynamique) est activé. Cet ensemble fournit des données de performances détaillées sur les différents composants exécutables et d'application.
    [z/OS]étendu [z/OS]L'ensemble des statistiques de base et des statistiques clés issues de différents composants du serveur d'applications (comme la mise en mémoire cache dynamique) est activé. Cet ensemble fournit des données de performances détaillées sur les différents composants exécutables et d'application.
    all Toutes les statistiques sont activées.
    custom Activez ou désactivez des statistiques sélectivement.
  5. Sauvegardez les modifications de configuration.
    Entrez l'exemple de commande suivante pour sauvegarder les modifications de configuration :
    AdminConfig.save()
  6. Dans un environnement de déploiement en réseau uniquement, synchronisez le noeud.
    Utilisez les scripts syncActiveNode ou syncNode de la bibliothèque de scripts AdminNodeManagement pour propager les modifications de configuration sur un ou plusieurs noeudsµµ.
    • Utilisez le script syncActiveNodes pour propager les modifications sur chacun des noeuds dans la cellule, comme dans l'exemple suivant :
      AdminNodeManagement.syncActiveNodes()
    • Utilisez le script syncNode pour propager les modifications sur un noeud spécifique, comme dans l'exemple suivant :
      AdminNodeManagement.syncNode("myNode")

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_pmi
Nom du fichier : txml_pmi.html