使用javamelody监控web程序集成总结

JavaMelody是用来在QA和实际运行生产环境中监控Java或Java EE应用程序服务器的一个开源框架。它不是一个工具来模拟来自用户的请求，而是一个测量和计算用户在实际操作中应用程序的使用情况的工具，并以图表的形式显示，图表可以按天，周，月，年或自定义时间段查看。

JavaMelody基础的监控包括Java内存和Java CPU使用情况，用户Session数量，JDBC连接数，和http请求、sql请求、jsp页面与业务接口方法（EJB3、Spring、 Guice）的执行数量，平均执行时间，错误百分比等。如果要监控Jenkins，JIRA，Sonar等等一些，需要另外安装对应的插件，还有一些高级文档用于高级配置。此文仅以JavaMelody v1.63.0版本演示基础功能的集成及使用，更多功能请深入研究官方文档。

1. 相关链接

官方文档 https://github.com/javamelody/javamelody/wiki/UserGuide
下载地址 https://github.com/javamelody/javamelody/releases

2. 运行环境要求

JDK 1.6及以上。
Servlet api 2.4以上 (或者 JavaEE 1.4)，比如Tomcat 5.5 or +, GlassFish v2+, JBoss 4+, Jetty 6+, WebLogic 9+。

3. 基础集成

在下载页面选择javamelody-1.63.0.zip : Zip of project下载之后解压。
解压后在根目录里找到javamelody.jar和jrobin-x.jar，把这两个文件拷贝到应用程序的WEB-INF/lib中。
如果应用服务器兼容Servlet API 3.0比如tomcat 7, glassfish v3或者 jboss 6，一般可以跳过这一步，除非你用了一个没有version="3.0"的web.xml。不然就如下操作：在程序的WEB-INF/web.xml里面，在servlet之前添加如下行，其中注意<async-supported>true</async-supported>和<dispatcher>ASYNC</dispatcher>是需要在Servlet API 3.0里用来支持异步请求的。

<filter>
        <filter-name>javamelody</filter-name>
        <filter-class>net.bull.javamelody.MonitoringFilter</filter-class>
        <async-supported>true</async-supported>
</filter>
<filter-mapping>
        <filter-name>javamelody</filter-name>
        <url-pattern>/*</url-pattern>
        <dispatcher>REQUEST</dispatcher>
        <dispatcher>ASYNC</dispatcher>
</filter-mapping>
<listener>
        <listener-class>net.bull.javamelody.SessionListener</listener-class>
</listener>

现在可以部署程序启动服务器，在浏览器打开http://<host>/<context>/monitoring。<host>：为你的主机名+端口地址，<context>：为你的应用配置地址。应该可以看到如下界面：

初始化监控界面.jpg

4. SQL监控集成

如果你的JDBC驱动是无数据源直接使用的，那你的驱动类应该定义为：net.bull.javamelody.JdbcDriver，然后应该加入jdbc属性为driver，值为真正的dirver class。例如，如果你使用的是hibernate.cfg.xml和mysql (无hibernate.connection.datasource)：
```
<property name ="hibernate.connection.driver_class" >net.bull.javamelody.JdbcDriver </property>
<property name ="hibernate.connection.driver">com.mysql.jdbc.Driver</property>
<property name="hibernate.connection.url"> jdbc:mysql://localhost:3306/myschema
</property>
<property nam="hibernate.connection.username">myuser</property>
<property name="hibernate.connection.password">mypassword</property>
```
只要保证原有的connection.driver是真实的驱动，上面添加一个参数connection.driver_class是javamelody的那个jdbc驱动即可。
如果使用了数据源，而且数据源又定义在spring的配置文件里面，那么数据源也是可以通过spring的后置处理器来监控。如果使用spring，是不需要额外设置驱动类的。前提是，需要在web.xml指定加载的spring配置文件。比如在web.xml中配置了org.springframework.web.context.ContextLoaderListener这个监听器，那在contextConfigLocation 的参数里需要如下配置，再运行程序然后去monitoring页面查看应该已经有sql的统计了：
```
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>
     classpath:monitoring-spring.xml
     classpath:applicationContext.xml
    </param-value>
</context-param>
```

sql监控.jpg

注意事项：确保monitoring-spring.xml被当作配置文件第一个加载。如果应用中springAOP或者@Autowired的配置与monitoring-spring.xml中的配置有冲突，那么使用monitoring-spring-datasource.xml文件替代monitoring-spring.xml就可以了，这个文件仅仅包含一个数据源的后置处理器和SpringDataSourceFactoryBean的一个例子。其中monitoring-spring.xml和monitoring-spring-datasource.xml文件都在解压目录的src\main\resources\net\bull\javamelody目录下，需要将对应使用的文件拷贝到classpath目录下。

5. Spring方法级监控

前提是使用monitoring-spring.xml文件（不做修改），然后在需要监控的方法上使用@MonitoredWithSpring注解即可。另外一种方式是修改monitoring-spring.xml文件内容如下：

<bean id="monitoringAdvisor" class="net.bull.javamelody.MonitoringSpringAdvisor">
    <property name="pointcut">
        <bean class="org.springframework.aop.support.JdkRegexpMethodPointcut">
            <!-- 监控com.system.service下所有类的方法 -->
            <property name="pattern" value="com.system.service.*.*" />   
        </bean>
    </property>
</bean>

spring方法级监控.jpg

6. 其他内容

javamelody监控数据存放的目录位于 C:\Users\xxx\AppData\Local\Temp\javamelody。可以将对应项目的目录删除，再重启服务器可以看到数据已经清空。