comparison xml/ru/docs/http/ngx_http_status_module.xml @ 1484:63f16dda96dc

Translated stream support in the status module in Russian.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 18 May 2015 16:19:35 +0300
parents f5b5eefc43cb
children d876f94135ac
comparison
equal deleted inserted replaced
1483:eec002ef8d0e 1484:63f16dda96dc
7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 7 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8 8
9 <module name="Модуль ngx_http_status_module" 9 <module name="Модуль ngx_http_status_module"
10 link="/ru/docs/http/ngx_http_status_module.html" 10 link="/ru/docs/http/ngx_http_status_module.html"
11 lang="ru" 11 lang="ru"
12 rev="5"> 12 rev="6">
13 13
14 <section id="summary"> 14 <section id="summary">
15 15
16 <para> 16 <para>
17 Модуль <literal>ngx_http_status_module</literal> предоставляет 17 Модуль <literal>ngx_http_status_module</literal> предоставляет
30 30
31 <section id="example" name="Пример конфигурации"> 31 <section id="example" name="Пример конфигурации">
32 32
33 <para> 33 <para>
34 <example> 34 <example>
35 upstream <emphasis>backend</emphasis> { 35 http {
36 <emphasis>zone</emphasis> upstream_backend 64k; 36 upstream <emphasis>backend</emphasis> {
37 37 <emphasis>zone</emphasis> http_backend 64k;
38 server backend1.example.com weight=5; 38
39 server backend2.example.com; 39 server backend1.example.com weight=5;
40 server backend2.example.com;
41 }
42
43 proxy_cache_path /data/nginx/cache_backend keys_zone=<emphasis>cache_backend</emphasis>:10m;
44
45 server {
46 server_name backend.example.com;
47
48 location / {
49 proxy_pass http://backend;
50 proxy_cache cache_backend;
51
52 health_check;
53 }
54
55 <emphasis>status_zone server_backend;</emphasis>
56 }
57
58 server {
59 listen 127.0.0.1;
60
61 location /upstream_conf {
62 upstream_conf;
63 }
64
65 location /status {
66 status;
67 }
68
69 location = /status.html {
70 }
71 }
40 } 72 }
41 73
42 proxy_cache_path /data/nginx/cache_backend keys_zone=<emphasis>cache_backend</emphasis>:10m; 74 stream {
43 75 upstream <emphasis>backend</emphasis> {
44 server { 76 <emphasis>zone</emphasis> stream_backend 64k;
45 server_name backend.example.com; 77
46 78 server backend1.example.com:12345 weight=5;
47 location / { 79 server backend2.example.com:12345;
48 proxy_pass http://backend; 80 }
49 proxy_cache cache_backend; 81
50 82 server {
83 listen 127.0.0.1:12345;
84 proxy_pass backend;
85 <emphasis>status_zone server_backend;</emphasis>
51 health_check; 86 health_check;
52 }
53
54 <emphasis>status_zone server_backend;</emphasis>
55 }
56
57 server {
58 listen 127.0.0.1;
59
60 location /upstream_conf {
61 upstream_conf;
62 }
63
64 location /status {
65 status;
66 }
67
68 location = /status.html {
69 } 87 }
70 } 88 }
71 </example> 89 </example>
72 </para> 90 </para>
73 91
80 http://127.0.0.1/status/caches/cache_backend 98 http://127.0.0.1/status/caches/cache_backend
81 http://127.0.0.1/status/upstreams 99 http://127.0.0.1/status/upstreams
82 http://127.0.0.1/status/upstreams/backend 100 http://127.0.0.1/status/upstreams/backend
83 http://127.0.0.1/status/upstreams/backend/1 101 http://127.0.0.1/status/upstreams/backend/1
84 http://127.0.0.1/status/upstreams/backend/1/weight 102 http://127.0.0.1/status/upstreams/backend/1/weight
103 http://127.0.0.1/status/stream
104 http://127.0.0.1/status/stream/upstreams
105 http://127.0.0.1/status/stream/upstreams/backend
106 http://127.0.0.1/status/stream/upstreams/backend/1
107 http://127.0.0.1/status/stream/upstreams/backend/1/weight
85 </example> 108 </example>
86 </para> 109 </para>
87 110
88 <para> 111 <para>
89 В составе дистрибутива nginx имеется простая страница мониторинга, доступная 112 В составе дистрибутива nginx имеется простая страница мониторинга, доступная
137 <syntax><value>зона</value></syntax> 160 <syntax><value>зона</value></syntax>
138 <default/> 161 <default/>
139 <context>server</context> 162 <context>server</context>
140 163
141 <para> 164 <para>
142 Включает сбор информации о состоянии виртуального 165 Включает сбор информации о состоянии виртуального сервера группы
143 <link doc="ngx_http_core_module.xml" id="server">сервера</link> 166 <link doc="ngx_http_core_module.xml" id="server">http</link>
144 в указанной <value>зоне</value>. 167 или
168 <link doc="../stream/ngx_stream_core_module.xml" id="server">stream</link>
169 (1.7.11) в указанной <value>зоне</value>.
145 В одной и той же зоне может одновременно собираться информация 170 В одной и той же зоне может одновременно собираться информация
146 сразу по нескольким виртуальным серверам. 171 сразу по нескольким серверам.
147 </para> 172 </para>
148 173
149 </directive> 174 </directive>
150 175
151 </section> 176 </section>
578 </tag-desc> 603 </tag-desc>
579 604
580 </list> 605 </list>
581 </tag-desc> 606 </tag-desc>
582 607
608 <tag-name id="stream"><literal>stream</literal></tag-name>
609 <tag-desc>
610
611 <list type="tag">
612 <tag-name><literal>server_zones</literal></tag-name>
613 <tag-desc>
614 Для каждой <link id="status_zone"/>:
615 <list type="tag">
616
617 <tag-name><literal>processing</literal></tag-name>
618 <tag-desc>
619 Число обрабатываемых в настоящий момент
620 клиентских соединений.
621 </tag-desc>
622
623 <tag-name><literal>connections</literal></tag-name>
624 <tag-desc>
625 Суммарное число
626 соединений, полученных от клиентов.
627 </tag-desc>
628
629 <tag-name><literal>received</literal></tag-name>
630 <tag-desc>
631 Суммарное число байт, полученных от клиентов.
632 </tag-desc>
633
634 <tag-name><literal>sent</literal></tag-name>
635 <tag-desc>
636 Суммарное число байт, отправленных клиентам.
637 </tag-desc>
638
639 </list>
640 </tag-desc>
641
642 <tag-name><literal>upstreams</literal></tag-name>
643 <tag-desc>
644 Для каждого
645 <link doc="../stream/ngx_stream_upstream_module.xml" id="server">сервера</link>
646 в
647 <link doc="../stream/ngx_stream_upstream_module.xml" id="zone">динамически
648 настраиваемой</link>
649 <link doc="../stream/ngx_stream_upstream_module.xml" id="upstream">группе</link>
650 доступны следующие данные:
651 <list type="tag">
652
653 <tag-name><literal>id</literal></tag-name>
654 <tag-desc>
655 Идентификатор сервера.
656 </tag-desc>
657
658 <tag-name><literal>server</literal></tag-name>
659 <tag-desc>
660 <link doc="../stream/ngx_stream_upstream_module.xml" id="server">Адрес</link>
661 сервера.
662 </tag-desc>
663
664 <tag-name><literal>backup</literal></tag-name>
665 <tag-desc>
666 Логическое значение, означающее, является ли сервер
667 <link doc="../stream/ngx_stream_upstream_module.xml" id="backup">запасным</link>.
668 </tag-desc>
669
670 <tag-name><literal>weight</literal></tag-name>
671 <tag-desc>
672 <link doc="../stream/ngx_stream_upstream_module.xml" id="weight">Вес</link>
673 сервера.
674 </tag-desc>
675
676 <tag-name><literal>state</literal></tag-name>
677 <tag-desc>
678 Текущее состояние, которое может быть одним из
679 “<literal>up</literal>”,
680 “<literal>down</literal>”,
681 “<literal>unavail</literal>”
682 или
683 “<literal>unhealthy</literal>”.
684 </tag-desc>
685
686 <tag-name><literal>active</literal></tag-name>
687 <tag-desc>
688 Текущее число соединений.
689 </tag-desc>
690
691 <tag-name><literal>connections</literal></tag-name>
692 <tag-desc>
693 Суммарное число
694 клиентских соединений, перенаправленных на этот сервер.
695 </tag-desc>
696
697 <tag-name><literal>connect_time</literal></tag-name>
698 <tag-desc>
699 Среднее время установки соединения с сервером группы.
700 Поле доступно при использовании метода балансировки
701 <link doc="../stream/ngx_stream_upstream_module.xml" id="least_time"/>.
702 </tag-desc>
703
704 <tag-name><literal>first_byte_time</literal></tag-name>
705 <tag-desc>
706 Среднее время получения первого байта данных.
707 Поле доступно при использовании метода балансировки
708 <link doc="../stream/ngx_stream_upstream_module.xml" id="least_time"/>.
709 </tag-desc>
710
711 <tag-name><literal>response_time</literal></tag-name>
712 <tag-desc>
713 Среднее время получения последнего байта данных.
714 Поле доступно при использовании метода балансировки
715 <link doc="../stream/ngx_stream_upstream_module.xml" id="least_time"/>.
716 </tag-desc>
717
718 <tag-name><literal>sent</literal></tag-name>
719 <tag-desc>
720 Суммарное число байт, отправленных на этот сервер.
721 </tag-desc>
722
723 <tag-name><literal>received</literal></tag-name>
724 <tag-desc>
725 Суммарное число байт, полученных с этого сервера.
726 </tag-desc>
727
728 <tag-name><literal>fails</literal></tag-name>
729 <tag-desc>
730 Суммарное число
731 неудачных попыток работы с этим сервером.
732 </tag-desc>
733
734 <tag-name><literal>unavail</literal></tag-name>
735 <tag-desc>
736 Количество раз, когда
737 сервер становился недоступным для клиентских соединений
738 (состояние “<literal>unavail</literal>”)
739 из-за достижения порогового числа неудачных попыток
740 <link doc="../stream/ngx_stream_upstream_module.xml" id="max_fails"/>.
741 </tag-desc>
742
743 <tag-name><literal>health_checks</literal></tag-name>
744 <tag-desc>
745 <list type="tag">
746
747 <tag-name><literal>checks</literal></tag-name>
748 <tag-desc>
749 Суммарное число запросов
750 <link doc="../stream/ngx_stream_upstream_module.xml" id="health_check">проверки
751 работоспособности</link>.
752 </tag-desc>
753
754 <tag-name><literal>fails</literal></tag-name>
755 <tag-desc>
756 Число неудачных проверок работоспособности.
757 </tag-desc>
758
759 <tag-name><literal>unhealthy</literal></tag-name>
760 <tag-desc>
761 Количество раз, когда
762 сервер становился неработоспособным (состояние “<literal>unhealthy</literal>”).
763 </tag-desc>
764
765 <tag-name><literal>last_passed</literal></tag-name>
766 <tag-desc>
767 Логическое значение, означающее, была ли последняя проверка
768 работоспособности удачной и удовлетворял ли ответ заданным
769 <link doc="../stream/ngx_stream_upstream_module.xml" id="match">тестам</link>.
770 </tag-desc>
771
772 </list>
773 </tag-desc>
774
775 <tag-name><literal>downtime</literal></tag-name>
776 <tag-desc>
777 Суммарное время,
778 когда сервер находился в состояниях “<literal>unavail</literal>”
779 и “<literal>unhealthy</literal>”.
780 </tag-desc>
781
782 <tag-name><literal>downstart</literal></tag-name>
783 <tag-desc>
784 Время (в миллисекундах с начала эпохи),
785 когда сервер стал
786 “<literal>unavail</literal>”
787 или “<literal>unhealthy</literal>”.
788 </tag-desc>
789
790 <tag-name><literal>selected</literal></tag-name>
791 <tag-desc>
792 Время (в миллисекундах с начала эпохи),
793 когда сервер в последний раз был выбран для обработки соединения.
794 </tag-desc>
795
796 </list>
797 </tag-desc>
798
799 </list>
800 </tag-desc>
801
583 </list> 802 </list>
584 </para> 803 </para>
585 804
586 </section> 805 </section>
587 806
591 <list type="bullet"> 810 <list type="bullet">
592 811
593 <listitem> 812 <listitem>
594 Поле <literal>keepalive</literal> сервера группы 813 Поле <literal>keepalive</literal> сервера группы
595 было удалено в <link id="version">версии</link> 5. 814 было удалено в <link id="version">версии</link> 5.
815 </listitem>
816
817 <listitem>
818 <link id="stream">stream</link>
819 был добавлен в <link id="version">версии</link> 5.
596 </listitem> 820 </listitem>
597 821
598 <listitem> 822 <listitem>
599 Поле <link id="generation"/> 823 Поле <link id="generation"/>
600 было добавлено в <link id="version">версии</link> 5. 824 было добавлено в <link id="version">версии</link> 5.