nginx_upstream_check_module笔记

nginx的http负载均衡

简单讲就是设置upstream，再proxy_pass的过程（官方文档）
其中一项不太完美的功能就是对后端真实服务器的健康检查了
好在有插件可以弥补这个缺陷：nginx_upstream_check_module

获取插件

点 我，到github页面下载zip即可

安装部署

物料准备

1. nginx
2. nginx_upstream_check_module

cd working_directory
wget https://codeload.github.com/yaoweibin/nginx_upstream_check_module/zip/master -O nginx_upstream_check_module-master.zip
unzip nginx_upstream_check_module-master.zip
wget http://nginx.org/download/nginx-1.14.0.tar.gz
tar zxf nginx-1.14.0.tar.gz && cd nginx-1.14.0
patch -p1 < ../nginx_upstream_check_module-master/check_1.14.0+.patch
./configure --prefix=/usr/local/nginx --add-module=../nginx_upstream_check_module-master/ # 其它参数略
make && make install

配置应用

以http代理来说，以下三个参数已经够用

check参数

用以定义基本的检查信息，包括了检查间隔、成功/失败次数、超时、检查模式等
默认值为：check interval=30000 fall=5 rise=2 timeout=1000 default_down=true type=tcp;
我的设定：check interval=2000 rise=2 fall=2 timeout=5000 type=http;
含义是：每2秒检查一次，连续2次成功判断正常，连续2次失败判断宕机，超时时间5秒，检查方式为http

需要注意的是
default_down=true 是默认值，在此设定下，无论你重启（restart）nginx有多迅速
你的backend server会在rise次数 * interval时间后启动，这段时间也是你业务中断期…

check_http_send

顾名思义就是检查时发送的http数据
默认值为：check_http_send “GET / HTTP/1.0\r\n\r\n”;
我在文档中没有发现到可以针对数据内容做匹配的检查方式例如检查内容中是否含有指定字符串
在此情况下GET显得没有意义，如果backend支持HEAD请求，那就改为HEAD吧，反正只判断HTTP状态码
我的设定：check_http_send “HEAD / HTTP/1.0\r\n\r\n”;

check_http_expect_alive

判断后端真实服务器是否健康的指标的状态码
默认值为：check_http_expect_alive http_2xx http_3xx;

其它指标

请移步到官方文档吧

总结

至此我们可以拿到这么一个配置：每2秒检查一次后端，访问/并获取HTTP CODE，如返回2xx或3xx则存活

配置示例

upstream cluster_1 {
    server 127.0.0.1:81;
    server 127.0.0.1:82;
    check interval=2000 rise=2 fall=2 timeout=5000 type=http;
    check_http_send "HEAD / HTTP/1.0\r\n\r\n";
    # check_http_expect_alive http_2xx http_3xx;
}

server {
    listen 80;
    access_log logs/80.log main;
    location / {
        proxy_pass http://cluster_1;
        proxy_set_header Host $host;
    }
    location /nginx_status {
        stub_status;
    }
    location /backend_status {
        check_status;
    }
}

server {
    listen 81;
    access_log logs/81.log main;
    location / {
        return 200 "localhost 81\n";
    }
}

server {
    listen 82;
    access_log logs/82.log main;
    location / {
        return 200 "localhost 82\n";
    }
}

查看后端状态

注意在 localhost:80 这个配置中的 backend_status，配置了插件提供的状态显示连接

查看状态（HTML）: /backend_status

只想看宕机的设备：/backend_status?status=down
如果想反过来只看存活的，那就status=up

不想要http想要json数据：/backend_status?status=down&format=json

好，结束