所提供 MBean 的列表
Liberty 提供了您可以用来处理和监视服务器的 MBean 以及相应管理接口的列表。使用 MBean 代理时,在 ${wlp.install.dir}/dev/api/ibm 下的 .jar 文件中查找您需要编译的类。
- 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=kernel,name=ServerEndpointControl
- 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:type=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
- 名称是用来唯一标识 MBean 或 MXBean 的 javax.management.ObjectName 值。如果存在 MBean 或 MXBean 的多个实例,那么 ObjectName 值可以包含通配符 (*),在本主题的注释条目中对此进行了描述。
- 管理接口条目指定可以用来构造 MBean 或 MXBean 的代理对象(如 访问 MBean 属性和操作的示例中所述)的 Java 接口的名称。有关管理接口的更多信息,请参阅 Liberty 的 Java API 文档。每个 Liberty API 的 Java API 文档均可以在 ${wlp.install.dir}/dev 目录的某个 javadoc 子目录下的单独 .zip 文件中找到。
WebSphere:feature=channelfw,type=endpoint,name=*
- 管理接口: com.ibm.websphere.endpoint.EndPointInfoMBean
- 注释:为系统中的每个端点都提供了一个实例,其中 * 是唯一的端点名称。
WebSphere:feature=jaxws,type=WebServiceStats,service=*,port=*
- 管理接口: org.apache.cxf.management.counters.ResponseTimeCounterMBean
- 注释:启用 monitor-1.0 功能部件后可用。WebServiceStats 可为 Performance.Counter.Server 或者 Performance.Counter.client,其中 service=* 是服务端点的限定名,port=* 是服务端点的端口名。请参阅JAX-WS 监视。
WebSphere:feature=jaxws,type=Bus.Service.Endpoint,bus.id=*,service=*,port=*,name=*
- 管理接口:org.apache.cxf.endpoint.ManagedEndpoint
- 注释:当启用了 localConnector-1.0 或 restConnector-1.0 功能部件并且至少访问了 JAX-WS 应用程序一次时可用。bus.id=* 是总线的名称,其中 * 的格式为 <AppName>-Server-Bus。service=* 是端点的限定名,其中 * 的格式为 {ServiceNamespace}ServiceName。port=* 是端点的端口名,其中 * 是当前端口名。MBean 的格式如下所示:<BUS>@<SERVICE>@<PORT>@<URL_PATTERN>,其中:
- <BUS> 的值与字段 bus.id 的值相同;
- <SERVICE> 的值与字段 service 的值相同;
- <PORT> 的值与字段 port 的值相同;
- <URL_PATTERN> 可能为以下值(在不同场景中);
- 如果 url-pattern 元素是在应用程序的 web.xml 文件中定义的,那么使用 url-pattern 元素的值。例如,url-pattern 元素在 web.xml
文件中为 /SayHelloURL:
例如,MBean 可能为如下所示:<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"
- 如果未指定 URL 模式,那么将服务名用作缺省值。例如,MBean 可能为如下所示:
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
- 如果注册端点 MBean 时 Web Service 引擎无法检索该 URL 模式,那么使用随机唯一序号以确保 MBean 唯一。例如,MBean 可能为如下所示:
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"
- 如果 url-pattern 元素是在应用程序的 web.xml 文件中定义的,那么使用 url-pattern 元素的值。例如,url-pattern 元素在 web.xml
文件中为 /SayHelloURL:
- 这是一个动态模型 MBean。
- 不支持对此 MBean 执行 destroy 操作。
WebSphere:feature=kernel,name=ServerInfo
- 管理接口:com.ibm.websphere.kernel.server.ServerInfoMBean
- 注释:ServerInfoMbean 接口用于检索有关正在运行的服务器的信息。在以下目录中搜索类和 API 文档:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
公开的操作包括用于检索产品安装和用户目录位置、缺省主机名、服务器名称、产品版本、Java 规范版本和 Java 运行时版本的方法。
![[18.0.0.1 and later]](../ng_v18001plus.gif)
WebSphere:feature=kernel,name=ServerEndpointControl
- 管理接口:com.ibm.websphere.kernel.server.ServerEndpointControlMBean
- 注释:ServerEndpointControlMBean 接口用于暂停和恢复服务器端点以及获取其状态。此 MBean 是内核中提供的,所以您不需要启用特殊功能部件。您可以在下列位置查找此 MBean 类和 API 文档:
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
要获取可暂停的端点类型的列表,请参阅从命令行暂停和恢复 Liberty 服务器。
WebSphere:feature=restConnector,type=FileService,name=FileService
- 管理接口:com.ibm.websphere.filetransfer.FileServiceMXBean
- 注释:此 MXBean 可让您在 Liberty 所在的主机上执行各种与文件相关的操作。您可以在下列位置查找此 MXBean 的类和 API 文档:
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
公开的操作包括能够查询特定文件或目录的特定元数据(最近一次修改日期和大小等等),还能够查询特定目录的所有子文件(和相应的元数据)。还支持创建和扩展归档,这对于压缩 Liberty 日志文件或者在部署应用程序之前将应用程序解压缩非常有用。
此 MXBean 包含两个属性:读取列表和写入列表。它们表示在使用 Liberty 所提供的 FileService 或 FileTransfer 功能时用户可以读/写的位置的列表。通过 MXBean,只能读取这些属性,但是可以通过 server.xml 文件中的下列元素来配置或定制这些属性:
如果未指定 readDir 元素,那么缺省值为下列各项的组合:${wlp.install.dir}、${wlp.user.dir} 和 ${server.output.dir}。如果未指定 writeDir 元素,那么缺省值为空集合。<remoteFileAccess> <readDir>${server.output.dir}/logs</readDir> <readDir>${server.output.dir}/apps</readDir> <writeDir>${server.output.dir}/dropins</writeDir> </remoteFileAccess>
server.xml 文件中必须包括 restConnector-1.0 功能部件,以便装入此 MXBean 以及支持其配置元素
允许将 Liberty 定义的变量与所有采用用于表示文件路径的字符串的服务器端参数配合使用。在 liberty_home/README.TXT 文件中定义了这类变量。
WebSphere:feature=restConnector,type=FileTransfer,name=FileTransfer
- 管理接口:com.ibm.websphere.filetransfer.FileTransferMBean
- 注释:此 MBean 允许您在 Liberty 所在的主机上执行各种文件传输操作。您可以在下列位置查找此 MXBean 的类和 API 文档:
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
此 MBean 在正运行其相应 Liberty 进程的同一 JVM 中的 PlatformMBeanServer 上已注册,但是只能使用 IBM® JMX REST Connector 来访问此 MBean。连接可以是本地连接或远程连接,但是必须使用 REST 连接器。
已公开的操作包括能够下载、上载和删除文件。服务器上的每个读取和写入请求都绑定至可配置的读取和写入列表,可通过 FileServiceMXBean 来访问这些列表。如果通过 IBM JMX REST 连接器连接了 JConsole,那么还可以从内置 Java JConsole 来完全访问和操作 FileTransferMBean。
允许将 Liberty 定义的变量与所有采用用于表示文件路径的字符串的服务器端参数配合使用。在 liberty_home/README.TXT 文件中定义了这类变量。
WebSphere:feature=wasJmsServer,type=MessagingEngine,name=*
- 管理接口:com.ibm.websphere.messaging.mbean.MessagingEngineMBean
- 注释:当启用了 wasJmsServer-1.0 功能部件时可用。每个 Liberty 可有一个可用的消息传递引擎实例。name=* 是 MBean 的名称,其中 * 是消息传递引擎 MBean 的唯一名称。请参阅JMS 消息传递。
WebSphere:feature=wasJmsServer,type=Queue,name=*
- 管理接口:com.ibm.websphere.messaging.mbean.QueueMBean
- 注释:当启用了 wasJmsServer-1.0 功能部件并且消息传递引擎的 MBean 可用时,该 MBean 可用。name=* 是 MBean 的名称,其中 * 是队列 MBean 的名称。请参阅JMS 消息传递。
WebSphere:feature=wasJmsServer,type=Subscriber,name=*
- 管理接口:com.ibm.websphere.messaging.mbean.SubscriberMBean
- 注释:当启用了 wasJmsServer-1.0 功能部件并且消息传递引擎的 MBean 可用时,该 MBean 可用。name=* 是 MBean 的名称,其中 * 是订户 MBean 的名称。
WebSphere:feature=wasJmsServer,type=Topic,name=*
- 管理接口:com.ibm.websphere.messaging.mbean.TopicMBean
- 注释:当启用了 wasJmsServer-1.0 功能部件并且消息传递引擎的 MBean 可用时,该 MBean 可用。name=* 是 MBean 的名称,其中 * 是主题 MBean 的名称。请参阅JMS 消息传递。
WebSphere:name=com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- 管理接口:com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- 注释:ServerXMLConfigurationMBean 提供接口以检索服务器已知的所有服务器配置文件的文件路径。此 MBean 是内核中提供的,所以您不需要启用特殊功能部件。您可以在下列位置查找此 MBean 类和 API 文档:
- ${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
- 管理接口:com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- 注释:RuntimeUpdateNotificationMBean 为服务器运行时更新提供通知。附加至通知的用户数据对象为 java.util.Map。此 MBean 发出的运行时更新通知的通知类型为 com.ibm.websphere.runtime.update.notification。
WebSphere:name=com.ibm.ws.config.mbeans.FeatureListMBean
- 管理接口:com.ibm.websphere.config.mbeans.FeatureListMBean
- 注释:FeatureListMBean 展示单个方法以对运行时安装的所有功能部件生成 XML 报告。此 MBean 是内核中提供的,所以您不需要启用特殊功能部件。您可以在下列位置查找此 MBean 类和 API 文档:
- ${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
- 管理接口:com.ibm.websphere.config.mbeans.ServerSchemaGenerator
- 注释:ServerSchemaGenerator MBean 展示用于从已安装映像生成模式(最常用方法)或从当前运行时生成模式的方法。此 MBean 是内核中提供的,所以您不需要启用特殊功能部件。您可以在下列位置查找此 MBean 类和 API 文档:
- ${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
- 管理接口:com.ibm.websphere.webcontainer.GeneratePluginConfigMBean
- 注释:请参阅向 Web 服务器添加插件配置。
WebSphere:service=com.ibm.websphere.application.ApplicationMBean,name=*
- 管理接口:com.ibm.websphere.application.ApplicationMBean
- 注释:系统中的每个应用程序可以使用一个实例,其中 * 是唯一的应用程序名称。
WebSphere:service=com.ibm.websphere.webcontainer.WebModuleMBean,application=*,name=*
- 管理接口:com.ibm.websphere.webcontainer.WebModuleMBean
- 注释:对于系统中的每个 Web 模块,都有一个可用的实例,其中 application=* 是系统中的应用程序名称,而 name=* 是该应用程序中的 Web 模块名称。
WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,*
- 管理接口:com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean
- 注释:为系统中的每个连接管理器(包括在下列上下文中创建的连接管理器)提供了一个实例。
- 在服务器配置中显式配置时
- 由于 @DataSourceDefinition 或 @ConnectionFactoryDefinition 注释而隐式创建时
- 由于服务器配置中的连接工厂或数据源而创建时
要缩小连接管理器实例的范围,可以指定其他属性(例如,以下示例中显示的属性):WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=jdbc/db2,* WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=jmsConnectionFactory[cf1]/connectionManager[default-0],* WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=databaseStore[dbstore1]/dataSource[default-0]/connectionManager,* WebSphere:type=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
- 管理接口:com.ibm.websphere.filemonitor.FileNotificationMBean
WebSphere:type=JvmStats
- 管理接口:com.ibm.websphere.monitor.jmx.JvmMXBean
- 注释:启用 monitor-1.0 功能部件后可用。请参阅JVM 监视。
WebSphere:type=ServletStats,name=*
- 管理接口:com.ibm.websphere.webcontainer.ServletStatsMXBean
- 注释:启用 monitor-1.0 功能部件后,所服务的每个 Servlet 都可以使用一个实例,其中 * 的格式为 <AppName>.<ServletName>。请参阅Web 应用程序监视。
WebSphere:type=ThreadPoolStats,name=Default Executor
- 管理接口:com.ibm.websphere.monitor.jmx.ThreadPoolMXBean
- 注释:启用 monitor-1.0 功能部件后可用。请参阅线程池监视。