快捷導(dǎo)航

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

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

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

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

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

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

接下來呢，我們就演示一個在nginx中如何增加健康檢查的接口

1、打開nginx的配置文件（nginx.conf）

2、增加如下的location

        location /healthcheck {
            default_type text/plain;

          return 200 "ok";
        }

參數(shù)說明：

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

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

nginx -t && nginx -s reload

4、瀏覽器訪問

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

Nginx健康檢查分為被動探測與主動探測兩種，

Nginx被動健康檢查：

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

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

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

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

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次請求，可以發(fā)現(xiàn)192.168.125.133服務(wù)在17:42探測異常，此時同步轉(zhuǎn)發(fā)至IP1服務(wù)，同時17:43-17:46將IP2剔除下線，17:47開始重新探測。

Nginx主動健康檢查：

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

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

interval：健康檢查時間，單位ms

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

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

timeout：檢查超時時間，單位ms

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

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

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

如下配置：每1s發(fā)起主動探測，如出現(xiàn)1次失敗，則認為該節(jié)點不可用，剔除下線，檢驗返回碼2xx/3xx則認為服務(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;
            }
        }

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