Mercurial > hg > nginx-site

comparison xml/en/docs/stream/ngx_stream_upstream_hc_module.xml @ 1951:f069d4b7a8df

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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