Liste des MBeans fournis
Liberty fournit une liste de beans gérés et d'interfaces de gestion correspondantes que vous pouvez utiliser pour manipuler et surveiller le serveur.
- WebSphere:feature=channelfw,type=endpoint,name=*
- WebSphere:feature=jaxws,type=WebServiceStats,service=*,port=*
- WebSphere:feature=jaxws,type=Bus.Service.Endpoint,bus.id=*,service=*,port=*,name=*
- WebSphere:feature=kernel,name=ServerInfo
- WebSphere:feature=restConnector,type=FileService,name=FileService
- WebSphere:feature=restConnector,type=FileTransfer,name=FileTransfer
- WebSphere:feature=wasJmsServer,type=MessagingEngine,name=*
- WebSphere:feature=wasJmsServer,type=Queue,name=*
- WebSphere:feature=wasJmsServer,type=Subscriber,name=*
- WebSphere:feature=wasJmsServer,type=Topic,name=*
- WebSphere:name=com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- WebSphere:name=com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- WebSphere:name=com.ibm.ws.config.mbeans.FeatureListMBean
- WebSphere:name=com.ibm.ws.config.serverSchemaGenerator
- WebSphere:name=com.ibm.ws.jmx.mbeans.generatePluginConfig
- WebSphere:service=com.ibm.websphere.application.ApplicationMBean,name=*
- WebSphere:service=com.ibm.websphere.webcontainer.WebModuleMBean,application=*,name=*
- WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,*
- WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean
- WebSphere:type=JvmStats
- WebSphere:type=ServletStats,name=*
- WebSphere:type=ThreadPoolStats,name=Default Executor
- WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean
- Le nom est la valeur javax.management.ObjectName qui identifie de façon unique le bean géré ou le MXBean. Lorsqu'il existe plusieurs instances d'un bean géré ou d'un MXBean, la valeur ObjectName peut contenir un caractère générique (*) qui est décrit dans les entrées Commentaires de cette rubrique.
- Les entrées Interface de gestion spécifient le nom de l'interface Java™ qui peut être utilisée pour construire un objet proxy pour le bean géré ou le MXBean comme décrit dans Liberty : Exemples d'accès aux opérations et aux attributs de bean géré. Pour plus d'informations sur l'interface de gestion, voir le document de l'API Java pour Liberty. La documentation d'API Java de chaque API Liberty est disponible dans un fichier .zip séparé des sous-répertoires javadoc du répertoire ${wlp.install.dir}/dev.
WebSphere:feature=channelfw,type=endpoint,name=*
- Interface de gestion : com.ibm.websphere.endpoint.EndPointInfoMBean
- Commentaires : Une instance est disponible pour chaque noeud final sur le système, où * est un nom de noeud final unique.
WebSphere:feature=jaxws,type=WebServiceStats,service=*,port=*
- Interface de gestion : org.apache.cxf.management.counters.ResponseTimeCounterMBean
- Commentaires : Disponible lorsque la fonction monitor-1.0 est activée. WebServiceStats peut être Performance.Counter.Server ou Performance.Counter.client, où service=* est le nom qualifié d'un noeud final de service et port=* est le nom de port du noeud final de service. Voir Liberty : Surveillance JAX-WS.
WebSphere:feature=jaxws,type=Bus.Service.Endpoint,bus.id=*,service=*,port=*,name=*
- Interface de gestion : org.apache.cxf.endpoint.ManagedEndpoint
- Commentaires : Disponible lorsque la fonction
localConnector-1.0 ou
restConnector-1.0 est activée et que l'accès à
l'application JAX-WS a lieu une fois au moins. bus.id=* est le nom du bus, où
* est au format
<NomApp>-Server-Bus. service=* est le nom qualifié du noeud final, où * est au format {EspaceNomService}NomService.
port=* est le nom de port du noeud final, où * est le nom de port courant. Le format de MBean est le suivant :
<BUS>@<SERVICE>@<PORT>@<URL_PATTERN>,
où :
- <BUS> a la même valeur que la zone bus.id;
- <SERVICE> a la même valeur que la zone service;
- <PORT> a la même valeur que la zone port;
- <URL_PATTERN> peut avoir les valeurs
suivantes dans différents scénarios ;
- Si l'élément url-pattern est défini dans le fichier
web.xml
de votre application, la valeur de l'élément
url-pattern
est utilisée. Par exemple, l'élément url-pattern est /SayHelloURL dans
le fichier web.xml :
Par exemple, le MBean peut être comme suit:<servlet-mapping> <servlet-name>com.ibm.ws.jaxws.test.jmx.service.WSTestEndpointService</servlet-name> <url-pattern>/SayHelloURL</url-pattern> </servlet-mapping>
WebSphere:feature=jaxws,bus.id=EJBWSBasic-Server-Bus,type=Bus.Service.Endpoint, service="{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService",port="SayHelloPort", name="EJBWSBasic-Server-Bus@{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService@SayHelloPort@SayHelloURL"
- Si le masque d'URL n'est pas indiqué, le nom du service est utilisé comme valeur par défaut. Par exemple, le MBean peut être comme
suit:
WebSphere:feature=jaxws,bus.id=EJBWSBasic-Server-Bus,type=Bus.Service.Endpoint, service="{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService",port="SayHelloPort", name="EJBWSBasic-Server-Bus@{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService@SayHelloPort@SayHelloService
- Si le masque d'URL ne peut pas être extrait par le moteur de services Web
lorsque le noeud géré de noeud final est enregistré, un nombre aléatoire unique est utilisé
pour garantir que le noeud géré est unique. Par exemple, le MBean peut être comme
suit:
WebSphere:feature=jaxws,bus.id=EJBWSBasic-Server-Bus,type=Bus.Service.Endpoint, service="{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService",port="SayHelloPort", name="EJBWSBasic-Server-Bus@{http://ejbbasic.jaxws.ws.ibm.com/}SayHelloService@SayHelloPort@261689241"
- Si l'élément url-pattern est défini dans le fichier
web.xml
de votre application, la valeur de l'élément
url-pattern
est utilisée. Par exemple, l'élément url-pattern est /SayHelloURL dans
le fichier web.xml :
- Il s'agit d'un bean géré de modèle dynamique.
- L'opération destroy sur ce MBean n'est pas prise en charge.
WebSphere:feature=kernel,name=ServerInfo
- Interface de gestion : com.ibm.websphere.kernel.server.ServerInfoMBean
- Commentaires : L'interface ServerInfoMbean est utilisée pour extraire des informations sur le serveur en cours. Recherchez les répertoires suivants pour la classe et la
documentation d'API :
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar
Les opérations exposées incluent une méthode permettant d'extraire l'installation du produit et les emplacements du répertoire utilisateur, le nom d'hôte par défaut, le nom de serveur, la version de produit, la version de la spécification Java et la version Java Runtime.
WebSphere:feature=restConnector,type=FileService,name=FileService
- Interface de gestion : com.ibm.websphere.filetransfer.FileServiceMXBean
- Commentaires : Ce MXBean permet d'effectuer diverses opérations liées aux fichiers sur l'hôte sur lequel se trouve Liberty. Vous trouverez sa classe et la documentation de l'API aux emplacements suivants :
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_version.jar liberty_home/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_version-javadoc.zip
Les opérations exposées incluent la capacité à interroger certaines métadonnées (la date de dernière modification, la taille, etc.) d'un fichier ou répertoire donné, ainsi que d'interroger tous les fichiers enfant (et les métadonnées correspondantes) d'un répertoire donné. La prise en charge de la création et de la décompression d'archive est également fournie, ce qui peut être utile pour compresser des fichiers journaux Liberty ou pour extraire une application avant de la déployer.
Ce MXBean contient deux attributs : la liste de lecture et la liste d'écriture. Il s'agit de la liste des emplacements où les utilisateurs disposent d'un accès en lecture et écriture lors de l'utilisation des fonctionnalités FileService ou FileTransfer fournies par Liberty. Via le MXBean, ces attributs ne sont accessibles qu'en lecture, mais vous pouvez les configurer et les personnaliser par le biais des éléments suivants dans le fichier server.xml :
Si l'élément readDir n'est pas spécifié, la valeur par défaut est la combinaison de ${wlp.install.dir}, ${wlp.user.dir} et ${server.output.dir}. Si aucun élément writeDir n'est spécifié, la valeur par défaut est l'ensemble vide.<remoteFileAccess> <readDir>${server.output.dir}/logs</readDir> <readDir>${server.output.dir}/apps</readDir> <writeDir>${server.output.dir}/dropins</writeDir> </remoteFileAccess>
La fonction restConnector-1.0 doit être incluse dans le fichier server.xml pour que ce MXBean soit chargé et que ses éléments de configuration soient appliqués.
L'utilisation de variables définies par Liberty est autorisée avec tous les paramètres côté serveur qui admettent une chaîne représentant un chemin de fichier. Ces variables sont définies dans le fichier rép_base_liberty/README.TXT.
WebSphere:feature=restConnector,type=FileTransfer,name=FileTransfer
- Interface de gestion : com.ibm.websphere.filetransfer.FileTransferMBean
- Commentaires : Ce bean géré permet d'exécuter diverses opérations de transfert de fichier sur l'hôte sur lequel se trouve Liberty. Vous trouverez sa classe et la documentation de l'API aux emplacements suivants :
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_version.jar liberty_home/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_version-javadoc.zip
Ce bean géré est enregistré sur PlatformMBeanServer à partir de la même machine virtuelle Java que son processus Liberty correspondant, mais il n'est accessible que via le connecteur IBM® JMX REST. La connexion peut être locale ou distante, mais dans tous les cas, le connecteur REST doit être utilisé.
Les opérations exposées incluent la capacité de télécharger, télécharger en amont et supprimer un fichier. Chaque demande de lecture et d'écriture sur le serveur est liée aux listes de lecture et d'écriture configurables accessibles via FileServiceMXBean. FileTransferMBean est également accessible et peut être utilisé depuis la console Java intégrée JConsole, à condition que celle-ci soit connectée via le connecteur IBM JMX REST.
L'utilisation de variables définies par Liberty est autorisée avec tous les paramètres côté serveur qui admettent une chaîne représentant un chemin de fichier. Ces variables sont définies dans le fichier rép_base_liberty/README.TXT.
WebSphere:feature=wasJmsServer,type=MessagingEngine,name=*
- Interface de gestion : com.ibm.websphere.messaging.mbean.MessagingEngineMBean
- Commentaires : Disponible lorsque la fonction wasJmsServer-1.0 est activée. Une instance de moteur de messagerie est disponible pour chaque serveur Liberty. name=* est le nom du bean géré, où * est le nom unique du bean géré de moteur de messagerie. Voir Liberty : Messagerie JMS.
WebSphere:feature=wasJmsServer,type=Queue,name=*
- Interface de gestion : com.ibm.websphere.messaging.mbean.QueueMBean
- Commentaires : Le bean géré est disponible lorsque la fonction wasJmsServer-1.0 est activée et que le bean géré du moteur de messagerie est disponible. name=* est le nom du bean géré, où * est le nom du bean géré de file d'attente. Voir Liberty : Messagerie JMS.
WebSphere:feature=wasJmsServer,type=Subscriber,name=*
- Interface de gestion : com.ibm.websphere.messaging.mbean.SubscriberMBean
- Commentaires : Le bean géré est disponible lorsque la
fonction wasJmsServer-1.0
est activée et que le bean géré du moteur de messagerie est
disponible. name=* est le nom du bean géré, où * est le nom du bean géré d'abonné courant.Remarque : SubscriberMBean est un abonné au bean géré de rubrique TopicMBean existant. Voir Liberty : Messagerie JMS.
WebSphere:feature=wasJmsServer,type=Topic,name=*
- Interface de gestion : com.ibm.websphere.messaging.mbean.TopicMBean
- Commentaires : Le bean géré est disponible lorsque la fonction wasJmsServer-1.0 est activée et que le bean géré du moteur de messagerie est disponible. name=* est le nom du bean géré, où * est le nom du bean géré de rubrique. Voir Liberty : Messagerie JMS.
WebSphere:name=com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- Interface de gestion : com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- Commentaires : L'élément ServerXMLConfigurationMBean fournit une interface
pour l'extraction des chemins de fichier de tous les fichiers de configuration du serveur connus
du serveur. Le bean géré étant accessible depuis le noyau, vous n'avez pas besoin
d'activer une fonction spéciale. Vous trouverez la classe du bean géré et la documentation de l'API aux emplacements suivants :
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_version-javadoc.zip
WebSphere:name=com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- Interface de gestion : com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- Commentaires : L'élément RuntimeUpdateNotificationMBean fournit des notifications pour les mises à jour d'exécution de serveur. L'objet de données utilisateur associé à la notification est un élément java.util.Map. Le type de notification pour les notifications de mise à jour d'exécution émises par ce bean géré est le suivant : com.ibm.websphere.runtime.update.notification.
WebSphere:name=com.ibm.ws.config.mbeans.FeatureListMBean
- Interface de gestion : com.ibm.websphere.config.mbeans.FeatureListMBean
- Commentaires : L'élément FeatureListMBean expose une seule méthode
pour générer un rapport XML sur toutes les fonctions installées lors
de l'exécution. Le bean géré étant accessible depuis le noyau, vous n'avez pas besoin
d'activer une fonction spéciale. Vous trouverez la classe du bean géré et la documentation de l'API aux emplacements suivants :
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_version-javadoc.zip
WebSphere:name=com.ibm.ws.config.serverSchemaGenerator
- Interface de gestion : com.ibm.websphere.config.mbeans.ServerSchemaGenerator
- Commentaires : Le bean géré ServerSchemaGenerator MBean expose des méthodes
pour générer un schéma à partir de l'image installée, la plupart du temps, ou à partir d'une exécution en cours. Le bean géré étant accessible depuis le noyau, vous n'avez pas besoin
d'activer une fonction spéciale. Vous trouverez la classe du bean géré et la documentation de l'API aux emplacements suivants :
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_version-javadoc.zip
WebSphere:name=com.ibm.ws.jmx.mbeans.generatePluginConfig
- Interface de gestion : com.ibm.websphere.webcontainer.GeneratePluginConfigMBean
- Commentaires : Voir Ajout d'une configuration de plug-in à un serveur Web.
WebSphere:service=com.ibm.websphere.application.ApplicationMBean,name=*
- Interface de gestion : com.ibm.websphere.application.ApplicationMBean
- Commentaires : Une instance est disponible pour chaque application sur le système, où * est un nom d'application unique.
WebSphere:service=com.ibm.websphere.webcontainer.WebModuleMBean,application=*,name=*
- Interface de gestion : com.ibm.websphere.webcontainer.WebModuleMBean
- Commentaires : Une instance est disponible pour chaque module Web dans le système, où application=* est le nom d'une application dans le système et name=* le nom d'un module Web dans cette application.
WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,*
- Interface de gestion :com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean
- Commentaires : Une instance est disponible pour chaque gestionnaire de connexion dans le système, y compris ceux ayant été créés dans les contextes suivants :
- Lorsque configurés explicitement dans la configuration du serveur
- Lorsque créés implicitement en raison des annotations @DataSourceDefinition ou @ConnectionFactoryDefinition
- Lorsque créés comme résultat d'une fabrique de connexions ou de source de données dans la configuration du serveur
Pour limiter l'instance du gestionnaire de connexions, vous pouvez spécifier des attributs supplémentaires, comme illustré dans les exemples suivants :WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=jdbc/db2,* WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=jmsConnectionFactory[cf1]/connectionManager[default-0],* WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=databaseStore[dbstore1]/dataSource[default-0]/connectionManager,* WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=java.module/env/jdbc/ds3,application=MyApp,module=myweb,*
WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean
- Interface de gestion : com.ibm.websphere.filemonitor.FileNotificationMBean
WebSphere:type=JvmStats
- Interface de gestion : com.ibm.websphere.monitor.jmx.JvmMXBean
- Commentaires : Disponible lorsque la fonction monitor-1.0 est activée. Voir Liberty : Surveillance de la machine virtuelle Java.
WebSphere:type=ServletStats,name=*
- Interface de gestion : com.ibm.websphere.webcontainer.ServletStatsMXBean
- Commentaires : Lorsque la fonction monitor-1.0 est activée, une instance est disponible pour chaque servlet traité, où * suit le format <nom_application>.<nom_servlet>. Voir Liberty : Surveillance des applications Web.
WebSphere:type=ThreadPoolStats,name=Default Executor
- Interface de gestion : com.ibm.websphere.monitor.jmx.ThreadPoolMXBean
- Commentaires : Disponible lorsque la fonction monitor-1.0 est activée. Voir Liberty : Surveillance dy pool d'unités d'exécution.