Druid基本配置及内置监控使用
1. 使用方法
首先从http://repo1.maven.org/maven2/com/alibaba/druid/ 下载最新的jar包。如果想使用最新的源码编译,可以从https://github.com/alibaba/druid 下载源码,然后使用maven命令行,或者导入到eclipse中进行编译。
和dbcp类似,druid的配置项如下:
配置 | 缺省值 | 说明 |
name |
| 配置这个属性的意义在于,如果存在多个数据源,监控的时候 |
jdbcUrl |
| 连接数据库的url,不同数据库不一样。例如: |
username |
| 连接数据库的用户名 |
password |
| 连接数据库的密码。如果你不希望密码直接写在配置文件中, |
driverClassName | 根据url自动识别 | 这一项可配可不配,如果不配置druid会根据url自动识别dbType, |
initialSize | 0 | 初始化时建立物理连接的个数。初始化发生在显示调用init方法, |
maxActive | 8 | 最大连接池数量 |
maxIdle | 8 | 已经不再使用,配置了也没效果 |
minIdle |
| 最小连接池数量 |
maxWait |
| 获取连接时最大等待时间,单位毫秒。配置了maxWait之后, |
poolPreparedStatements | false | 是否缓存preparedStatement,也就是PSCache。 |
maxOpenPreparedStatements | -1 | 要启用PSCache,必须配置大于0,当大于0时, |
validationQuery |
| 用来检测连接是否有效的sql,要求是一个查询语句。 |
testOnBorrow | true | 申请连接时执行validationQuery检测连接是否有效, |
testOnReturn | false | 归还连接时执行validationQuery检测连接是否有效, |
testWhileIdle | false | 建议配置为true,不影响性能,并且保证安全性。 |
timeBetweenEvictionRunsMillis |
| 有两个含义: |
numTestsPerEvictionRun |
| 不再使用,一个DruidDataSource只支持一个EvictionRun |
minEvictableIdleTimeMillis |
|
|
connectionInitSqls |
| 物理连接初始化的时候执行的sql |
exceptionSorter | 根据dbType自动识别 | 当数据库抛出一些不可恢复的异常时,抛弃连接 |
filters |
| 属性类型是字符串,通过别名的方式配置扩展插件, |
proxyFilters |
| 类型是List<com.alibaba.druid.filter.Filter>, |
表1.1 配置属性
根据常用的配置属性,首先给出一个如下的配置文件,放置于src目录下。
1. url:jdbc:mysql://localhost:3306/dragoon_v25_masterdb
2. driverClassName:com.mysql.jdbc.Driver
3. username:root
4. password:aaaaaaaa
5. filters:stat
6. maxActive:20
7. initialSize:1
8. maxWait:60000
9. minIdle:10
10. #maxIdle:15
11. timeBetweenEvictionRunsMillis:60000
12. minEvictableIdleTimeMillis:300000
13. validationQuery:SELECT 'x'
14. testWhileIdle:true
15. testOnBorrow:false
16. testOnReturn:false
17. #poolPreparedStatements:true
18. maxOpenPreparedStatements:20
19. #对于长时间不使用的连接强制关闭
20. removeAbandoned:true
21. #超过30分钟开始关闭空闲连接
22. removeAbandonedTimeout:1800
23. #将当前关闭动作记录到日志
24. logAbandoned:true
配置文件1.1
配置项中指定了各个参数后,在连接池内部是这么使用这些参数的。数据库连接池在初始化的时候会创建initialSize个连接,当有数据库操作时,会从池中取出一个连接。如果当前池中正在使用的连接数等于maxActive,则会等待一段时间,等待其他操作释放掉某一个连接,如果这个等待时间超过了maxWait,则会报错;如果当前正在使用的连接数没有达到maxActive,则判断当前是否空闲连接,如果有则直接使用空闲连接,如果没有则新建立一个连接。在连接使用完毕后,不是将其物理连接关闭,而是将其放入池中等待其他操作复用。 同时连接池内部有机制判断,如果当前的总的连接数少于miniIdle,则会建立新的空闲连接,以保证连接数得到miniIdle。如果当前连接池中某个连接在空闲了timeBetweenEvictionRunsMillis时间后任然没有使用,则被物理性的关闭掉。有些数据库连接的时候有超时限制(mysql连接在8小时后断开),或者由于网络中断等原因,连接池的连接会出现失效的情况,这时候设置一个testWhileIdle参数为true,可以保证连接池内部定时检测连接的可用性,不可用的连接会被抛弃或者重建,最大情况的保证从连接池中得到的Connection对象是可用的。当然,为了保证绝对的可用性,你也可以使用testOnBorrow为true(即在获取Connection对象时检测其可用性),不过这样会影响性能。
1、Spring中的配置
在applicationContext.xml文件中,配置如下: <!-- 使用Druid连接池 --> <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource "
init-method="init" destroy-method="close"> <!-- 基本属性 url、user、password --> <property name="url" value="jdbc:mysql://localhost:3306/test?zeroDateTimeBehavior=convertToNull " /> <property name="username" value="wlxu" /> <property name="password" value="wlxusstcd201403" /> <property name="connectionProperties" value="com.mysql.jdbc.Driver"></property>
<!-- 配置初始化大小、最小、最大 --> <property name="initialSize" value="1" /> <property name="minIdle" value="1" /> <property name="maxActive" value="20" />
<!-- 配置获取连接等待超时的时间 --> <property name="maxWait" value="60000" />
<!-- 配置间隔多久才进行一次检测,检测需要关闭的空闲连接,单位是毫秒 --> <property name="timeBetweenEvictionRunsMillis" value="60000" />
<!-- 配置一个连接在池中最小生存的时间,单位是毫秒 --> <property name="minEvictableIdleTimeMillis" value="300000" />
<property name="validationQuery" value="SELECT 'x'" /> <property name="testWhileIdle" value="true" /> <property name="testOnBorrow" value="false" /> <property name="testOnReturn" value="false" />
<!-- 打开PSCache,并且指定每个连接上PSCache的大小 --> <!-- 如果用Oracle,则把poolPreparedStatements配置为true,mysql可以配置为false。分库分表较多的数据库,建议配置为false。 --> <property name="poolPreparedStatements" value="false" /> <property name="maxPoolPreparedStatementPerConnectionSize" value="20" />
<!-- 配置监控统计拦截的filters,去掉后监控界面sql无法统计 --> <property name="filters" value="stat" />
</bean>
2、手动创建datasource
如果不使用框架开发,也可以手动创建连接,采用new DruidDataSource ()或者DruidDataSourceFactory .createDataSource(properties)的方式均可,前者需要手动设置参数值,后者自动从配置文件中读取,可根据需要使用。
以上内容可以参考:http://blog.csdn.net/yunnysunny/article/details/8657095
2. 使用Druid的内置监控功能
1、怎么打开Druid的监控统计功能
Druid的监控统计功能是通过filter-chain扩展实现,如果你要打开监控统计功能,配置StatFilter ,StatFilter 的别名是stat,这个别名映射配置信息保存在druid-xxx.jar!/META-INF/druid-filter.properties。 在spring中使用别名配置方式如下:
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
... ... <property name="filters" value="stat" />
</bean>
StatFilter 可以和其他的Filter配置使用,比如:
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
... ... <property name="filters" value="stat,log4j" />
</bean>
其他详情可以参考:https://github.com/alibaba/druid/wiki/%E9%85%8D%E7%BD%AE_StatFilter
2、怎样使用Druid的内置监控页面
Druid内置提供了一个StatViewServlet 用于展示Druid的统计信息。 这个StatViewServlet 的用途包括:
提供监控信息展示的html页面 提供监控信息的JSON API
注意:使用StatViewServlet ,建议使用druid 0.2.6以上版本。
1) 配置web.xml
StatViewServlet 是一个标准的javax.servlet.http.HttpServlet ,需要配置在你web应用中的WEB-INF/web.xml中。
<servlet>
<servlet-name>DruidStatView </servlet-name> <servlet-class>com.alibaba.druid.support.http.StatViewServlet </servlet-class>
</servlet> <servlet-mapping>
<servlet-name>DruidStatView </servlet-name> <url-pattern>/druid/*</url-pattern>
</servlet-mapping>
根据配置中的url-pattern来访问内置监控页面,如果是上面的配置,内置监控页面的首页是/druid/index.html
例如:http://110.76.43.235:9000/druid/index.html ,http://110.76.43.235:8080/mini-web/druid/index.html
2) 配置allow和deny
StatViewSerlvet 展示出来的监控信息比较敏感,是系统运行的内部情况,如果你需要做访问控制,可以配置allow和deny这两个参数。比如:
<servlet>
<servlet-name>DruidStatView </servlet-name> <servlet-class>com.alibaba.druid.support.http.StatViewServlet </servlet-class>
<init-param>
<param-name>allow</param-name> <param-value>128.242.127.1/24,128.242.128.1</param-value>
</init-param> <init-param>
<param-name>deny</param-name> <param-value>128.242.127.4</param-value>
</init-param>
</servlet>
判断规则:deny优先于allow,如果在deny列表中,就算在allow列表中,也会被拒绝。如果allow没有配置或者为空,则允许所有访问 其他详情参考:https://github.com/alibaba/druid/wiki/%E9%85%8D%E7%BD%AE_StatViewServlet%E9%85%8D%E7%BD%AE
3、内置监控中的Web和Spring关联监控怎么配置?
WebStatFilter 用于采集web-jdbc关联监控的数据。
1)web.xml配置 <filter>
<filter-name>DruidWebStatFilter </filter-name> <filter-class>com.alibaba.druid.support.http.WebStatFilter </filter-class> <init-param>
<param-name>exclusions</param-name> <param-value>*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*</param-value>
</init-param>
</filter> <filter-mapping>
<filter-name>DruidWebStatFilter </filter-name> <url-pattern>/*</url-pattern>
</filter-mapping> 2)exlusions配置
经常需要排除一些不必要的url,比如.js,/jslib/等等。配置在init-param中。比如: <init-param>
<param-name>exclusions</param-name> <param-value>*.js,*.gif,*.jpg,*.png,*.css,*.ico,/druid/*</param-value>
</init-param>
3)sessionStatMaxCount配置
缺省sessionStatMaxCount是1000个。你可以按需要进行配置,比如: <init-param>
<param-name>sessionStatMaxCount</param-name> <param-value>1000</param-value>
</init-param>
4)sessionStatEnable配置
你可以关闭session统计功能,比如:
<init-param>
<param-name>sessionStatEnable</param-name> <param-value>false</param-value>
</init-param>
5)principalSessionName配置
你可以配置principalSessionName,使得druid能够知道当前的session的用户是谁。比如:
<init-param>
<param-name>principalSessionName</param-name> <param-value>xxx.user</param-value>
</init-param> 根据需要,把其中的xxx.user修改为你user信息保存在session中的sessionName。
注意:如果你session中保存的是非string类型的对象,需要重载toString方法。
6)principalCookieName
如果你的user信息保存在cookie中,你可以配置principalCookieName,使得druid知道当前的user是谁
<init-param>
<param-name>principalCookieName</param-name> <param-value>xxx.user</param-value>
</init-param> 根据需要,把其中的xxx.user修改为你user信息保存在cookie中的cookieName
7)profileEnable
druid 0.2.7版本开始支持profile,配置profileEnable能够监控单个url调用的sql列表。
<init-param>
<param-name>profileEnable</param-name> <param-value>true</param-value>
</init-param>
Druid的其他相关问题可以查看:https://github.com/alibaba/druid/wiki/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98