Lista de MBeans proporcionados
Liberty proporciona una lista de MBeans y las interfaces de gestión correspondientes que puede utilizar para manipular y supervisar el servidor.
- 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
- El nombre es el valor de javax.management.ObjectName que identifica de forma única el MBean o MXBean. Cuando hay varias instancias de un MBean o MXBean, el valor de ObjectName puede contener un comodín (*), que se describe en las entradas de Comentarios de este tema.
- Las entradas de Interfaz de gestión especifican el nombre de la interfaz Java™ que puede utilizarse para construir un objeto proxy para el MBean o MXBean tal como se describe en Liberty: Ejemplos de acceso a atributos y operaciones de MBean. Para obtener más información sobre la interfaz de gestión, consulte el documento de la API Java para Liberty. La documentación de la API Java para cada API Liberty está disponible en un archivo .zip separado en uno de los subdirectorios javadoc del directorio ${wlp.install.dir}/dev.
WebSphere:feature=channelfw,type=endpoint,name=*
- Interfaz de gestión: com.ibm.websphere.endpoint.EndPointInfoMBean
- Comentarios: hay disponible una instancia para cada punto final del sistema, donde * es un nombre de punto final único.
WebSphere:feature=jaxws,type=WebServiceStats,service=*,port=*
- Interfaz de gestión: org.apache.cxf.management.counters.ResponseTimeCounterMBean
- Comentarios: disponible cuando la característica monitor-1.0 está habilitada. WebServiceStats puede ser Performance.Counter.Server o Performance.Counter.client, donde service=* es el nombre calificado de un punto final de servicio, port=* es el nombre de puerto del punto final de servicio. Consulte Liberty: Supervisión de JAX-WS.
WebSphere:feature=jaxws,type=Bus.Service.Endpoint,bus.id=*,service=*,port=*,name=*
- Interfaz de gestión: org.apache.cxf.endpoint.ManagedEndpoint
- Comentarios: disponible cuando está habilitada la característica localConnector-1.0 o restConnector-1.0
y se accede como mínimo una vez a la aplicación JAX-WS. bus.id=* es el nombre del bus, donde * tiene el formato <nombre aplic.>-Server-Bus.
service=* es el nombre calificado del punto final,
donde * tiene el formato {EspacioNombresServicio}NombreServicio.
port=* es el nombre de puerto del punto final,
donde * es el nombre de puerto actual. El formato del MBean es el siguiente: <BUS>@<SERVICE>@<PORT>@<URL_PATTERN>, donde:
- <BUS> tiene el mismo valor que el campo bus.id;
- <SERVICE> tiene el mismo valor que el campo service;
- <PORT> tiene el mismo valor que el campo port;
- <URL_PATTERN> puede tener los valores siguientes en distintos casos;
- Si el elemento url-pattern se define en el archivo
web.xml de la aplicación, se utiliza el valor del elemento
url-pattern. Por ejemplo, el elemento url-pattern es
/SayHelloURL en el archivo web.xml:
Por ejemplo, el MBean podría ser el siguiente:<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 el patrón de URL no se especifica, se utiliza el nombre de servicio como valor
predeterminado. Por ejemplo, el MBean podría ser el siguiente:
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 el motor de servicios web no puede recuperar el patrón de URL al registrar el
MBean de punto final, se utiliza un número exclusivo al azar para garantizar que el MBean
es exclusivo. Por ejemplo, el MBean podría ser el siguiente:
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 el elemento url-pattern se define en el archivo
web.xml de la aplicación, se utiliza el valor del elemento
url-pattern. Por ejemplo, el elemento url-pattern es
/SayHelloURL en el archivo web.xml:
- Esto es un MBean de modelo dinámico.
- La operación destroy no se admite en este MBean.
WebSphere:feature=kernel,name=ServerInfo
- Interfaz de gestión: com.ibm.websphere.kernel.server.ServerInfoMBean
- Comentarios: se utiliza la interfaz ServerInfoMbean para recuperar información sobre el
servidor en ejecución. Busque en los directorios siguientes la clase y la documentación de API:
dir_inicio_liberty/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_versión-javadoc.zip
dir_inicio_liberty/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_versión.jar
Las operaciones expuestas incluyen un método para recuperar la instalación del producto y las ubicaciones de directorio de usuario, el nombre de host predeterminado, el nombre del servidor, la versión del producto, la versión de la especificación de Java y la versión de Java Runtime.
WebSphere:feature=restConnector,type=FileService,name=FileService
- Interfaz de gestión: com.ibm.websphere.filetransfer.FileServiceMXBean
- Comentarios: este MXBean permite realizar varias operaciones relacionadas con archivo
en el host donde reside Liberty. Puede encontrar su clase y la documentación de la API en las ubicaciones siguientes:
dir_inicio_liberty/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_versión.jar dir_inicio_liberty/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_versión-javadoc.zip
Las operaciones expuestas incluyen la capacidad de consultar determinados metadatos (última fecha de modificación, tamaño, etc.) para un archivo o directorio particular y, también, para consultar todos los archivos hijo (y metadatos correspondientes) para un directorio concreto. El soporte para la creación y expansión de archivo también se proporciona, lo que puede ser útil para comprimir archivos de registro Liberty o para extraer una aplicación antes de que se despliegue.
Este MXBean contiene dos atributos: la lista de lectura y la lista de escritura. Representan las listas de ubicaciones que pueden leer o escribir usuarios al utilizar las prestaciones FileService o FileTransfer proporcionadas por Liberty. Mediante el MXBean, estos atributos solo se pueden leer, pero se pueden configurar o personalizar a través de los elementos siguientes en el archivo server.xml:
Si no se especifica el elemento readDir, el valor predeterminado es la combinación de: ${wlp.install.dir}, ${wlp.user.dir} y ${server.output.dir}. Si no se especifica un elemento writeDir, el valor predeterminado es la serie vacía.<remoteFileAccess> <readDir>${server.output.dir}/logs</readDir> <readDir>${server.output.dir}/apps</readDir> <writeDir>${server.output.dir}/dropins</writeDir> </remoteFileAccess>
Se debe incluir la característica restConnector-1.0 en el archivo server.xml para que este MXBean se cargue y respete sus elementos de configuración
El uso de variables definidas por Liberty está permitido con todos los parámetros del lado del servidor que toman una serie que representa una vía de acceso de archivo. Tales variables se definen en el archivo inicio_liberty/README.TXT.
WebSphere:feature=restConnector,type=FileTransfer,name=FileTransfer
- Interfaz de gestión: com.ibm.websphere.filetransfer.FileTransferMBean
- Comentarios: este MBean permite realizar varias operaciones de transferencia de archivos
en el host donde reside Liberty. Puede encontrar su clase y la documentación de la API en las ubicaciones siguientes:
dir_inicio_liberty/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_versión.jar dir_inicio_liberty/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_versión-javadoc.zip
Este MBean se registra en el PlatformMBeanServer desde la misma JVM en que se ejecuta su proceso Liberty correspondiente, pero solo se puede acceder a él mediante el conector JMX REST de IBM®. La conexión puede ser local o remota, pero se debe utilizar el conector REST.
Las operaciones expuestas incluyen la capacidad de descargar, cargar y suprimir archivos. Cada solicitud de lectura y grabación en el servidor se enlaza a las listas de lectura y escritura configurables a las que se accede mediante FileServiceMXBean. Se puede acceder completamente a FileTransferMBean y operar con este último desde la JConsole Java incorporada, siempre que la JConsole esté conectada mediante el conector JMX REST de IBM.
El uso de variables definidas por Liberty está permitido con todos los parámetros del lado del servidor que toman una serie que representa una vía de acceso de archivo. Tales variables se definen en el archivo inicio_liberty/README.TXT.
WebSphere:feature=wasJmsServer,type=MessagingEngine,name=*
- Interfaz de gestión: com.ibm.websphere.messaging.mbean.MessagingEngineMBean
- Comentarios: disponible cuando la característica wasJmsServer-1.0 está habilitada. Hay disponible una instancia de motor de mensajería para cada Liberty. name=* es el nombre del MBean, donde * es el nombre exclusivo del MBean de motor de mensajería. Consulte Liberty:JMS messaging.
WebSphere:feature=wasJmsServer,type=Queue,name=*
- Interfaz de gestión: com.ibm.websphere.messaging.mbean.QueueMBean
- Comentarios: el MBean está disponible cuando está habilitada la característica wasJmsServer-1.0 y está disponible el MBean del motor de mensajería. name=* es el nombre del MBean, donde * es el nombre del MBean de cola. Consulte Liberty:JMS messaging.
WebSphere:feature=wasJmsServer,type=Subscriber,name=*
- Interfaz de gestión: com.ibm.websphere.messaging.mbean.SubscriberMBean
- Comentarios: el MBean está disponible cuando está habilitada la característica wasJmsServer-1.0 y está disponible el MBean del motor de mensajería. name=* es el nombre del MBean, donde * es el nombre del MBean de suscriptor.
WebSphere:feature=wasJmsServer,type=Topic,name=*
- Interfaz de gestión: com.ibm.websphere.messaging.mbean.TopicMBean
- Comentarios: el MBean está disponible cuando está habilitada la característica wasJmsServer-1.0 y está disponible el MBean del motor de mensajería. name=* es el nombre del MBean, donde * es el nombre del MBean de tema. Consulte Liberty:JMS messaging.
WebSphere:name=com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- Interfaz de gestión: com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- Comentarios: El ServerXMLConfigurationMBean proporciona una interfaz para recuperar las vías de acceso de todos los archivos de
configuración del servidor conocidos para el servidor. El MBean está disponible en el kernel, por lo que no es necesario habilitar una característica especial. Puede encontrar la clase y la documentación de API
del MBean en las ubicaciones siguientes:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_versión.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_versión-javadoc.zip
WebSphere:name=com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- Interfaz de gestión: com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- Comentarios: El RuntimeUpdateNotificationMBean proporciona notificaciones de actualizaciones de tiempo de ejecución del servidor. El objeto de datos de usuario conectado a la notificación es un java.util.Map. El tipo de notificación para las notificaciones de actualización de tiempo de ejecución que han sido emitidas por este MBean es com.ibm.websphere.runtime.update.notification.
WebSphere:name=com.ibm.ws.config.mbeans.FeatureListMBean
- Interfaz de gestión: com.ibm.websphere.config.mbeans.FeatureListMBean
- Comentarios FeatureListMBean expone un único método para generar un informe XML sobre todas las características instaladas en tiempo de
ejecución.
El MBean está disponible en el kernel, por lo que no es necesario habilitar una característica especial. Puede encontrar la clase y la documentación de API del MBean en las ubicaciones siguientes:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_versión.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_versión-javadoc.zip
WebSphere:name=com.ibm.ws.config.serverSchemaGenerator
- Interfaz de gestión: com.ibm.websphere.config.mbeans.ServerSchemaGenerator
- Comentarios: el MBean ServerSchemaGenerator expone métodos para generar el esquema a partir de la imagen instalada, el método más
utilizado o desde un tiempo de ejecución actual. El MBean está disponible en el kernel, por lo que no es necesario habilitar una característica especial. Puede encontrar la clase y la documentación de API del MBean en las ubicaciones siguientes:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_versión.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_versión-javadoc.zip
WebSphere:name=com.ibm.ws.jmx.mbeans.generatePluginConfig
- Interfaz de gestión: com.ibm.websphere.webcontainer.GeneratePluginConfigMBean
- Comentarios: consulte Adición de una configuración de plug-in a un servidor web.
WebSphere:service=com.ibm.websphere.application.ApplicationMBean,name=*
- Interfaz de gestión: com.ibm.websphere.application.ApplicationMBean
- Comentarios: hay disponible una instancia para cada aplicación en el sistema, donde * es un nombre de aplicación exclusivo.
WebSphere:service=com.ibm.websphere.webcontainer.WebModuleMBean,application=*,name=*
- Interfaz de gestión: com.ibm.websphere.webcontainer.WebModuleMBean
- Comentarios: Está disponible una instancia para cada WebModule del sistema, donde application=* es el nombre de una aplicación del sistema y name=* es el nombre de un módulo web en dicha aplicación.
WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,*
- Interfaz de gestión: com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean
- Comentarios: hay disponible una instancia para cada gestor de conexiones del
sistema, incluidos los creados en los contextos siguientes:
- Cuando se configura explícitamente en la configuración del servidor
- Cuando se crea implícitamente debido a anotaciones @DataSourceDefinition o @ConnectionFactoryDefinition
- Cuando se crea como resultado de una fábrica de conexiones o del origen de datos en la configuración del servidor
Para reducir la instancia del gestor de conexiones, puede especificar atributos adicionales, como los que se muestran en los ejemplos siguientes: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
- Interfaz de gestión: com.ibm.websphere.filemonitor.FileNotificationMBean
WebSphere:type=JvmStats
- Interfaz de gestión: com.ibm.websphere.monitor.jmx.JvmMXBean
- Comentarios: disponible cuando la característica monitor-1.0 está habilitada. Consulte Liberty: Supervisión de JVM.
WebSphere:type=ServletStats,name=*
- Interfaz de gestión: com.ibm.websphere.webcontainer.ServletStatsMXBean
- Comentarios: Cuando la característica monitor-1.0 está habilitada, está disponible una instancia para cada servlet a la que se sirve, donde * tiene el formato <Nombre_aplicación>.<Nombre_servlet>. Consulte Liberty: Supervisión de aplicaciones web.
WebSphere:type=ThreadPoolStats,name=Default Executor
- Interfaz de gestión: com.ibm.websphere.monitor.jmx.ThreadPoolMXBean
- Comentarios: disponible cuando la característica monitor-1.0 está habilitada. Consulte Liberty: Supervisión de ThreadPool.