10秒为任意数据库增加执行日志功能

一起学习

JDBMonitor User Manual JDBMonitor 用户手册 杨中科 2006 摘要 本文是JDBMonitor的用户手册。JDBMonitor是一个开源项目。使用它开发者可以很轻松为系统增加数据库执行日志功能。它使用十分方便，您所需要做的唯一事情就是在您系统的JDBC连接字符串前增加类似于 "listenerconfig=/config.xml:url=" 的字符即可，不用写任何代码。 使用 JDBMonitor，您可以把数据库执行情况记录通过各种方式记录下来，比如打印到控制台、输出到文件或者通过socket传送给远程客户端。JDBMonitor是可扩展的，您可以扩展它来将执行情况通过其他方式记录下来，您所需要做的就是写一个实现IDBListener接口的类即可。 JDBMonitor遵守 GNU Lesser General Public Licence (LGPL)协议。此协议包含在发行包中。 入门 几乎所有大型数据库应用都包含有自己的SQL执行日志功能，此功能不仅能帮助开发人员调试，而且可以为DBA（数据库管理员）提供系统的运行信息。 （1）很难将业务逻辑同日志代码分离 （2）降低了代码的可读性。 （3）降低了系统的运行速度。在记录日志的时候，程序会暂停运行等待直到记录完成，而I/O操作是相当耗时的。 （4）很难记录运行耗时、语句参数等其他信息 （5）很难为我们无法修改代码的系统（例如没有源代码的系统）或者很难增加记录日志功能代码的系统（比如系统使用了ORMapping）增加日志功能。 JDBMonitor 则不同： （1）您最多只需要修改一行代码。您需要修改的代码就是这一行:Class.forName("com.cownew.JDBMonitor.jdbc.DBDriver") ,然后再修改一下 JDBC连接字符串，只要从 “jdbc:db2://10.74.198.247:50000/app”修改成” listenerconfig=config.xml:url= jdbc:db2://10.74.198.247:50000/app”就可以了。在您使用WebLogic ,Tomcat或其他服务器的数据源功能的时候，连修改代码这一步都是无需的。 （2）JDBMonitor另起一个线程来记录SQL，所以它不会对程序运行速度有任何影响。 （3）它是高度可扩展的，所以您可以扩展它来把执行情况通过其他方式记录。比如，您可以写一个扩展类，来通过电子邮件将日志发送出去。 取得 JDBMonitor JDBMonitor的最新稳定版本可以在JDBMonitor的网站上取得： 使用 JDBMonitor 1 将 jdbmonitor.jar放到您系统的类路径下。 2 让系统加载 JDBMonitor的JDBC驱动。 这一步将会依您系统加载JDBC驱动的方式的不同而不同。 （1）如果您通过代码的形式加载JDBC驱动，例如： Class.forName(“com.microsoft.jdbc.sqlserver.SQLServerDriver”); Connection cn = DriverManager.getConnection(……); 在这种情况下 ，您必须修改 “Class.forName”这一句来加载JDBMonitor的JDBC驱动（“com.cownew.JDBMonitor.jdbc.DBDriver”），而非以前的数据库JDBC驱动。 例如： Class.forName(“com.cownew.JDBMonitor.jdbc.DBDriver”); Connection cn = DriverManager.getConnection(……); （2）如果您在配置文件中指定JDBC驱动，比如，数据源配置文件或者其他类似的文件。 请修改原来的 JDBC驱动类为 “com.cownew.JDBMonitor.jdbc.DBDriver” 。 3 让 JDBMonitor加载能够加载原来的JDBC驱动 JDBMonitor的工作原理就是截获JDBC驱动的SQL语句调用、记录SQL语句，然后将SQL语句重新转发给原来的JDBC驱动，所以JDBMonitor必须首先向DriverManager注册JDBC驱动。 原来的JDBC驱动定义在配置文件的“JdbcDrivers” 段中。 4 在原来的JDBC连接字符串前增加 JDBMonitor所需的信息。 您所需要做的就是将” listenerconfig=:url=” 增加到原来的JDBC连接字符串前。“”代表配置文件的路径，下面集中路径都是合法的： /com/jdbmonitor/config.xml com/jdbmonitor/config.xml c:/ jdbmonitor /config.xml JDBMoinitor使用getClass().getResourceAsStream加载类似于“/com/jdbmonitor/config.xml” and “com/jdbmonitor/config.xml” 的类路径文件，使用 FileInputStream加载类似于 “c:/ jdbmonitor /config.xml”的配置文件。 5 指定您要使用监听器： 您可以把数据库执行情况记录通过各种方式记录下来，比如打印到控制台、输出到文件或者通过socket传送给远程客户端。 我们已经开发了如下常用的监听器：FileDBListener、ConsoleDBListener、 SocketDBListene、DataBaseDBListener。当然您也可以开发满足您要求的监听器。 监听器定义在配置文件的 “Listeners”段中： 搞定！启动您的系统。耶！SQL语句被记录下来了，我们可以在控制台、文件甚至远程监视器中看到日志了。 举例 mvnforum的例子： 您可以从得到mvnforum。我演示用的版本是1.0。 （1）打开webapp\WEB-INF\classes\ mvncore.xml，重新配置： 修改之前： com.mysql.jdbc.Driver listenerconfig=c:/log/jdbmonitor/config.xml:url= jdbc:mysql://localhost/mvnforum?useUnicode=true&characterEncoding=utf-8 修改之后： com.cownew.JDBMonitor.jdbc.DBDriver jdbc:mysql://localhost/mvnforum?useUnicode=true&characterEncoding=utf-8 （2）创建文件 c:/log/jdbmonitor/config.xml。我只想将SQL语句记录到文本文件中，所以我做如下配置： （3） 将 jdbmonitor.jar放到webapp\WEB-INF\lib下。 (4) 搞定！ Jive的例子： 您可以从得到Jive。我演示用的版本是 Jive 2.0 beta版。 （1）打开 “jdbc” 填为：com.cownew.JDBMonitor.jdbc.DBDriver “server” 填为：c:/log/jdbmonitor/config.xml:url=jdbc:mysql://locahost/jive （2）将 jdbmonitor.jar放到WEB-INF\lib下 (4) 象mvnforum中一样创建同样的 c:/log/jdbmonitor/config.xml 文件. (4) 搞定! 代码方式的例子： 尽管直接在代码中指定系统所用的JDBC驱动类名和JDBC连接字符串是不推荐的，但是仍然有系统是这么做的。 比如： Class.forName("sun.jdbc.odbc.JdbcOdbcDriver"); Connection conn = null; PreparedStatement ps = null; try { conn = DriverManager .getConnection("jdbc:odbc:MQIS"); for (int i = 0; i < 1000; i ) { ps = conn.prepareStatement("update T_Material set fid=fid"); ps.execute(); ps.close(); } } finally { .... } （1）修改一下代码为： Class.forName("com.cownew.JDBMonitor.jdbc.DBDriver"); Connection conn = null; PreparedStatement ps = null; try { conn = DriverManager.getConnection("listenerconfig= c:/log/jdbmonitor/config.xml:url=jdbc:odbc:MQIS"); for (int i = 0; i < 1000; i ) { ps = conn.prepareStatement("update T_Material set fid=fid"); ps.execute(); ps.close(); } } finally { .... } （2）创建c:/log/jdbmonitor/config.xml文件。我想记录SQL语句到文本文件中同时输出到控制台，这样可以辅助我进行调试，所以我配置如下： (3) 将 jdbmonitor.jar放到类路径下。 (4) 搞定! 监听器 我们已经开发了如下常用的监听器：FileDBListener、ConsoleDBListener、 SocketDBListener、DataBaseDBListener。 1、ConsoleDBListener 控制台监听器 ConsoleDBListener会将SQL语句打印到控制台中。 这个监听器很容易配置： 2、FileDBListener 文件监听器 FileDBListener 会将SQL语句保存到文本文件中。 如下配置： arg="c:/aaa.txt"表示日志将保存到文件c:/aaa.txt中。 3、SocketDBListener Socket监听器 SocketDBListener是一个socket服务器，客户端连接到它上边以后就可以接收到它发出的SQL语句。 如下配置： arg="9527"表示服务器将在9527端口监听。 我们已经开发了如下两种客户端：SocketConsoleClient（Socket控制台客户端） 和 SocketSwingClient（Socket Swing客户端）。 SocketConsoleClient工作在控制台中： SocketSwingClient是一个Swing GUI客户端： 您可以运行"java -classpath jdbmonitor.jar com.cownew.JDBMonitor.listenerImpl.sckListenerClient.SocketConsoleClient" 来启动SocketConsoleClient，运行"java -classpath jdbmonitor.jar com.cownew.JDBMonitor.listenerImpl.sckListenerClient.SocketSwingClient"启动SocketSwingClient。 您可以编写符合您自己要求的客户端，具体细节请参考com.cownew.JDBMonitor.listenerImpl.sckListenerClient.ListenerClient和com.cownew.JDBMonitor.listenerImpl.sckListenerClient.IDBSocketClientListener. 4、DataBaseDBListener DataBaseDBListener将会把SQL语句记录到数据库中： 如下配置： "dburl=jdbc:odbc:MQIS;user=;password=;"表示目标数据库的JDBC连接字符串。"logtable=T_Log_SQLLog" 表示SQL记录将被保存到哪个表中，默认的是T_Log_SQLLog。 如果目标数据库用的JDBC驱动与被监控的数据库不同，请将它加入配置文件的 "JdbcDrivers" 部分，例如： true "T_Log_SQLLog"的结构是： "T_Log_SQLLog"的建库脚本在com/cownew/JDBMonitor/listenerImpl/dataBaseListener,(db2.sql,mssqlserver.sql,oracle.sql)。 DataBaseDBListener是跨数据库的，你可以把记录SQL到任何关系数据库中。 FAQ: 1 如果我暂时不想记录SQL语句执行怎么办？难道我要重新修改成原来的样子？ 答：无须如此。您只要修改config.xml，增加false到文件中即可。 如下： false ...... 如何扩展JDBMonitor？ 我们已经开发了如下常用的监听器：FileDBListener、ConsoleDBListener、 SocketDBListener、DataBaseDBListener。当然您也可以开发满足您要求的监听器。所有的监听器必须实现接口：com.cownew.JDBMonitor.commo. IDBListener。IDBListener有两个方法需要实现： public void init(String arg); public void logSql(SQLInfo info); JDBMonitor会将配置文件中监听器定义中“arg”的值传递给 “init”方法、将代表SQL语句执行信息的SQLInfo传递给“logSql”方法。 更多信息请参考API文档。 下载本文示例代码


10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能10秒为任意数据库增加执行日志功能