Apusic 应用服务器提供了数据源事件监控功能,通过 Apusic Studio 的辅助,可以非常直观地获得应用中 SQL 执行情况,帮助分析发现问题。
但是,在一些应用中,并未使用到 Apusic 的数据源,如何对 SQL 执行情况进行监控呢?搜索了下,有开源的产品如 jamon ( jamonapi.sf.net )和 jwebap ( jwebap.sf.net )能够解决这个问题。本文描述如何在 web 应用中配置使用 jwebap 进行 SQL 监控。
1 获取 jwebap
jwebap 的程序都在一个 jar 文件中,可以从其官方网站下载,也可以从以下地址下载 http://ftp.apusic.com/sam/ jwebap_0.5.9_1.jar (用户: common 密码: common )。
在实际使用中,发现 jwebap 还依赖于 jakarta common 包中的 commons-beanutils 和 commons-digester 、 commons-logging 及 log4j 等,相关 jar 文件请从 http://jakarta.apache.org 网站下载。
2 配置 jwebap
配置 jwebap 只需要简单的几步:
1. 将 jwebap_0.5.9_1.jar 及上文提及的其他相关 jar 文件复制到应用的 WEB-INF/lib 目录。
2. 在应用的 WEB-INF 目录下创建文件 jwebap.xml ,参考内容如下:
<jwebap>
<component name="JdbcComponent" type="org.jwebap.plugin.jdbc.JdbcComponent"> <property name='trace-filter-active-time'>-1</property> <property name='trace-max-size'>1300</property> <property name='connection-listener'>org.jwebap.plugin.http.ServletOpenedConnectionListener;org.jwebap.plugin.method.MethodOpenedConnectionListener</property> <property name='driver-clazzs'>oracle.jdbc.driver.OracleDriver</property> </component> </jwebap> |
其中, dirver-clazzs 表示需要监控的数据库 JDBC 驱动类。
3. 在应用的 WEB-INF/web.xml 文件中,添加 jwebap 相关的配置,相关配置片段参考如下:
<context-param> <param-name>config</param-name> <param-value>/WEB-INF/jwebap.xml</param-value> </context-param> <listener> <listener-class>org.jwebap.core.JwebapListener</listener-class> </listener> <servlet> <servlet-name>detect</servlet-name> <servlet-class>org.jwebap.ui.controler.JwebapServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>detect</servlet-name> <url-pattern>/detect/*</url-pattern> </servlet-mapping> |
4. 其他
检查 Apusic 连接池配置文件 datasources.xml ,将各数据源暂时注释掉。
3 访问 jwebap 控制台
jwebap 的控制台通过 http://your-host-name:your-port/your-context-root/detect/ 进行访问,这是一个基于 EXT 做的界面, 还不错 。
4 更多配置
jwebap 不仅可以监控独立数据源,而且可以监控 http 页面、应用方法等的执行性能。相关的配置样例如下:
jwebap.xml
<jwebap>
<component name="HttpComponent" type="org.jwebap.plugin.http.HttpComponent"> <property name='trace-filter-active-time'>-1</property> <property name='trace-max-size'>1000</property> </component>
<component name="MethodComponent" type="org.jwebap.plugin.method.MethodComponent"> <property name='trace-filter-active-time'>-1</property> <property name='trace-max-size'>1000</property> <property name='detect-clazzs'>test.*;</property> </component>
<component name="JdbcComponent" type="org.jwebap.plugin.jdbc.JdbcComponent"> <property name='trace-filter-active-time'>-1</property> <property name='trace-max-size'>1300</property> <property name='connection-listener'>org.jwebap.plugin.http.ServletOpenedConnectionListener;org.jwebap.plugin.method.MethodOpenedConnectionListener</property> <property name='driver-clazzs'>oracle.jdbc.driver.OracleDriver</property> </component>
</jwebap> |
web.xml
<context-param> <param-name>config</param-name> <param-value>/WEB-INF/jwebap.xml</param-value> </context-param> <listener> <listener-class>org.jwebap.core.JwebapListener</listener-class> </listener>
<filter> <filter-name>PageDetectFilter</filter-name> <filter-class>org.jwebap.plugin.http.DetectFilter</filter-class> <init-param> <param-name>excludeUrls</param-name> <param-value>/detect;/detect/*;*.js;*.jpg;*.htm;*.html;*.gif;*.png;*.css;*.swf</param-value> </init-param> </filter> <filter-mapping> <filter-name>PageDetectFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>
<servlet> <servlet-name>detect</servlet-name> <servlet-class>org.jwebap.ui.controler.JwebapServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>detect</servlet-name> <url-pattern>/detect/*</url-pattern> </servlet-mapping> |