原文鏈接 http://tengine.taobao.org/document_cn/http_upstream_check_cn.html
ngx_http_upstream_check_module 該模塊可以為Tengine提供主動式后端服務器健康檢查的功能。 該模塊在Tengine-1.4.0版本以前沒有默認開啟，它可以在配置編譯選項的時候開啟：./configure --with-http_upstream_check_module Examples http { upstream cluster1 { # simple round-robin server 192.168.0.1:80; server 192.168.0.2:80; check interval=3000 rise=2 fall=5 timeout=1000 type=http; check_http_send "HEAD / HTTP/1.0\r\n\r\n"; check_http_expect_alive http_2xx http_3xx; } upstream cluster2 { # simple round-robin server 192.168.0.3:80; server 192.168.0.4:80; check interval=3000 rise=2 fall=5 timeout=1000 type=http; check_keepalive_requests 100; check_http_send "HEAD / HTTP/1.1\r\nConnection: keep-alive\r\n\r\n"; check_http_expect_alive http_2xx http_3xx; } server { listen 80; location /1 { proxy_pass http://cluster1; } location /2 { proxy_pass http://cluster2; } location /status { check_status; access_log off; allow SOME.IP.ADD.RESS; deny all; } } } 指令 Syntax: check interval=milliseconds [fall=count] [rise=count] [timeout=milliseconds] [default_down=true|false] [type=tcp|http|ssl_hello|mysql|ajp] [port=check_port] Default: 如果沒有配置參數，默認值是：interval=30000 fall=5 rise=2 timeout=1000 default_down=true type=tcp Context: upstream 該指令可以打開后端服務器的健康檢查功能。 指令后面的參數意義是： interval：向后端發送的健康檢查包的間隔。 fall(fall_count): 如果連續失敗次數達到fall_count，服務器就被認為是down。 rise(rise_count): 如果連續成功次數達到rise_count，服務器就被認為是up。 timeout: 后端健康請求的超時時間。 default_down: 設定初始時服務器的狀態，如果是true，就說明默認是down的，如果是false，就是up的。默認值是true，也就是一開始服務器認為是不可用，要等健康檢查包達到一定成功次數以后才會被認為是健康的。 type：健康檢查包的類型，現在支持以下多種類型 tcp：簡單的tcp連接，如果連接成功，就說明后端正常。 ssl_hello：發送一個初始的SSL hello包並接受服務器的SSL hello包。 http：發送HTTP請求，通過后端的回復包的狀態來判斷后端是否存活。 mysql: 向mysql服務器連接，通過接收服務器的greeting包來判斷后端是否存活。 ajp：向后端發送AJP協議的Cping包，通過接收Cpong包來判斷后端是否存活。 port: 指定后端服務器的檢查端口。你可以指定不同於真實服務的后端服務器的端口，比如后端提供的是443端口的應用，你可以去檢查80端口的狀態來判斷后端健康狀況。默認是0，表示跟后端server提供真實服務的端口一樣。該選項出現於Tengine-1.4.0。 Syntax: check_keepalive_requests request_num Default: 1 Context: upstream 該指令可以配置一個連接發送的請求數，其默認值為1，表示Tengine完成1次請求后即關閉連接。 Syntax: check_http_send http_packet Default: "GET / HTTP/1.0\r\n\r\n" Context: upstream 該指令可以配置http健康檢查包發送的請求內容。為了減少傳輸數據量，推薦采用"HEAD"方法。 當采用長連接進行健康檢查時，需在該指令中添加keep-alive請求頭，如："HEAD / HTTP/1.1\r\nConnection: keep-alive\r\n\r\n"。 同時，在采用"GET"方法的情況下，請求uri的size不宜過大，確保可以在1個interval內傳輸完成，否則會被健康檢查模塊視為后端服務器或網絡異常。 Syntax: check_http_expect_alive [ http_2xx | http_3xx | http_4xx | http_5xx ] Default: http_2xx | http_3xx Context: upstream 該指令指定HTTP回復的成功狀態，默認認為2XX和3XX的狀態是健康的。 Syntax: check_shm_size size Default: 1M Context: http 所有的后端服務器健康檢查狀態都存於共享內存中，該指令可以設置共享內存的大小。默認是1M，如果你有1千台以上的服務器並在配置的時候出現了錯誤，就可能需要擴大該內存的大小。 Syntax: check_status [html|csv|json] Default: check_status html Context: location 顯示服務器的健康狀態頁面。該指令需要在http塊中配置。 在Tengine-1.4.0以后，你可以配置顯示頁面的格式。支持的格式有: html、csv、 json。默認類型是html。 你也可以通過請求的參數來指定格式，假設‘/status’是你狀態頁面的URL， format參數改變頁面的格式，比如： /status?format=html /status?format=csv /status?format=json 同時你也可以通過status參數來獲取相同服務器狀態的列表，比如： /status?format=html&status=down /status?format=csv&status=up 下面是一個HTML狀態頁面的例子（server number是后端服務器的數量，generation是Nginx reload的次數。Index是服務器的索引，Upstream是在配置中upstream的名稱，Name是服務器IP，Status是服務器的狀態，Rise是服務器連續檢查成功的次數，Fall是連續檢查失敗的次數，Check type是檢查的方式，Check port是后端專門為健康檢查設置的端口）： <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>Nginx http upstream check status</title> </head> <body> <h1>Nginx http upstream check status</h1> <h2>Check upstream server number: 1, generation: 3</h2> <table style="background-color:white" cellspacing="0" cellpadding="3" border="1"> <tr bgcolor="#C0C0C0"> <th>Index</th> <th>Upstream</th> <th>Name</th> <th>Status</th> <th>Rise counts</th> <th>Fall counts</th> <th>Check type</th> <th>Check port</th> </tr> <tr> <td>0</td> <td>backend</td> <td>106.187.48.116:80</td> <td>up</td> <td>39</td> <td>0</td> <td>http</td> <td>80</td> </tr> </table> </body> </html> 下面是csv格式頁面的例子： 0,backend,106.187.48.116:80,up,46,0,http,80 下面是json格式頁面的例子： {"servers": { "total": 1, "generation": 3, "server": [ {"index": 0, "upstream": "backend", "name": "106.187.48.116:80", "status": "up", "rise": 58, "fall": 0, "type": "http", "port": 80} ] }}