使用 JMX 代理 Servlet

什么是 JMX 代理 Servlet

JMX 代理 Servlet 是一款輕量級的代理。它的用途對用戶來說并不是特別友好，但是其 UI 卻非常有助于整合命令行腳本，從便于監(jiān)控和改變 Tomcat 的內(nèi)部運行。

通過這個代理，我們可以獲取和設(shè)置信息。要想真正了解 JMX 代理 Servlet，首先應(yīng)該大概了解 JMX。

如果不知道 JMX 的基本原理，那有些內(nèi)容就很難理解了。

JMX 查詢命令

JMX 的查詢命令格式如下所示：

http://webserver/manager/jmxproxy/?qry=STUFFSTUFF 是所要執(zhí)行的 JMX 查詢。比如，可以執(zhí)行以下這些查詢：

• qry=*%3Atype%3DRequestProcessor%2C* --> type=RequestProcessor 定位所有能夠處理請求并匯報各自狀態(tài)的 Worker。
• qry=*%3Aj2eeType=Servlet%2c* --> j2eeType=Servlet 查詢返回所有加載的 Servlet。
• qry=Catalina%3Atype%3DEnvironment%2Cresourcetype%3DGlobal%2Cname%3DsimpleValue--> Catalina:type=Environment,resourcetype=Global,name=simpleValue 按照指定名稱查找 MBean。

需要實際地試驗一下才能真正理解這些功能。如果沒有提供 qry 參數(shù)，則將顯示全部的 MBean。我們強烈建議你去閱讀 Tomcat 源代碼，真正了解 JMX 規(guī)范，更好地掌握所有能夠執(zhí)行的查詢。

JMX 的 get 命令

JMXProxyServlet 還支持一種 get 命令來獲取特定 MBean的屬性值。該命令的一般格式如下所示：

http://webserver/manager/jmxproxy/get=BEANNAME&att=MYATTRIBUTE&key=MYKEY

必須提供如下參數(shù)：

• get：MBean 的完整名稱。
• att：希望獲取的屬性。
• key：（可選參數(shù)）CompositeData MBean 的屬性中的鍵。

如果命令成功執(zhí)行，則一切正常，否則就會返回一個出錯消息。舉兩個例子，比如當希望獲取當前的堆內(nèi)存數(shù)據(jù)時，可以采用如下命令：

http://webserver/manager/jmxproxy/?get=java.lang:type=Memory&att=HeapMemoryUsage

再或者，如果只希望獲取“用過的”鍵，可以采用如下命令：

http://webserver/manager/jmxproxy/?get=java.lang:type=Memory&att=HeapMemoryUsage&key=used

JMX 的 set 命令

上面介紹了如何查詢一個 MBean。下面來看看 Tomcat 的內(nèi)部運行吧！set 命令的一般格式為：

http://webserver/manager/jmxproxy/?set=BEANNAME&att=MYATTRIBUTE&val=NEWVALUE

需要提供三個請求參數(shù)：

• set：完整的 bean 名稱。
• att：想要改變的屬性。
• val：新的屬性值。

如果命令成功執(zhí)行，則一切正常，否則就會返回一個出錯消息。比如，假如想為 ErrorReportValve 進行立即調(diào)試，可以將屬性 debug 設(shè)為 10：

http://localhost:8080/manager/jmxproxy/
 ?set=Catalina%3Atype%3DValve%2Cname%3DErrorReportValve%2Chost%3Dlocalhost
 &att=debug&val=10  

所得結(jié)果如下（你的有可能不同）：

Result: ok

下面來看看如果傳入一個不恰當數(shù)值時的情況，比如使用一個URL，并試圖將屬性 debug 設(shè)置為 'cow'。

http://localhost:8080/manager/jmxproxy/
 ?set=Catalina%3Atype%3DValve%2Cname%3DErrorReportValve%2Chost%3Dlocalhost
 &att=debug&val=cow

運行結(jié)果如下：

Error: java.lang.NumberFormatException: For input string: "cow"

JMX 的 invoke 命令 

使用 invoke 命令，我們就可以在 MBean 中調(diào)用方法。該命令的一般格式為：

http://webserver/manager/jmxproxy/
 ?invoke=BEANNAME&op=METHODNAME&ps=COMMASEPARATEDPARAMETERS

比如，使用如下方式來調(diào)用 Service 的 findConnectors() 方法：

http://localhost:8080/manager/jmxproxy/
 ?invoke=Catalina%3Atype%3DService&op=findConnectors&ps=