Druid基本配置及内置监控使用_动力节点Java学院整理

1.  使用方法

首先从http://repo1.maven.org/maven2/com/alibaba/druid/ 下载最新的jar包。如果想使用最新的源码编译，可以从https://github.com/alibaba/druid 下载源码，然后使用maven命令行，或者导入到eclipse中进行编译。
和dbcp类似，druid的配置项如下：

表1.1 配置属性

根据常用的配置属性，首先给出一个如下的配置文件，放置于src目录下。

url:jdbc:mysql://localhost:3306/dragoon_v25_masterdb
driverClassName:com.mysql.jdbc.Drive
username:root
password:aaaaaaaa
filters:stat
maxActive:20
initialSize:1
maxWait:60000
minIdle:10
#maxIdle:15
timeBetweenEvictionRunsMillis:60000
minEvictableIdleTimeMillis:300000
validationQuery:SELECT 'x'
testWhileIdle:true
testOnBorrow:false
testOnReturn:false
#poolPreparedStatements:true
maxOpenPreparedStatements:20
removeAbandoned:true #对于长时间不使用的连接强制关闭
removeAbandonedTimeout:1800 #超过30分钟开始关闭空闲连接
logAbandoned:true #将当前关闭动作记录到日志

配置文件

配置项中指定了各个参数后，在连接池内部是这么使用这些参数的。数据库连接池在初始化的时候会创建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)的方式均可，前者需要手动设置参数值，后者自动从配置文件中读取，可根据需要使用。

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-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>