使用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>
注意事项:确保
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。可以将对应项目的目录删除,再重启服务器可以看到数据已经清空。