快捷導(dǎo)航

nginx增加健康檢查接口的實(shí)現(xiàn)示例

更新時(shí)間：2024年02月20日 11:25:54 作者：Dxy1239310216

Nginx作為一款強(qiáng)大的反向代理服務(wù)和負(fù)載均衡服務(wù),而健康檢查是為了保障nginx能夠準(zhǔn)確的轉(zhuǎn)發(fā)到后端的可用服務(wù),本文主要介紹了nginx增加健康檢查接口的實(shí)現(xiàn)示例,感興趣的可以了解一下

在docker中部署的nginx或者在nginx部署的nginx一般是需要一個(gè)健康檢查接口的

這樣的話，就可以確定容器當(dāng)前的狀態(tài)是否是健康的

那么，如何給nginx增加一個(gè)健康檢查的接口呢？

接下來(lái)呢，我們就演示一個(gè)在nginx中如何增加健康檢查的接口

1、打開(kāi)nginx的配置文件（nginx.conf）

2、增加如下的location

        location /healthcheck {
            default_type text/plain;

          return 200 "ok";
        }

參數(shù)說(shuō)明：

200是請(qǐng)求這個(gè)url返回的狀態(tài)碼 OK是返回的數(shù)據(jù)
default_type text/plain;表示是純文本顯示，瀏覽器訪問(wèn)不會(huì)進(jìn)行下載！

3、檢查配置文件、重啟nginx服務(wù)

nginx -t && nginx -s reload

4、瀏覽器訪問(wèn)

OK，這樣就完成了，對(duì)一個(gè)nginx服務(wù)，增加健康檢查接口的能力。

Nginx健康檢查分為被動(dòng)探測(cè)與主動(dòng)探測(cè)兩種，

Nginx被動(dòng)健康檢查：

通過(guò)自帶健康檢查模塊ngx_http_upstream_module實(shí)現(xiàn)
當(dāng)收到訪問(wèn)時(shí)才對(duì)后端發(fā)起探測(cè)
請(qǐng)求根據(jù)轉(zhuǎn)發(fā)規(guī)則首次可能落到不可用節(jié)點(diǎn)，如多個(gè)節(jié)點(diǎn)故障則可能出現(xiàn)轉(zhuǎn)發(fā)多臺(tái)后才將請(qǐng)求轉(zhuǎn)到正常的服務(wù)，在高并發(fā)的時(shí)候影響轉(zhuǎn)發(fā)效率

max_fails：在配置的fail_timeout期間，最大的連接錯(cuò)誤數(shù)，默認(rèn)配置為1，如配置為0則表示不啟用探測(cè)，不管后端服務(wù)是否異常仍然會(huì)轉(zhuǎn)發(fā)，單位次數(shù)

fail_timeout：服務(wù)被認(rèn)為不可用的的時(shí)間，單位為s

如下配置：在3s內(nèi)中如果有1次連接失敗，則表示該節(jié)點(diǎn)不可用，將該節(jié)點(diǎn)下線3s后才會(huì)再次探測(cè)

upstream personal_1 {
       	server ip:port max_fails=1 fail_timeout=3;
      		server ip:port max_fails=1 fail_timeout=3;
}
    	server {
        	listen      80 ;
        	server_name _;
       	location ~ / {
               	proxy_pass http:// personal_1;
        	}
	}

模擬每秒1次請(qǐng)求，可以發(fā)現(xiàn)192.168.125.133服務(wù)在17:42探測(cè)異常，此時(shí)同步轉(zhuǎn)發(fā)至IP1服務(wù)，同時(shí)17:43-17:46將IP2剔除下線，17:47開(kāi)始重新探測(cè)。

Nginx主動(dòng)健康檢查：

通過(guò)nginx_upstream_check_module模塊實(shí)現(xiàn)，官方nginx暫未加載該模塊，需要自行編譯
主動(dòng)對(duì)后端服務(wù)發(fā)起探測(cè)，如后端服務(wù)不可用，則不轉(zhuǎn)發(fā)
后端服務(wù)恢復(fù)后，則主動(dòng)添加進(jìn)負(fù)載

主動(dòng)探測(cè)關(guān)鍵參數(shù)interval、rise、fall、timeout、type、check_http_send、check_http_expect_alive：

interval：健康檢查時(shí)間，單位ms

rise：檢查成功次數(shù)，達(dá)到該值則認(rèn)為服務(wù)正常，加入負(fù)載

fall：檢查失敗次數(shù)，達(dá)到該值則認(rèn)為服務(wù)異常，剔除下線

timeout：檢查超時(shí)時(shí)間，單位ms

type：檢查類型，支持tcp/http等多種協(xié)議類型

check_http_send：http探測(cè)發(fā)送的請(qǐng)求，支持自定義接口，默認(rèn)："GET / HTTP/1.0\r\n\r\n"

check_http_expect_alive：http探測(cè)狀態(tài)碼，除了該配置上的其他狀態(tài)碼均認(rèn)為服務(wù)不可用

如下配置：每1s發(fā)起主動(dòng)探測(cè)，如出現(xiàn)1次失敗，則認(rèn)為該節(jié)點(diǎn)不可用，剔除下線，檢驗(yàn)返回碼2xx/3xx則認(rèn)為服務(wù)可用。

upstream personal {
               server IP1;
               server IP2;

               check interval=1000 rise=1 fall=1 timeout=1000 type=http default_down=false;
               check_http_send "GET / HTTP/1.0\r\n\r\n";
               check_http_expect_alive http_2xx http_3xx;
        }

        server {
            listen      80 ;
            server_name _;
            location ~ / {
                proxy_pass http:// personal;
            }
        }

如下每秒探測(cè)1次，返回非2xx或3xx，服務(wù)異常，剔除下線，多次均未向該服務(wù)轉(zhuǎn)發(fā)。