Vous pouvez utiliser l'infrastructure PMI
(Performance Monitoring Infrastructure) de WebSphere
Application Server pour activer ou
désactiver les statistiques à tout niveau. Par exemple, vous pouvez choisir
d'activer les statistiques du nombre d'occurrences d'une mappe donnée, mais non
le nombre de statistiques en entrée ou les statistiques de durée de mise à jour
par lots du chargeur. Vous pouvez activer PMI
dans la console d'administration ou à l'aide de scripts.
Avant de commencer
Votre serveur d'applications doit être démarré et une application
compatible
eXtreme Scale doit y être
installée. Pour activer PMI à l'aide de scripts, vous devez pouvoir vous
connecter et utiliser l'outil wsadmin. Pour plus d'informations sur l'outil
wsadmin, reportez-vous à la rubrique
Outil wsadmin, dans le Centre de documentation de
WebSphere
Application Server.
Pourquoi et quand exécuter cette tâche
Utilisez l'infrastructure PMI de
WebSphere
Application Server
pour fournir un mécanisme granulaire à l'aide duquel vous pouvez activer ou
désactiver les statistiques à tout niveau. Par exemple, vous pouvez choisir
d'activer les statistiques du nombre d'occurrences d'une mappe donnée, mais non
le nombre d'entrées ou les statistiques de durée de mise à jour par lots du
chargeur. Cette section montre comment utiliser la console d'administration et
les scripts wsadmin pour activer l'infrastructure PMI d'ObjectGrid.
Procédure
- Activez PMI dans la console d'administration.
- Dans la console d'administration, cliquez sur .
- Vérifiez que la case Activer l'infrastructure PMI (Performance Monitoring
Infrastructure) est cochée. Ce paramètre est activé par défaut. S'il ne l'est
pas, cochez la case et redémarrez le serveur.
- Cliquez sur Personnalisé. Dans l'arborescence de
configuration, sélectionnez l'ObjectGrid et le module Mappes d'ObjectGrid. Activez les
statistiques de chaque module.
La catégorie des types de transaction des statistiques ObjectGrid
est créée lors de la phase d'exécution. Vous ne pouvez voir que les
sous-catégories des statistiques ObjectGrid et des statistiques de mappe dans
la page Exécution.
- Activez PMI à l'aide de scripts.
- Ouvrez une invite de ligne de commande. Accédez au répertoire racine_was/bin.
Entrez wsadmin pour démarrer l'outil de ligne de commande wsadmin.
- Modifiez la configuration de l'environnement d'exécution de l'infrastructure PMI d'eXtreme Scale. Vérifiez que PMI est activé pour le serveur à l'aide des commandes suivantes :
wsadmin>set s1 [$AdminConfig getid /Cell:CELL_NAME/Node:NODE_NAME/
Server:APPLICATION_SERVER_NAME/]
wsadmin>set pmi [$AdminConfig list PMIService $s1]
wsadmin>$AdminConfig show $pmi.
Si PMI n'est pas activé,
exécutez les commandes suivantes pour activer PMI :
wsadmin>$AdminConfig modify $pmi {{enable true}}
wsadmin>$AdminConfig save
Si vous avez besoin d'activer PMI,
redémarrez le serveur.
- Définissez des variables pour modifier l'ensemble de statistiques en
ensemble personnalisé à l'aide des commandes suivantes :
wsadmin>set perfName [$AdminControl completeObjectName type=Perf,
process=APPLICATION_SERVER_NAME,*]
wsadmin>set perfOName [$AdminControl makeObjectName $perfName]
wsadmin>set params [java::new {java.lang.Object[]} 1]
wsadmin>$params set 0 [java::new java.lang.String custom]
wsadmin>set sigs [java::new {java.lang.String[]} 1]
wsadmin>$sigs set 0 java.lang.String
- Spécifiez un ensemble de statistiques personnalisé à l'aide de la
commande suivante :
wsadmin>$AdminControl invoke_jmx $perfOName setStatisticSet $params $sigs
- Définissez des variables pour activer les statistiques de l'infrastructure
PMI d'objectGridModule à l'aide des commandes suivantes :
wsadmin>set params [java::new {java.lang.Object[]} 2]
wsadmin>$params set 0 [java::new java.lang.String objectGridModule=1]
wsadmin>$params set 1 [java::new java.lang.Boolean false]
wsadmin>set sigs [java::new {java.lang.String[]} 2]
wsadmin>$sigs set 0 java.lang.String
wsadmin>$sigs set 1 java.lang.Boolean
- Définissez la chaîne des statistiques à l'aide de la commande suivante :
wsadmin>set params2 [java::new {java.lang.Object[]} 2]
wsadmin>$params2 set 0 [java::new java.lang.String mapModule=*]
wsadmin>$params2 set 1 [java::new java.lang.Boolean false]
wsadmin>set sigs2 [java::new {java.lang.String[]} 2]
wsadmin>$sigs2 set 0 java.lang.String
wsadmin>$sigs2 set 1 java.lang.Boolean
- Définissez la chaîne des statistiques à l'aide de la commande suivante :
wsadmin>$AdminControl invoke_jmx $perfOName setCustomSetString $params2 $sigs2
Ces étapes activent l'infrastructure PMI de l'environnement
d'exécution d'eXtreme Scale, mais ne
modifient pas la configuration de l'infrastructure PMI. Si vous redémarrez l'application,
les paramètres PMI sont perdus, exceptée l'activation principale de PMI.
Exemple
Vous pouvez effectuer les étapes suivantes pour activer les
statistiques PMI de l'exemple d'application :
- Lancez l'application à l'aide de l'adresse Web
http://hôte:port/ObjectGridSample, hôte et port correspondant
au nom d'hôte et au numéro de port HTTP du serveur où l'exemple est installé.
- Dans l'exemple d'application, cliquez sur ObjectGridCreationServlet,
puis sur les boutons d'action 1, 2, 3, 4 et 5 pour générer des actions sur
l'ObjectGrid et les mappes. Ne fermez pas tout de suite cette page de servlet.
- Dans la console d'administration, cliquez sur
.
Cliquez sur l'onglet Exécution.
- Cliquez sur le bouton d'option Personnalisé.
- Développez le module Mappes d'ObjectGrid dans l'arborescence d'exécution,
puis cliquez sur le lien clusterObjectGrid. Le groupe Mappes d'ObjectGrid
contient une instance ObjectGrid appelée clusterObjectGrid et le groupe
clusterObjectGrid contient quatre mappes : counters, employees, offices,
et sites. Dans l'instance ObjectGrids se trouve une instance clusterObjectGrid
et sous cette instance, le type de transaction DEFAULT.
- Vous pouvez activer les statistiques de votre choix. Par exemple,
vous pouvez activer le nombre d'entrées de mappe pour la mappe des employés et
le temps de réponse des transactions pour le type de transaction DEFAULT.
Que faire ensuite
Une fois que PMI est activé, vous pouvez afficher les statistiques PMI
à l'aide de la console d'administration ou de scripts.