Druid基本配置及内置监控使用

时间 2019-11-09

原文原文链接

Druid基本配置及内置监控使用 css

1. 使用方法

首先从http://repo1.maven.org/maven2/com/alibaba/druid/ 下载最新的jar包。若是想使用最新的源码编译，能够从https://github.com/alibaba/druid 下载源码，而后使用maven命令行，或者导入到eclipse中进行编译。 html

和dbcp相似，druid的配置项以下： java

配置 mysql	缺省值 git	说明 github
name web		配置这个属性的意义在于，若是存在多个数据源，监控的时候能够经过名字来区分开来。若是没有配置，将会生成一个名字，格式是："DataSource-" + System.identityHashCode(this) spring
jdbcUrl sql		链接数据库的url，不一样数据库不同。例如： mysql : jdbc:mysql://10.20.153.104:3306/druid2 oracle : jdbc:oracle:thin:@10.20.149.85:1521:ocnauto 数据库
username		链接数据库的用户名
password		链接数据库的密码。若是你不但愿密码直接写在配置文件中，可使用ConfigFilter。详细看这里： https://github.com/alibaba/druid/wiki/%E4%BD%BF%E7%94%A8ConfigFilter
driverClassName	根据url自动识别	这一项可配可不配，若是不配置druid会根据url自动识别dbType，而后选择相应的driverClassName
initialSize	0	初始化时创建物理链接的个数。初始化发生在显示调用init方法，或者第一次getConnection时
maxActive	8	最大链接池数量
maxIdle	8	已经再也不使用，配置了也没效果
minIdle		最小链接池数量
maxWait		获取链接时最大等待时间，单位毫秒。配置了maxWait以后，缺省启用公平锁，并发效率会有所降低，若是须要能够经过配置useUnfairLock属性为true使用非公平锁。
poolPreparedStatements	false	是否缓存preparedStatement，也就是PSCache。 PSCache对支持游标的数据库性能提高巨大，好比说oracle。在mysql5.5如下的版本中没有PSCache功能，建议关闭掉。 5.5及以上版本有PSCache，建议开启。
maxOpenPreparedStatements	-1	要启用PSCache，必须配置大于0，当大于0时， poolPreparedStatements自动触发修改成true。在Druid中，不会存在Oracle下PSCache占用内存过多的问题，能够把这个数值配置大一些，好比说100
validationQuery		用来检测链接是否有效的sql，要求是一个查询语句。若是validationQuery为null，testOnBorrow、testOnReturn、 testWhileIdle都不会其做用。
testOnBorrow	true	申请链接时执行validationQuery检测链接是否有效，作了这个配置会下降性能。
testOnReturn	false	归还链接时执行validationQuery检测链接是否有效，作了这个配置会下降性能
testWhileIdle	false	建议配置为true，不影响性能，而且保证安全性。申请链接的时候检测，若是空闲时间大于 timeBetweenEvictionRunsMillis，执行validationQuery检测链接是否有效。
timeBetweenEvictionRunsMillis		有两个含义： 1) Destroy线程会检测链接的间隔时间 2) testWhileIdle的判断依据，详细看testWhileIdle属性的说明
numTestsPerEvictionRun		再也不使用，一个DruidDataSource只支持一个EvictionRun
minEvictableIdleTimeMillis
connectionInitSqls		物理链接初始化的时候执行的sql
exceptionSorter	根据dbType自动识别	当数据库抛出一些不可恢复的异常时，抛弃链接
filters		属性类型是字符串，经过别名的方式配置扩展插件，经常使用的插件有：监控统计用的filter:stat 日志用的filter:log4j 防护sql注入的filter:wall
proxyFilters		类型是List<com.alibaba.druid.filter.Filter>，若是同时配置了filters和proxyFilters，是组合关系，并不是替换关系

表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文件中，配置以下：  <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource "

init-method="init" destroy-method="close">  <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="poolPreparedStatements" value="false" /> <property name="maxPoolPreparedStatementPerConnectionSize" value="20" />

<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中使用别名配置方式以下：

... ... <property name="filters" value="stat" />

</bean>

StatFilter 能够和其余的Filter配置使用，好比：

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