提供的 MBean 清單

Liberty 提供一份 MBean 及對應管理介面的清單,可用來操作及監視伺服器。

清單中的每個 MBean 或 MXBean:
  • 名稱是 javax.management.ObjectName 值,用來唯一識別 MBean 或 MXBean。 當 MBean 或 MXBean 有多重實例時,ObjectName 值可以包含這個主題的註解項目所說明的萬用字元 (*)。
  • 管理介面項目指定可依照Liberty:存取 MBean 屬性和作業的範例中所說明,用來建構 MBean 或 MXBean 的虛擬物件之 Java 介面的名稱。如需管理介面的相關資訊,請參閱 Liberty 的 Java API 文件。每一個 Liberty API 的 Java API 文件都是以個別的 .zip 檔來提供(其位於 ${wlp.install.dir}/dev 目錄下的其中一個 javadoc 子目錄中)。

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.ServerPerformance.Counter.client,其中 service=* 是服務端點的完整名稱,port=* 是服務端點的埠號。 請參閱 Liberty:JAX-WS 監視
註: 這是一個「動態模型 MBean」。

WebSphere:feature=jaxws,type=Bus.Service.Endpoint,bus.id=*,service=*,port=*,name=*

  • 管理介面:org.apache.cxf.endpoint.ManagedEndpoint
  • 註解:當啟用 localConnector-1.0restConnector-1.0 特性且存取 JAX-WS 應用程式至少一次時,可供使用。 bus.id=* 是匯流排的名稱,其中 * 的形式是 <AppName>-Server-Busservice=* 是端點的完整名稱,其中 * 的形式是 {ServiceNamespace}ServiceNameport=* 是端點的埠名稱,其中 * 是現行埠名稱。 MBean 的格式如下:<BUS>@<SERVICE>@<PORT>@<URL_PATTERN>,其中:
    • <BUS> 值與 bus.id 欄位相同;
    • <SERVICE> 值與 service 欄位相同;
    • <PORT> 值與 port 欄位相同;
    • 在不同的實務中,<URL_PATTERN> 可能是下列值:
      • 如果應用程式的 web.xml 檔定義了 url-pattern 元素,就使用 url-pattern 元素的值。 例如,url-pattern 元素是 web.xml 檔中的 /SayHelloURL
        <servlet-mapping>
            <servlet-name>com.ibm.ws.jaxws.test.jmx.service.WSTestEndpointService</servlet-name>
            <url-pattern>/SayHelloURL</url-pattern>
        </servlet-mapping>
        例如,這個 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@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 服務引擎無法擷取 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"
註:
  • 這是一個「動態模型 MBean」。
  • 不支援這個 MBean 的 destroy 作業。

WebSphere:feature=kernel,name=ServerInfo

  • 管理介面: com.ibm.websphere.kernel.server.ServerInfoMBean
  • 註解:ServerInfoMbean 介面用來擷取執行中伺服器的相關資訊。請搜尋下列目錄,以找出類別與 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

顯現的作業包含一種方法,可用來擷取產品的安裝與使用者目錄位置、預設主機名稱、伺服器名稱、產品版本、Java 規格版本,以及 Java 執行時期版本。

WebSphere:feature=restConnector,type=FileService,name=FileService

  • 管理介面:com.ibm.websphere.filetransfer.FileServiceMXBean
  • 註解:這個 MXBean 可讓您在 Liberty 所在的主機上,執行各種檔案相關作業。
    您可以在下列位置找到它的類別和 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

    顯現的作業包括能夠查詢特定檔案或目錄的某些 meta 資料 (前次修改日期、大小,等等),也能夠查詢特定目錄的所有子檔案(及對應的 meta 資料)。另外,還支援建立和擴充保存檔,對於壓縮 Liberty 日誌檔或在部署應用程式之前先將它解壓縮,這可能很有用。

    這個 MXBean 包含兩個屬性:讀取清單和寫入清單。 它們代表在使用 Liberty 所提供的 FileServiceFileTransfer 功能時,使用者可以讀取或寫入的位置清單。 透過 MXBean,這些屬性是唯讀的,但您可以透過 server.xml 檔中的下列元素來配置或自訂它們:
    <remoteFileAccess>
      		<readDir>${server.output.dir}/logs</readDir>
      		<readDir>${server.output.dir}/apps</readDir>
      		<writeDir>${server.output.dir}/dropins</writeDir>
    </remoteFileAccess>
    如果沒有指定 readDir 元素,預設值為 ${wlp.install.dir}${wlp.user.dir}${server.output.dir} 的組合。 如果沒有指定 writeDir 元素,預設值就是一個空集合。

    restConnector-1.0 特性必須包含在 server.xml 檔中,這個 MXBean 才能被載入以及實現其配置元素。

    當使用 Liberty 定義的變數時,所有伺服器端參數都可以採用代表檔案路徑的字串。 這類變數定義於 liberty_home/README.TXT 檔。

