监控Tomcat解决方案（监控应用服务器系列文章）

　　前言：做了一个监控应用服务器的项目（支持Tocmat、WebSphere、WebLogic各版本），过程也算是磕磕绊绊，由于网上缺乏相关资料，或者身陷于知识的海洋未能寻找到有效的资料，因而走过不少弯路，遇过不少困难。为了留下点印记，给后来人留下点经验之谈，助之少走弯路，故将这种经验整理下来，与你们分享。水平有限，难免偏颇，还望见谅。如有疑问，欢迎留言，或者加入Q群参与讨论：35526521。

　　监控Tomcat常见的两种方案的比较

　　使用Tomcat提供的manager应用进行数据采集

　　◆ 可以使用现有的成熟代码，减少工作量

　　◆ 支持各不同版本时无差异

　　◆ 可能存在特殊需求而manager不能满足的情况

　　◆ 最重要的一个优点是，配置比较简单

　　使用JMX插口开发监控程序

　　◆ 全部代码须要从零开始，代码量较大

　　◆ 支持各不同版本比较麻烦，每个版本可能有差别

　　◆ 可支配性强

　　◆ 最重要的一个缺点是，配置比较麻烦

　　方案一、使用 Tomcat提供的manager应用进行数据采集

　　Applications Manager（又称opManager）就是通过这些方法实现的。

　　使用这些方法，所监控Tomcat必须运行manager应用，缺省情况下，该应用总是运行在服务器中的。

　　增加manager角色用户

　　访问manager应用的用户的角色权限必须是 manager.

　　修改/conf目录下的tomcat-users.xml文件，在节点下添加一个user节点，即可创建一个用户。

　　Tomcat版本不同配置也有差别，5.x和6.x创建的用户角色应为manager，7.x创建的用户角色为manager-jmx，举例如下：

　　1、在5.x和6.x中创建一个manager角色的用户，用户名为admin，密码为chenfeng：

　　2、在7.x中创建一个manager角色的用户，用户名为admin，密码为chenfeng：

　　admin" password="chenfeng" roles="manager-jmx,manager-script,manager-status"/>

　　修改配置后，需要重新启动 Tomcat 服务器。

　　连接manager时将用户名/密码指定为admin/chenfeng

　　通过浏览器访问JMX Proxy Servlet

　　详见官方说明文档：

　　What is JMX Proxy Servlet

　　The JMX Proxy Servlet is a lightweight proxy to get and set the tomcat internals. (Or any class that has been exposed via an MBean) Its usage is not very user friendly but the UI is extremely help for integrating command line scripts for monitoring and changing the internals of tomcat. You can do two things with the proxy: get information and set information. For you to really understand the JMX Proxy Servlet, you should have a general understanding of JMX. If you don't know what JMX is, then prepare to be confused.

　　JMX Query command

　　This takes the form:

http://webserver/manager/jmxproxy/?qry=STUFF

Where STUFF is the JMX query you wish to perform. For example, here are some queries you might wish to run:

◆ qry=*%3Atype%3DRequestProcessor%2C* --> type=RequestProcessorwhich will locate all workers which can process requests and report their state.

◆ qry=*%3Aj2eeType=Servlet%2c* --> j2eeType=Servletwhich return all loaded servlets.

◆ qry=Catalina%3Atype%3DEnvironment%2Cresourcetype%3DGlobal%2Cname%3DsimpleValue --> Catalina:type=Environment,resourcetype=Global,name=simpleValuewhich look for a specific MBean by the given name.

You'll need to experiment with this to really understand its capabilites. If you provide no qry parameter, then all of the MBeans will be displayed. We really recommend looking at the tomcat source code and understand the JMX spec to get a better understanding of all the queries you may run.

　　通过浏览器访问:8080/manager/jmxproxy ，输入用户名密码，然后就可以看见返回了所有的监控信息

　　添加查询参数，返回特定的监控信息：

　　例如：

　　:8080/manager/jmxproxy?qry=*%3Atype%3DRequestProcessor%2C*

　　其中 *%3Atype%3DRequestProcessor%2C* 其实就是 *:type=RequestProcessor,*

　　又如：

　　:8080/manager/jmxproxy?qry=*%3Aj2eeType%3DWebModule%2Cname%3D//localhost/ajaxrpc%2C*

　　在代码中访问JMX Proxy Servlet

　　通过浏览器访问JMX Proxy Servlet须要输入用户名密码，所以通过Java访问JMX Proxy Servlet的URL也须要授权访问： URL url = new URL(":8080/manager/jmxproxy?qry=*%3Atype%3DManager%2C*");

　　URLConnection conn = (URLConnection) url.openConnection();

// URL授权访问 -- Begin

String password = "admin:chenfeng"; // manager角色的用户

String encodedPassword = new BASE64Encoder().encode(password.getBytes());

conn.setRequestProperty("Authorization", "Basic " + encodedPassword);

// URL授权访问 -- End

InputStream is = conn.getInputStream();

BufferedReader bufreader = new BufferedReader(new InputStreamReader(is));

String line = null;

while ((line = bufreader.readLine()) != null) {

System.out.println(line);

}

　　几个具体的事例

