Mercurial > hg > nginx-site
comparison xml/en/docs/stream/ngx_stream_upstream_hc_module.xml @ 1951:f069d4b7a8df
Added udp example to stream_upstream_hc_module.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Fri, 24 Mar 2017 19:55:54 +0300 |
parents | ef22a80a2696 |
children | 9dd8c203a54a |
comparison
equal
deleted
inserted
replaced
1950:ef22a80a2696 | 1951:f069d4b7a8df |
---|---|
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> | 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> |
8 | 8 |
9 <module name="Module ngx_stream_upstream_hc_module" | 9 <module name="Module ngx_stream_upstream_hc_module" |
10 link="/en/docs/stream/ngx_stream_upstream_hc_module.html" | 10 link="/en/docs/stream/ngx_stream_upstream_hc_module.html" |
11 lang="en" | 11 lang="en" |
12 rev="4"> | 12 rev="5"> |
13 | 13 |
14 <section id="summary"> | 14 <section id="summary"> |
15 | 15 |
16 <para> | 16 <para> |
17 The <literal>ngx_stream_upstream_hc_module</literal> module (1.9.0) | 17 The <literal>ngx_stream_upstream_hc_module</literal> module (1.9.0) |
65 will check the ability to establish a TCP connection to each server | 65 will check the ability to establish a TCP connection to each server |
66 in the <literal>tcp</literal> group every five seconds. | 66 in the <literal>tcp</literal> group every five seconds. |
67 When a connection to the server cannot be established, | 67 When a connection to the server cannot be established, |
68 the health check will fail, and the server will | 68 the health check will fail, and the server will |
69 be considered unhealthy. | 69 be considered unhealthy. |
70 </para> | |
71 | |
72 <para> | |
73 Health checks can be configured for the UDP protocol: | |
74 <example> | |
75 upstream dns_upstream { | |
76 | |
77 zone dns_zone 64k; | |
78 | |
79 server dns1.example.com:53; | |
80 server dns2.example.com:53; | |
81 server dns3.example.com:53; | |
82 } | |
83 | |
84 server { | |
85 listen 53 udp; | |
86 proxy_pass dns_upstream; | |
87 health_check udp; | |
88 } | |
89 </example> | |
90 In this case, the absence of | |
91 ICMP “<literal>Destination Unreachable</literal>” message is expected | |
92 in reply to the sent string “<literal>nginx health check</literal>”. | |
70 </para> | 93 </para> |
71 | 94 |
72 <para> | 95 <para> |
73 Health checks can also be configured to test data obtained from the server. | 96 Health checks can also be configured to test data obtained from the server. |
74 Tests are configured separately using the <link id="match"/> directive | 97 Tests are configured separately using the <link id="match"/> directive |