Mercurial > hg > nginx-site
changeset 1247:7020b8262dc0
Russian translation of ngx_http_status_module.
author | Ruslan Ermilov <ru@nginx.com> |
---|---|
date | Wed, 09 Jul 2014 13:39:09 +0400 |
parents | 5be7716a5684 |
children | 6d51bb4f19f7 |
files | xml/ru/GNUmakefile xml/ru/docs/http/ngx_http_status_module.xml xml/ru/docs/index.xml |
diffstat | 3 files changed, 491 insertions(+), 0 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/ru/GNUmakefile +++ b/xml/ru/GNUmakefile @@ -64,6 +64,7 @@ REFS = \ http/ngx_http_split_clients_module \ http/ngx_http_ssi_module \ http/ngx_http_ssl_module \ + http/ngx_http_status_module \ http/ngx_http_sub_module \ http/ngx_http_upstream_module \ http/ngx_http_userid_module \
new file mode 100644 --- /dev/null +++ b/xml/ru/docs/http/ngx_http_status_module.xml @@ -0,0 +1,485 @@ +<?xml version="1.0"?> + +<!-- + Copyright (C) Nginx, Inc. + --> + +<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> + +<module name="Модуль ngx_http_status_module" + link="/ru/docs/http/ngx_http_status_module.html" + lang="ru" + rev="2"> + +<section id="summary"> + +<para> +Модуль <literal>ngx_http_status_module</literal> предоставляет +доступ к информации о состоянии сервера. +</para> + +<para> +<note> +Модуль доступен как часть +<commercial_version>коммерческой подписки</commercial_version>. +</note> +</para> + +</section> + + +<section id="example" name="Пример конфигурации"> + +<para> +<example> +server { + location = /status { + status; + } + + status_zone example_server; +} +</example> +</para> + +<para> +В составе дистрибутива nginx имеется простая страница мониторинга, доступная +по запросу “<literal>/status.html</literal>” в стандартной конфигурации. +Для работы этой страницы требуется настроить +location “<literal>/status</literal>”, как показано выше. +</para> + +</section> + + +<section id="directives" name="Директивы"> + +<directive name="status"> +<syntax/> +<default/> +<context>location</context> + +<para> +Информация о состоянии будет доступна из содержащего location. +</para> + +</directive> + + +<directive name="status_format"> +<syntax><literal>json</literal></syntax> +<syntax><literal>jsonp</literal> [<value>callback</value>]</syntax> +<default>json</default> +<context>http</context> +<context>server</context> +<context>location</context> + +<para> +По умолчанию информация выводится в формате JSON. +</para> + +<para> +Также данные могут выводиться в формате JSONP. +Параметр <value>callback</value> задаёт имя callback-функции. +Значение может содержать переменные. +Если параметр не задан или вычисленное значение является пустой строкой, +используется имя “<literal>ngx_status_jsonp_callback</literal>”. +</para> + +</directive> + + +<directive name="status_zone"> +<syntax><value>зона</value></syntax> +<default/> +<context>server</context> + +<para> +Включает сбор информации о состоянии виртуального +<link doc="ngx_http_core_module.xml" id="server">сервера</link> +в указанной <value>зоне</value>. +В одной и той же зоне может одновременно собираться информация +сразу по нескольким виртуальным серверам. +</para> + +</directive> + +</section> + + +<section id="data" name="Данные"> + +<para> +Доступна следующая информация: +<list type="tag"> + +<tag-name><literal>version</literal></tag-name> +<tag-desc> +Версия предоставляемого набора данных. +Текущей является версия 2. +</tag-desc> + +<tag-name><literal>nginx_version</literal></tag-name> +<tag-desc> +Версия nginx. +</tag-desc> + +<tag-name><literal>address</literal></tag-name> +<tag-desc> +Адрес сервера, принявшего запрос получения информации о состоянии. +</tag-desc> + +<tag-name><literal>load_timestamp</literal></tag-name> +<tag-desc> +Время последней перезагрузки конфигурации, в миллисекундах с начала эпохи. +</tag-desc> + +<tag-name><literal>timestamp</literal></tag-name> +<tag-desc> +Текущее время в миллисекундах с начала эпохи. +</tag-desc> + +<tag-name><literal>connections</literal></tag-name> +<tag-desc> +<list type="tag"> + +<tag-name><literal>accepted</literal></tag-name> +<tag-desc> +Суммарное число принятых клиентских соединений. +</tag-desc> + +<tag-name><literal>dropped</literal></tag-name> +<tag-desc> +Суммарное число отвергнутых клиентских соединений. +</tag-desc> + +<tag-name><literal>active</literal></tag-name> +<tag-desc> +Текущее число активных клиентских соединений. +</tag-desc> + +<tag-name><literal>idle</literal></tag-name> +<tag-desc> +Текущее число бездействующих клиентских соединений. +</tag-desc> + +</list> +</tag-desc> + +<tag-name><literal>requests</literal></tag-name> +<tag-desc> +<list type="tag"> + +<tag-name><literal>total</literal></tag-name> +<tag-desc> +Суммарное число клиентских запросов. +</tag-desc> + +<tag-name><literal>current</literal></tag-name> +<tag-desc> +Текущее число клиентских запросов. +</tag-desc> + +</list> +</tag-desc> + +<tag-name><literal>server_zones</literal></tag-name> +<tag-desc> +Для каждой <link id="status_zone"/>: +<list type="tag"> + +<tag-name><literal>processing</literal></tag-name> +<tag-desc> +Число обрабатываемых в настоящий момент +клиентских запросов. +</tag-desc> + +<tag-name><literal>requests</literal></tag-name> +<tag-desc> +Суммарное число +запросов, полученных от клиентов. +</tag-desc> + +<tag-name><literal>responses</literal></tag-name> +<tag-desc> +<list type="tag"> + +<tag-name><literal>total</literal></tag-name> +<tag-desc> +Суммарное число +ответов, отправленных клиентам. +</tag-desc> + +<tag-name> +<literal>1xx</literal>, +<literal>2xx</literal>, +<literal>3xx</literal>, +<literal>4xx</literal>, +<literal>5xx</literal> +</tag-name> +<tag-desc> +Число ответов со статусами 1xx, 2xx, 3xx, 4xx и 5xx. +</tag-desc> + +</list> +</tag-desc> + +<tag-name><literal>received</literal></tag-name> +<tag-desc> +Суммарное число байт, полученных от клиентов. +</tag-desc> + +<tag-name><literal>sent</literal></tag-name> +<tag-desc> +Суммарное число байт, отправленных клиентам. +</tag-desc> + +</list> +</tag-desc> + +<tag-name><literal>upstreams</literal></tag-name> +<tag-desc> +Для каждого +<link doc="ngx_http_upstream_module.xml" id="server">сервера</link> +в +<link doc="ngx_http_upstream_module.xml" id="zone">динамически +настраиваемой</link> +<link doc="ngx_http_upstream_module.xml" id="upstream">группе</link> +доступны следующие данные: +<list type="tag"> + +<tag-name><literal>server</literal></tag-name> +<tag-desc> +Адрес +<link doc="ngx_http_upstream_module.xml" id="server">сервера</link>. +</tag-desc> + +<tag-name><literal>backup</literal></tag-name> +<tag-desc> +Логическое значение, означающее, является ли сервер запасным. +</tag-desc> + +<tag-name><literal>weight</literal></tag-name> +<tag-desc> +Вес +<link doc="ngx_http_upstream_module.xml" id="server">сервера</link>. +</tag-desc> + +<tag-name><literal>state</literal></tag-name> +<tag-desc> +Текущее состояние, которое может быть одним из +“<literal>up</literal>”, +“<literal>down</literal>”, +“<literal>unavail</literal>” +или +“<literal>unhealthy</literal>”. +</tag-desc> + +<tag-name><literal>active</literal></tag-name> +<tag-desc> +Текущее число активных соединений. +</tag-desc> + +<tag-name><literal>keepalive</literal></tag-name> +<tag-desc> +Текущее число бездействующих +<link doc="ngx_http_upstream_module.xml" id="keepalive"/>-соединений. +</tag-desc> + +<tag-name><literal>requests</literal></tag-name> +<tag-desc> +Суммарное число +клиентских запросов, перенаправленных на этот сервер. +</tag-desc> + +<tag-name><literal>responses</literal></tag-name> +<tag-desc> +<list type="tag"> + +<tag-name><literal>total</literal></tag-name> +<tag-desc> +Суммарное число +ответов, полученных от этого сервера. +</tag-desc> + +<tag-name> +<literal>1xx</literal>, +<literal>2xx</literal>, +<literal>3xx</literal>, +<literal>4xx</literal>, +<literal>5xx</literal> +</tag-name> +<tag-desc> +Число ответов со статусами 1xx, 2xx, 3xx, 4xx и 5xx. +</tag-desc> + +</list> +</tag-desc> + +<tag-name><literal>sent</literal></tag-name> +<tag-desc> +Суммарное число байт, отправленных на этот сервер. +</tag-desc> + +<tag-name><literal>received</literal></tag-name> +<tag-desc> +Суммарное число байт, полученных с этого сервера. +</tag-desc> + +<tag-name><literal>fails</literal></tag-name> +<tag-desc> +Суммарное число +неудачных попыток работы с этим сервером. +</tag-desc> + +<tag-name><literal>unavail</literal></tag-name> +<tag-desc> +Количество раз, когда +сервер становился недоступным для клиентских запросов +(состояние “<literal>unavail</literal>”) +из-за достижения порогового числа неудачных +попыток <literal>max_fails</literal>. +</tag-desc> + +<tag-name><literal>health_checks</literal></tag-name> +<tag-desc> +<list type="tag"> + +<tag-name><literal>checks</literal></tag-name> +<tag-desc> +Суммарное число запросов +<link doc="ngx_http_upstream_module.xml" id="health_check">проверки +работоспособности</link>. +</tag-desc> + +<tag-name><literal>fails</literal></tag-name> +<tag-desc> +Число неудачных проверок работоспособности. +</tag-desc> + +<tag-name><literal>unhealthy</literal></tag-name> +<tag-desc> +Количество раз, когда +сервер становился неработоспособным (состояние “<literal>unhealthy</literal>”). +</tag-desc> + +<tag-name><literal>last_passed</literal></tag-name> +<tag-desc> +Логическое значение, означающее, была ли последняя проверка +работоспособности удачной и удовлетворял ли ответ заданным +<link doc="ngx_http_upstream_module.xml" id="match">тестам</link>. +</tag-desc> + +</list> +</tag-desc> + +<tag-name><literal>downtime</literal></tag-name> +<tag-desc> +Суммарное время, +когда сервер находился в состояниях “<literal>unavail</literal>” +и “<literal>unhealthy</literal>”. +</tag-desc> + +<tag-name><literal>downstart</literal></tag-name> +<tag-desc> +Время (в миллисекундах с начала эпохи), +когда сервер стал +“<literal>unavail</literal>” +или “<literal>unhealthy</literal>”. +</tag-desc> + +</list> +</tag-desc> + +<tag-name><literal>caches</literal></tag-name> +<tag-desc> +Для каждого кэша, сконфигурированного при помощи +<link doc="ngx_http_proxy_module.xml" id="proxy_cache_path"/> +и аналогичных директив: +<list type="tag"> + +<tag-name><literal>size</literal></tag-name> +<tag-desc> +Текущий размер кэша. +</tag-desc> + +<tag-name><literal>max_size</literal></tag-name> +<tag-desc> +Ограничение на максимальный размер кэша, заданное в конфигурации. +</tag-desc> + +<tag-name><literal>cold</literal></tag-name> +<tag-desc> +Логическое значение, указывающее, продолжается ли загрузка +данных процессом “cache loader” с диска в кэш. +</tag-desc> + +<tag-name> + <literal>hits</literal>, + <literal>stale</literal>, + <literal>updating</literal>, + <literal>revalidated</literal> +</tag-name> +<tag-desc> +<list type="tag"> + +<tag-name><literal>responses</literal></tag-name> +<tag-desc> +Суммарное число ответов, прочитанных из кэша (попадания в кэш +или просроченные ответы вследствие +<link doc="ngx_http_proxy_module.xml" id="proxy_cache_use_stale"/> +и аналогичных директив). +</tag-desc> + +<tag-name><literal>bytes</literal></tag-name> +<tag-desc> +Суммарное число байт, прочитанных из кэша. +</tag-desc> + +</list> +</tag-desc> + +<tag-name> + <literal>miss</literal>, + <literal>expired</literal>, + <literal>bypass</literal> +</tag-name> +<tag-desc> +<list type="tag"> + +<tag-name><literal>responses</literal></tag-name> +<tag-desc> +Суммарное число ответов, взятых не из кэша (<literal>miss</literal> — +отсутствие данных в кэше, <literal>expired</literal> — просроченные ответы, +<literal>bypass</literal> — ответ не был взят из кэша +вследствие <link doc="ngx_http_proxy_module.xml" id="proxy_cache_bypass"/> +и аналогичных директив). +</tag-desc> + +<tag-name><literal>bytes</literal></tag-name> +<tag-desc> +Суммарное число байт, прочитанных с проксируемого сервера. +</tag-desc> + +<tag-name><literal>responses_written</literal></tag-name> +<tag-desc> +Суммарное число ответов, записанных в кэш. +</tag-desc> + +<tag-name><literal>bytes_written</literal></tag-name> +<tag-desc> +Суммарное число байт, записанных в кэш. +</tag-desc> + +</list> +</tag-desc> + +</list> +</tag-desc> + +</list> +</para> + +</section> + +</module>
--- a/xml/ru/docs/index.xml +++ b/xml/ru/docs/index.xml @@ -342,6 +342,11 @@ ngx_http_ssl_module</link> </listitem> <listitem> +<link doc="http/ngx_http_status_module.xml"> +ngx_http_status_module</link> +</listitem> + +<listitem> <link doc="http/ngx_http_sub_module.xml"> ngx_http_sub_module</link> </listitem>