Druid基本配置及內建監控使用
1. 使用方法
和dbcp類似,druid的配置項如下:
配置 |
預設值 |
說明 |
name |
配置這個屬性的意義在於,如果存在多個數據源,監控的時候 |
|
jdbcUrl |
連線資料庫的url,不同資料庫不一樣。例如: |
|
username |
連線資料庫的使用者名稱 |
|
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" />
<propertyname="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。 --> <propertyname="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中使用別名配置方式如下:
<beanid="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init"destroy-method="close">
... ...<property name="filters" value="stat" />
</bean>
StatFilter 可以和其他的Filter配置使用,比如:
<beanid="dataSource" class="com.alibaba.druid.pool.DruidDataSource"init-method="init" destroy-method="close">
... ...<property name="filters" value="stat,log4j" />
</bean>
2、怎樣使用Druid的內建監控頁面
提供監控資訊展示的html頁面 提供監控資訊的JSONAPI
注意:使用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
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>
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>