　　下面展示两个事例，一个是采集服务器基本信息，一个是采集Web应用列表信息，注意Tomcat 7.x和Tomcat 5.x、6.x之间存在很大的区别。

　　◆ 采集服务器基本信息

　　通过serverinfo命令查看服务器基本信息

　　:8080/manager/serverinfo

　　Tomcat 7.x的查询URL有变化：

　　:8080/manager/text/serverinfo

　　返回信息：

　　OK - Server info

Tomcat Version: Apache Tomcat/7.0.11

OS Name: Windows Vista

OS Version: 6.1

OS Architecture: x86

JVM Version: 1.6.0_13-b03

JVM Vendor: Sun Microsystems Inc.

　　◆ 采集Web应用列表信息

　　通过list命令查看Web应用列表和会话数信息

　　:8080/manager/list

　　Tomcat 7.x的查询URL有变化：

　　:8080/manager/text/list

　　返回信息：

　　OK - Listed applications for virtual host localhost

/:running:0:ROOT

/manager:running:1:manager

/docs:running:0:docs

/examples:running:0:examples

/host-manager:running:0:host-manager

　　方案二、使用JMX 接口开发监控程序Tomcat激活JMX远程配置

　　① 先更改Tomcat的启动脚本，window下tomcat的bin/catalina.bat（linux为catalina.sh），添加以下内 容，8999是jmxremote使用的端口号，第二个false表示不需要信令：

　　set JMX_REMOTE_CONFIG=-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=8999 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=false

set CATALINA_OPTS=%CATALINA_OPTS% %JMX_REMOTE_CONFIG%

　　可以加在if "%OS%" == "Windows_NT" setlocal 一句后的大段的注释旁边。

　　参考官方说明：

　　② 上面的配置是不需要信令的，如果须要信令则添加的内容为：

　　set JMX_REMOTE_CONFIG=-Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=8999 -Dcom.sun.management.jmxremote.ssl=false -Dcom.sun.management.jmxremote.authenticate=true -Dcom.sun.management.jmxremote.password.file=../conf/jmxremote.password -Dcom.sun.management.jmxremote.access.file=../conf/jmxremote.access

set CATALINA_OPTS=%CATALINA_OPTS% %JMX_REMOTE_CONFIG%

　　然后复制并更改授权文件，$JAVA_HOME/jre/lib/management下有 jmxremote.access和jmxremote.password的模板文件，将两个文件复制到$CATALINA_BASE/conf目录下

　　● 修改$CATALINA_BASE/conf/jmxremote.access 添加内容：

　　monitorRole readonly

　　controlRole readwrite

　　● 修改$CATALINA_BASE/conf/jmxremote.password 添加内容：

　　monitorRole tomcat

　　controlRole tomcat

　　注意：如果只做第一步没有问题，进行了第二步Tomcat就启动不了，那么太可能是密码文件的权限问题！

　　需要更改jmxremote.password文件的权限，只有运行Tomcat的用户有访问权限：

　　Windows的NTFS文件系统下，选中文件，点右键 -->“属性”-->“安全”--> 点“高级”--> 点“更改权限”--> 去掉“从父项继承....”--> 弹出窗口中选“删除”，这样就删掉了所有访问权限。再选“添加”--> “高级”--> “立即查找”，选中你的用户，例administrator，点“确定"，“确定"。来到权限项目窗口，勾选“完全控制”，点“确定”，OK了。

　　官方的提示

　　The password file should be read-only and only accessible by the operating system user Tomcat is running as.

　　③ 重新启动Tomcat，在Windows命令行输入“netstat -a”查看配置的端口号是否已打开，如果打开，说明里面的配置成功了。

　　④ 使用jconsole测试JMX。

　　运行$JAVA_HOME/bin目录下的jconsole.exe，打开J2SE监视和管理控制台，然后构建联接，如 果是本地的Tomcat则直接选择之后点击联接，如果是远程的，则步入远程选项卡，填写地址、端口号、用户名、口令即可联接。Mbean属性页中给出了相 应的数据，Catalina中是tomcat的，java.lang是jvm的。对于加粗的宋体属性值，需双击一下才可看内容。

　　使用JMX监控Tomcat示例代码：

　　String jmxURL = "service:jmx:rmi:///jndi/rmi://192.168.10.93:8999/jmxrmi";

JMXServiceURL serviceURL = new JMXServiceURL(jmxURL);

Map map = new HashMap();

// 用户名密码，在jmxremote.password文件中查看

String[] credentials = new String[] { "monitorRole", "tomcat" };

map.put("jmx.remote.credentials", credentials);

JMXConnector connector = JMXConnectorFactory.connect(serviceURL, map);

MBeanServerConnection mbsc = connector.getMBeanServerConnection();

// 端口最好是动态取得

ObjectName threadObjName = new ObjectName("Catalina:type=ThreadPool,name=http-8080");

MBeanInfo mbInfo = mbsc.getMBeanInfo(threadObjName);

// tomcat的线程数对应的属性值

String attrName = "currentThreadCount";

MBeanAttributeInfo[] mbAttributes = mbInfo.getAttributes();

System.out.println("currentThreadCount:" + mbsc.getAttribute(threadObjName, attrName));

　　完整的示例代码文件：