Druid--基本配置及內建監控使用
一、使用方法
1,druid的可選配置項如下:
配置 |
預設值 |
說明 |
name |
配置這個屬性的意義在於,如果存在多個數據源,監控的時候可以通過名字來區分開來。如果沒有配置,將會生成一個名字,格式是:"DataSource-" + System.identityHashCode(this) |
|
jdbcUrl |
連線資料庫的url,不同資料庫不一樣。例如: |
|
username |
連線資料庫的使用者名稱 |
|
driverClassName |
根據url自動識別 |
這一項可配可不配,如果不配置druid會根據url自動識別dbType,然後選擇相應的driverClassName |
initialSize |
0 |
初始化時建立物理連線的個數。初始化發生在顯示呼叫init方法,或者第一次getConnection時 |
maxActive |
8 |
最大連線池數量 |
maxIdle |
8 |
已經不再使用,配置了也沒效果 |
minIdle |
最小連線池數量 |
|
maxWait |
獲取連線時最大等待時間,單位毫秒。配置了 |
|
poolPreparedStatements |
false |
是否快取preparedStatement,也就是PSCache。 |
maxOpenPreparedStatements |
-1 |
要啟用PSCache,必須配置大於0,當大於0時, |
validationQuery |
用來檢測連線是否有效的sql,要求是一個查詢語句。如果validationQuery為null,testOnBorrow、testOnReturn、 |
|
testOnBorrow |
true |
申請連線時執行validationQuery檢測連線是否有效,做了這個配置會降低效能。 |
testOnReturn |
false |
歸還連線時執行validationQuery檢測連線是否有效,做了這個配置會降低效能 |
testWhileIdle |
false |
建議配置為true,不影響效能,並且保證安全性。申請連線的時候檢測,如果空閒時間大於 |
timeBetweenEvictionRunsMillis |
有兩個含義: |
|
numTestsPerEvictionRun |
不再使用,一個DruidDataSource只支援一個EvictionRun |
|
minEvictableIdleTimeMillis |
||
connectionInitSqls |
物理連線初始化的時候執行的sql |
|
exceptionSorter |
根據dbType自動識別 |
當資料庫丟擲一些不可恢復的異常時,拋棄連線 |
filters |
屬性型別是字串,通過別名的方式配置擴充套件外掛,常用的外掛有:監控統計用的filter:stat |
|
proxyFilters |
型別是List<com.alibaba.druid.filter.Filter>,如果同時配置了filters和proxyFilters,是組合關係,並非替換關係 |
2,常用配置屬性
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物件時檢測其可用性),不過這樣會影響效能。
3,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>
4、手動建立datasource
如果不使用框架開發,也可以手動建立連線,採用或者的方式均可,前者需要手動設定引數值,後者自動從配置檔案中讀取,可根據需要使用。
二、使用Druid的內建監控功能
1、怎麼開啟Druid的監控統計功能
Druid的監控統計功能是通過filter-chain擴充套件實現,如果你要開啟監控統計功能,配置,的別名是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>
可以和其他的Filter配置使用,比如:
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
... ...
<property name="filters" value="stat,log4j" />
</bean>
2、怎樣使用Druid的內建監控頁面
提供監控資訊展示的html頁面 提供監控資訊的JSON API
注意:使用,建議使用druid 0.2.6以上版本。
1) 配置web.xml
是一個標準的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
展示出來的監控資訊比較敏感,是系統執行的內部情況,如果你需要做訪問控制,可以配置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關聯監控怎麼配置?
用於採集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>