WebSphere:feature=restConnector,type=FileTransfer,name=FileTransfer

  • 管理介面:com.ibm.websphere.filetransfer.FileTransferMBean
  • 註解:這個 MBean 可讓您在 Liberty 所在的主機上,執行各種檔案傳送作業。
    您可以在下列位置找到它的類別和 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 來存取。連線可以是本端或遠端連線,但必須使用 REST Connector。

    顯現的作業包括能夠下載、上傳和刪除檔案。 伺服器上每個讀取和寫入要求都會連結至透過 FileServiceMXBean 來存取的可配置的讀取及寫入清單。 如果是透過 IBM JMX REST Connector 來連接 JConsole,FileTransferMBean 也完全可以從內建的 Java JConsole 來存取及操作。

    當使用 Liberty 定義的變數時,所有伺服器端參數都可以採用代表檔案路徑的字串。 這類變數定義於 liberty_home/README.TXT 檔。

WebSphere:feature=wasJmsServer,type=MessagingEngine,name=*

  • 管理介面:com.ibm.websphere.messaging.mbean.MessagingEngineMBean
  • 註解:當啟用 wasJmsServer-1.0 特性時可供使用。每個 Liberty 都有一個可用的傳訊引擎實例。name=* 是 MBean 的名稱,其中 * 是傳訊引擎 MBean 的唯一名稱。請參閱 Liberty:JMS 傳訊

WebSphere:feature=wasJmsServer,type=Queue,name=*

  • 管理介面:com.ibm.websphere.messaging.mbean.QueueMBean
  • 註解:當啟用 wasJmsServer-1.0 特性且傳訊引擎的 MBean 可供使用之時,可以使用這個 MBean。 name=* 是 MBean 的名稱,其中 * 是佇列 MBean 的名稱。請參閱 Liberty:JMS 傳訊

WebSphere:feature=wasJmsServer,type=Subscriber,name=*

  • 管理介面:com.ibm.websphere.messaging.mbean.SubscriberMBean
  • 註解:當啟用 wasJmsServer-1.0 特性且傳訊引擎的 MBean 可供使用之時,可以使用這個 MBean。 name=* 是 MBean 的名稱,其中 * 是訂閱者 MBean 的名稱。
    註: SubscriberMBean 是現有 TopicMBean 的訂閱者。 請參閱 Liberty:JMS 傳訊

WebSphere:feature=wasJmsServer,type=Topic,name=*

  • 管理介面:com.ibm.websphere.messaging.mbean.TopicMBean
  • 註解:當啟用 wasJmsServer-1.0 特性且傳訊引擎的 MBean 可供使用之時,可以使用這個 MBean。 name=* 是 MBean 的名稱,其中 * 是主題 MBean 的名稱。請參閱 Liberty: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

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
  • 註解:系統中的每一個 WebModule 都有一個可用的實例,其中 application=* 是系統中的應用程式名稱,name=* 是該應用程式中的「Web 模組」名稱。

WebSphere:service=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,*

  • 管理介面:com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean
  • 註解:系統中每一個「連線管理程式」都有一個可用的實例,包括下列環境定義中所建立的那些實例:
    • 明確配置在伺服器配置中時
    • @DataSourceDefinition@ConnectionFactoryDefinition 註釋,而隱含建立時
    • 因伺服器配置中的 Connection Factory 或資料來源而建立時
    必須等對應的 Connection Factory 或資料來源先使用之後,mbean 實例才會變成可用的。
    如果要縮小連線管理程式實例範圍,您可以指定其他的屬性,如下列範例所示:
    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

  • 管理介面:com.ibm.websphere.filemonitor.FileNotificationMBean

WebSphere:type=JvmStats

  • 管理介面:com.ibm.websphere.monitor.jmx.JvmMXBean
  • 註解:當啟用 monitor-1.0 特性時可供使用。請參閱 Liberty:JVM 監視

WebSphere:type=ServletStats,name=*

  • 管理介面:com.ibm.websphere.webcontainer.ServletStatsMXBean
  • 註解:當啟用 monitor-1.0 特性時,每一個所提供的 Servlet 都有一個可用的實例,其中 * 的格式為<AppName>.<ServletName>。 請參閱 Liberty:Web 應用程式監視

WebSphere:type=ThreadPoolStats,name=Default Executor

  • 管理介面:com.ibm.websphere.monitor.jmx.ThreadPoolMXBean
  • 註解:當啟用 monitor-1.0 特性時可供使用。請參閱 Liberty:ThreadPool 監視

指示主題類型的圖示 參照主題



「時間戳記」圖示 前次更新: 2016 年 11 月 30 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwlp_mbeans_list
檔名:rwlp_mbeans_list.html