CoCalc -- ngx_http_status

GitHub Repository: nginx/nginx.org
Path: blob/main/xml/ru/docs/http/ngx_http_status_module.xml
¹ views
1
<?xml version="1.0"?>
2

3
<!--
4
  Copyright (C) Nginx, Inc.
5
  -->
6

7
<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
8

9
<module name="Модуль ngx_http_status_module"
10
        link="/ru/docs/http/ngx_http_status_module.html"
11
        lang="ru"
12
        rev="19">
13

14
<section id="summary">
15

16
<para>
17
Модуль <literal>ngx_http_status_module</literal> предоставляет
18
доступ к информации о состоянии сервера.
19
<note>
20
Этот модуль был доступен как часть
21
<commercial_version>коммерческой подписки</commercial_version>
22
до версии 1.13.10.
23
Модуль был заменён модулем
24
<link doc="ngx_http_api_module.xml">ngx_http_api_module</link>
25
в версии 1.13.3.
26
</note>
27
</para>
28

29
</section>
30

31

32
<section id="example" name="Пример конфигурации">
33

34
<para>
35
<example>
36
http {
37
    upstream <emphasis>backend</emphasis> {
38
        <emphasis>zone</emphasis> http_backend 64k;
39

40
        server backend1.example.com weight=5;
41
        server backend2.example.com;
42
    }
43

44
    proxy_cache_path /data/nginx/cache_backend keys_zone=<emphasis>cache_backend</emphasis>:10m;
45

46
    server {
47
        server_name backend.example.com;
48

49
        location / {
50
            proxy_pass  http://backend;
51
            proxy_cache cache_backend;
52

53
            health_check;
54
        }
55

56
        <emphasis>status_zone server_backend;</emphasis>
57
    }
58

59
    server {
60
        listen 127.0.0.1;
61

62
        location /upstream_conf {
63
            upstream_conf;
64
        }
65

66
        location /status {
67
            status;
68
        }
69

70
        location = /status.html {
71
        }
72
    }
73
}
74

75
stream {
76
    upstream <emphasis>backend</emphasis> {
77
        <emphasis>zone</emphasis> stream_backend 64k;
78

79
        server backend1.example.com:12345 weight=5;
80
        server backend2.example.com:12345;
81
    }
82

83
    server {
84
        listen      127.0.0.1:12345;
85
        proxy_pass  backend;
86
        <emphasis>status_zone server_backend;</emphasis>
87
        health_check;
88
    }
89
}
90
</example>
91
</para>
92

93
<para>
94
Примеры запросов информации о состоянии,
95
возможные с данной конфигурацией:
96
<example>
97
http://127.0.0.1/status
98
http://127.0.0.1/status/nginx_version
99
http://127.0.0.1/status/caches/cache_backend
100
http://127.0.0.1/status/upstreams
101
http://127.0.0.1/status/upstreams/backend
102
http://127.0.0.1/status/upstreams/backend/peers/1
103
http://127.0.0.1/status/upstreams/backend/peers/1/weight
104
http://127.0.0.1/status/stream
105
http://127.0.0.1/status/stream/upstreams
106
http://127.0.0.1/status/stream/upstreams/backend
107
http://127.0.0.1/status/stream/upstreams/backend/peers/1
108
http://127.0.0.1/status/stream/upstreams/backend/peers/1/weight
109
</example>
110
</para>
111

112
<para>
113
В составе дистрибутива nginx имеется простая страница мониторинга, доступная
114
по запросу “<literal>/status.html</literal>” в стандартной конфигурации.
115
Для работы этой страницы требуется настроить location
116
“<literal>/status</literal>” и location “<literal>/status.html</literal>”
117
как показано выше.
118
</para>
119

120
</section>
121

122

123
<section id="directives" name="Директивы">
124

125
<directive name="status">
126
<syntax/>
127
<default/>
128
<context>location</context>
129

130
<para>
131
Информация о состоянии будет доступна из содержащего location.
132
Доступ в location следует
133
<link doc="ngx_http_core_module.xml" id="satisfy">ограничить</link>.
134
</para>
135

136
</directive>
137

138

139
<directive name="status_format">
140
<syntax><literal>json</literal></syntax>
141
<syntax><literal>jsonp</literal> [<value>callback</value>]</syntax>
142
<default>json</default>
143
<context>http</context>
144
<context>server</context>
145
<context>location</context>
146

147
<para>
148
По умолчанию информация выводится в формате JSON.
149
</para>
150

151
<para>
152
Также данные могут выводиться в формате JSONP.
153
Параметр <value>callback</value> задаёт имя callback-функции.
154
В значении параметра можно использовать переменные.
155
Если параметр не задан или вычисленное значение является пустой строкой,
156
используется имя “<literal>ngx_status_jsonp_callback</literal>”.
157
</para>
158

159
</directive>
160

161

162
<directive name="status_zone">
163
<syntax><value>зона</value></syntax>
164
<default/>
165
<context>server</context>
166

167
<para>
168
Включает сбор информации о состоянии виртуального сервера группы
169
<link doc="ngx_http_core_module.xml" id="server">http</link>
170
или
171
<link doc="../stream/ngx_stream_core_module.xml" id="server">stream</link>
172
(1.7.11) в указанной <value>зоне</value>.
173
В одной и той же зоне может одновременно собираться информация
174
сразу по нескольким серверам.
175
</para>
176

177
</directive>
178

179
</section>
180

181

182
<section id="data" name="Данные">
183

184
<para>
185
Доступна следующая информация:
186
<list type="tag">
187

188
<tag-name id="version"><literal>version</literal></tag-name>
189
<tag-desc>
190
Версия предоставляемого набора данных.
191
Текущей является версия 8.
192
</tag-desc>
193

194
<tag-name><literal>nginx_version</literal></tag-name>
195
<tag-desc>
196
Версия nginx.
197
</tag-desc>
198

199
<tag-name id="nginx_build"><literal>nginx_build</literal></tag-name>
200
<tag-desc>
201
Название сборки nginx.
202
</tag-desc>
203

204
<tag-name><literal>address</literal></tag-name>
205
<tag-desc>
206
Адрес сервера, принявшего запрос на получение информации о состоянии.
207
</tag-desc>
208

209
<tag-name id="generation"><literal>generation</literal></tag-name>
210
<tag-desc>
211
Суммарное число
212
<link doc="../control.xml" id="reconfiguration">перезагрузок</link>
213
конфигурации.
214
</tag-desc>
215

216
<tag-name id="load_timestamp"><literal>load_timestamp</literal></tag-name>
217
<tag-desc>
218
Время последней перезагрузки конфигурации, в миллисекундах с начала эпохи.
219
</tag-desc>
220

221
<tag-name><literal>timestamp</literal></tag-name>
222
<tag-desc>
223
Текущее время в миллисекундах с начала эпохи.
224
</tag-desc>
225

226
<tag-name id="pid"><literal>pid</literal></tag-name>
227
<tag-desc>
228
Идентификатор рабочего процесса,
229
обработавшего запрос на получение информации о состоянии.
230
</tag-desc>
231

232
<tag-name id="ppid"><literal>ppid</literal></tag-name>
233
<tag-desc>
234
Идентификатор главного процесса,
235
запустившего <link id="pid">рабочий процесс</link>.
236
</tag-desc>
237

238
<tag-name id="processes"><literal>processes</literal></tag-name>
239
<tag-desc>
240
<list type="tag">
241

242
<tag-name id="respawned"><literal>respawned</literal></tag-name>
243
<tag-desc>
244
Суммарное число перезапусков аварийно завершённых
245
дочерних процессов.
246
</tag-desc>
247

248
</list>
249
</tag-desc>
250

251
<tag-name><literal>connections</literal></tag-name>
252
<tag-desc>
253
<list type="tag">
254

255
<tag-name><literal>accepted</literal></tag-name>
256
<tag-desc>
257
Суммарное число принятых клиентских соединений.
258
</tag-desc>
259

260
<tag-name><literal>dropped</literal></tag-name>
261
<tag-desc>
262
Суммарное число отвергнутых клиентских соединений.
263
</tag-desc>
264

265
<tag-name><literal>active</literal></tag-name>
266
<tag-desc>
267
Текущее число активных клиентских соединений.
268
</tag-desc>
269

270
<tag-name><literal>idle</literal></tag-name>
271
<tag-desc>
272
Текущее число бездействующих клиентских соединений.
273
</tag-desc>
274

275
</list>
276
</tag-desc>
277

278
<tag-name id="ssl"><literal>ssl</literal></tag-name>
279
<tag-desc>
280
<list type="tag">
281

282
<tag-name><literal>handshakes</literal></tag-name>
283
<tag-desc>
284
Суммарное число успешных операций SSL handshake.
285
</tag-desc>
286

287
<tag-name><literal>handshakes_failed</literal></tag-name>
288
<tag-desc>
289
Суммарное число неуспешных операций SSL handshake.
290
</tag-desc>
291

292
<tag-name><literal>session_reuses</literal></tag-name>
293
<tag-desc>
294
Суммарное число повторных использований SSL-сессий
295
во время операций SSL handshake.
296
</tag-desc>
297

298
</list>
299
</tag-desc>
300

301
<tag-name><literal>requests</literal></tag-name>
302
<tag-desc>
303
<list type="tag">
304

305
<tag-name><literal>total</literal></tag-name>
306
<tag-desc>
307
Суммарное число клиентских запросов.
308
</tag-desc>
309

310
<tag-name><literal>current</literal></tag-name>
311
<tag-desc>
312
Текущее число клиентских запросов.
313
</tag-desc>
314

315
</list>
316
</tag-desc>
317

318
<tag-name id="server_zones"><literal>server_zones</literal></tag-name>
319
<tag-desc>
320
Для каждой <link id="status_zone"/>:
321
<list type="tag">
322

323
<tag-name><literal>processing</literal></tag-name>
324
<tag-desc>
325
Число обрабатываемых в настоящий момент
326
клиентских запросов.
327
</tag-desc>
328

329
<tag-name><literal>requests</literal></tag-name>
330
<tag-desc>
331
Суммарное число
332
запросов, полученных от клиентов.
333
</tag-desc>
334

335
<tag-name><literal>responses</literal></tag-name>
336
<tag-desc>
337
<list type="tag">
338

339
<tag-name><literal>total</literal></tag-name>
340
<tag-desc>
341
Суммарное число
342
ответов, отправленных клиентам.
343
</tag-desc>
344

345
<tag-name>
346
<literal>1xx</literal>,
347
<literal>2xx</literal>,
348
<literal>3xx</literal>,
349
<literal>4xx</literal>,
350
<literal>5xx</literal>
351
</tag-name>
352
<tag-desc>
353
Число ответов со статусами 1xx, 2xx, 3xx, 4xx и 5xx.
354
</tag-desc>
355

356
</list>
357
</tag-desc>
358

359
<tag-name id="discarded"><literal>discarded</literal></tag-name>
360
<tag-desc>
361
Суммарное число запросов, завершившихся без отправки ответа.
362
</tag-desc>
363

364
<tag-name><literal>received</literal></tag-name>
365
<tag-desc>
366
Суммарное число байт, полученных от клиентов.
367
</tag-desc>
368

369
<tag-name><literal>sent</literal></tag-name>
370
<tag-desc>
371
Суммарное число байт, отправленных клиентам.
372
</tag-desc>
373

374
</list>
375
</tag-desc>
376

377
<tag-name id="slabs"><literal>slabs</literal></tag-name>
378
<tag-desc>
379
Для каждой зоны разделяемой памяти, в которой используется распределение slab:
380
<list type="tag">
381

382
<tag-name><literal>pages</literal></tag-name>
383
<tag-desc>
384
<list type="tag">
385

386
<tag-name><literal>used</literal></tag-name>
387
<tag-desc>
388
Текущее число занятых страниц памяти.
389
</tag-desc>
390

391
<tag-name><literal>free</literal></tag-name>
392
<tag-desc>
393
Текущее число свободных страниц памяти.
394
</tag-desc>
395

396
</list>
397
</tag-desc>
398

399
<tag-name><literal>slots</literal></tag-name>
400
<tag-desc>
401
Для каждого размера слота памяти (8, 16, 32, 64, 128 и т.д.)
402
доступны следующие данные:
403
<list type="tag">
404

405
<tag-name><literal>used</literal></tag-name>
406
<tag-desc>
407
Текущее число занятых слотов памяти.
408
</tag-desc>
409

410
<tag-name><literal>free</literal></tag-name>
411
<tag-desc>
412
Текущее число свободных слотов памяти.
413
</tag-desc>
414

415
<tag-name><literal>reqs</literal></tag-name>
416
<tag-desc>
417
Суммарное число попыток выделения памяти указанного размера.
418
</tag-desc>
419

420
<tag-name><literal>fails</literal></tag-name>
421
<tag-desc>
422
Число неудачных попыток выделения памяти указанного размера.
423
</tag-desc>
424

425
</list>
426
</tag-desc>
427

428
</list>
429
</tag-desc>
430

431
<tag-name id="upstreams"><literal>upstreams</literal></tag-name>
432
<tag-desc>
433
Для каждой
434
<link doc="ngx_http_upstream_module.xml" id="zone">динамически
435
настраиваемой</link>
436
<link doc="ngx_http_upstream_module.xml" id="upstream">группы</link>
437
доступны следующие данные:
438
<list type="tag">
439

440
<tag-name id="peers"><literal>peers</literal></tag-name>
441
<tag-desc>
442
Для каждого
443
<link doc="ngx_http_upstream_module.xml" id="server">сервера</link>
444
доступны следующие данные:
445
<list type="tag">
446

447
<tag-name id="id"><literal>id</literal></tag-name>
448
<tag-desc>
449
Идентификатор сервера.
450
</tag-desc>
451

452
<tag-name><literal>server</literal></tag-name>
453
<tag-desc>
454
<link doc="ngx_http_upstream_module.xml" id="server">Адрес</link>
455
сервера.
456
</tag-desc>
457

458
<tag-name id="name"><literal>name</literal></tag-name>
459
<tag-desc>
460
Имя сервера, указанное в директиве
461
<link doc="ngx_http_upstream_module.xml" id="server"/>.
462
</tag-desc>
463

464
<tag-name id="service"><literal>service</literal></tag-name>
465
<tag-desc>
466
Значение параметра
467
<link doc="ngx_http_upstream_module.xml" id="service"/>
468
директивы <link doc="ngx_http_upstream_module.xml" id="server"/>.
469
</tag-desc>
470

471
<tag-name><literal>backup</literal></tag-name>
472
<tag-desc>
473
Логическое значение, означающее, является ли сервер
474
<link doc="ngx_http_upstream_module.xml" id="backup">запасным</link>.
475
</tag-desc>
476

477
<tag-name><literal>weight</literal></tag-name>
478
<tag-desc>
479
<link doc="ngx_http_upstream_module.xml" id="weight">Вес</link>
480
сервера.
481
</tag-desc>
482

483
<tag-name id="state"><literal>state</literal></tag-name>
484
<tag-desc>
485
Текущее состояние, которое может быть одним из
486
“<literal>up</literal>”,
487
“<literal>draining</literal>”,
488
“<literal>down</literal>”,
489
“<literal>unavail</literal>”,
490
“<literal>checking</literal>”
491
или
492
“<literal>unhealthy</literal>”.
493
</tag-desc>
494

495
<tag-name><literal>active</literal></tag-name>
496
<tag-desc>
497
Текущее число активных соединений.
498
</tag-desc>
499

500
<tag-name id="max_conns"><literal>max_conns</literal></tag-name>
501
<tag-desc>
502
Ограничение <link doc="ngx_http_upstream_module.xml" id="max_conns"/>
503
для сервера.
504
</tag-desc>
505

506
<tag-name><literal>requests</literal></tag-name>
507
<tag-desc>
508
Суммарное число
509
клиентских запросов, перенаправленных на этот сервер.
510
</tag-desc>
511

512
<tag-name><literal>responses</literal></tag-name>
513
<tag-desc>
514
<list type="tag">
515

516
<tag-name><literal>total</literal></tag-name>
517
<tag-desc>
518
Суммарное число
519
ответов, полученных от этого сервера.
520
</tag-desc>
521

522
<tag-name>
523
<literal>1xx</literal>,
524
<literal>2xx</literal>,
525
<literal>3xx</literal>,
526
<literal>4xx</literal>,
527
<literal>5xx</literal>
528
</tag-name>
529
<tag-desc>
530
Число ответов со статусами 1xx, 2xx, 3xx, 4xx и 5xx.
531
</tag-desc>
532

533
</list>
534
</tag-desc>
535

536
<tag-name><literal>sent</literal></tag-name>
537
<tag-desc>
538
Суммарное число байт, отправленных на этот сервер.
539
</tag-desc>
540

541
<tag-name><literal>received</literal></tag-name>
542
<tag-desc>
543
Суммарное число байт, полученных с этого сервера.
544
</tag-desc>
545

546
<tag-name><literal>fails</literal></tag-name>
547
<tag-desc>
548
Суммарное число
549
неудачных попыток работы с этим сервером.
550
</tag-desc>
551

552
<tag-name><literal>unavail</literal></tag-name>
553
<tag-desc>
554
Количество раз, когда
555
сервер становился недоступным для клиентских запросов
556
(состояние “<literal>unavail</literal>”)
557
из-за достижения порогового числа неудачных попыток
558
<link doc="ngx_http_upstream_module.xml" id="max_fails"/>.
559
</tag-desc>
560

561
<tag-name><literal>health_checks</literal></tag-name>
562
<tag-desc>
563
<list type="tag">
564

565
<tag-name><literal>checks</literal></tag-name>
566
<tag-desc>
567
Суммарное число запросов
568
<link doc="ngx_http_upstream_hc_module.xml" id="health_check">проверки
569
работоспособности</link>.
570
</tag-desc>
571

572
<tag-name><literal>fails</literal></tag-name>
573
<tag-desc>
574
Число неудачных проверок работоспособности.
575
</tag-desc>
576

577
<tag-name><literal>unhealthy</literal></tag-name>
578
<tag-desc>
579
Количество раз, когда
580
сервер становился неработоспособным (состояние “<literal>unhealthy</literal>”).
581
</tag-desc>
582

583
<tag-name><literal>last_passed</literal></tag-name>
584
<tag-desc>
585
Логическое значение, означающее, была ли последняя проверка
586
работоспособности удачной и удовлетворял ли ответ заданным
587
<link doc="ngx_http_upstream_hc_module.xml" id="match">тестам</link>.
588
</tag-desc>
589

590
</list>
591
</tag-desc>
592

593
<tag-name><literal>downtime</literal></tag-name>
594
<tag-desc>
595
Суммарное время,
596
когда сервер находился в состояниях “<literal>unavail</literal>”,
597
“<literal>checking</literal>” и “<literal>unhealthy</literal>”.
598
</tag-desc>
599

600
<tag-name><literal>downstart</literal></tag-name>
601
<tag-desc>
602
Время (в миллисекундах с начала эпохи),
603
когда сервер стал
604
“<literal>unavail</literal>”,
605
“<literal>checking</literal>” или “<literal>unhealthy</literal>”.
606
</tag-desc>
607

608
<tag-name id="selected"><literal>selected</literal></tag-name>
609
<tag-desc>
610
Время (в миллисекундах с начала эпохи),
611
когда сервер в последний раз был выбран для обработки запроса (1.7.5).
612
</tag-desc>
613

614
<tag-name id="header_time"><literal>header_time</literal></tag-name>
615
<tag-desc>
616
Среднее время получения
617
<link doc="ngx_http_upstream_module.xml" id="var_upstream_header_time">заголовка
618
ответа</link> от сервера (1.7.10).
619
До версии 1.11.6
620
поле было доступно только при использовании метода балансировки
621
<link doc="ngx_http_upstream_module.xml" id="least_time"/>.
622
</tag-desc>
623

624
<tag-name id="response_time"><literal>response_time</literal></tag-name>
625
<tag-desc>
626
Среднее время получения
627
<link doc="ngx_http_upstream_module.xml" id="var_upstream_response_time">всего
628
ответа</link> от сервера (1.7.10).
629
До версии 1.11.6
630
поле было доступно только при использовании метода балансировки
631
<link doc="ngx_http_upstream_module.xml" id="least_time"/>.
632
</tag-desc>
633

634
</list>
635
</tag-desc>
636

637
<tag-name><literal>keepalive</literal></tag-name>
638
<tag-desc>
639
Текущее число бездействующих
640
<link doc="ngx_http_upstream_module.xml" id="keepalive"/>-соединений.
641
</tag-desc>
642

643
<tag-name id="zombies"><literal>zombies</literal></tag-name>
644
<tag-desc>
645
Текущее число серверов, удалённых
646
из группы, но всё ещё обрабатывающих активные клиентские запросы.
647
</tag-desc>
648

649
<tag-name id="zone"><literal>zone</literal></tag-name>
650
<tag-desc>
651
Имя <link doc="ngx_http_upstream_module.xml" id="zone">зоны</link>
652
разделяемой памяти,
653
в которой хранятся конфигурация группы и её рабочее состояние.
654
</tag-desc>
655

656
<tag-name id="queue"><literal>queue</literal></tag-name>
657
<tag-desc>
658
Для <link doc="ngx_http_upstream_module.xml" id="queue">очереди</link> запросов
659
доступны следующие данные:
660
<list type="tag">
661

662
<tag-name><literal>size</literal></tag-name>
663
<tag-desc>
664
Текущее число запросов в очереди.
665
</tag-desc>
666

667
<tag-name><literal>max_size</literal></tag-name>
668
<tag-desc>
669
Максимальное число запросов, которые могут одновременно находиться в очереди.
670
</tag-desc>
671

672
<tag-name><literal>overflows</literal></tag-name>
673
<tag-desc>
674
Суммарное число запросов, отклонённых из-за переполнения очереди.
675
</tag-desc>
676

677
</list>
678
</tag-desc>
679

680
</list>
681
</tag-desc>
682

683
<tag-name id="caches"><literal>caches</literal></tag-name>
684
<tag-desc>
685
Для каждого кэша, сконфигурированного при помощи
686
<link doc="ngx_http_proxy_module.xml" id="proxy_cache_path"/>
687
и аналогичных директив:
688
<list type="tag">
689

690
<tag-name><literal>size</literal></tag-name>
691
<tag-desc>
692
Текущий размер кэша.
693
</tag-desc>
694

695
<tag-name><literal>max_size</literal></tag-name>
696
<tag-desc>
697
Ограничение на максимальный размер кэша, заданное в конфигурации.
698
</tag-desc>
699

700
<tag-name><literal>cold</literal></tag-name>
701
<tag-desc>
702
Логическое значение, указывающее, продолжается ли загрузка
703
данных процессом “cache loader” с диска в кэш.
704
</tag-desc>
705

706
<tag-name>
707
    <literal>hit</literal>,
708
    <literal>stale</literal>,
709
    <literal>updating</literal>,
710
    <literal>revalidated</literal>
711
</tag-name>
712
<tag-desc>
713
<list type="tag">
714

715
<tag-name><literal>responses</literal></tag-name>
716
<tag-desc>
717
Суммарное число ответов, прочитанных из кэша (попадания в кэш
718
или просроченные ответы вследствие
719
<link doc="ngx_http_proxy_module.xml" id="proxy_cache_use_stale"/>
720
и аналогичных директив).
721
</tag-desc>
722

723
<tag-name><literal>bytes</literal></tag-name>
724
<tag-desc>
725
Суммарное число байт, прочитанных из кэша.
726
</tag-desc>
727

728
</list>
729
</tag-desc>
730

731
<tag-name>
732
    <literal>miss</literal>,
733
    <literal>expired</literal>,
734
    <literal>bypass</literal>
735
</tag-name>
736
<tag-desc>
737
<list type="tag">
738

739
<tag-name><literal>responses</literal></tag-name>
740
<tag-desc>
741
Суммарное число ответов, взятых не из кэша (<literal>miss</literal> —
742
отсутствие данных в кэше, <literal>expired</literal> — просроченные ответы,
743
<literal>bypass</literal> — ответ не был взят из кэша
744
вследствие <link doc="ngx_http_proxy_module.xml" id="proxy_cache_bypass"/>
745
и аналогичных директив).
746
</tag-desc>
747

748
<tag-name><literal>bytes</literal></tag-name>
749
<tag-desc>
750
Суммарное число байт, прочитанных с проксируемого сервера.
751
</tag-desc>
752

753
<tag-name><literal>responses_written</literal></tag-name>
754
<tag-desc>
755
Суммарное число ответов, записанных в кэш.
756
</tag-desc>
757

758
<tag-name><literal>bytes_written</literal></tag-name>
759
<tag-desc>
760
Суммарное число байт, записанных в кэш.
761
</tag-desc>
762

763
</list>
764
</tag-desc>
765

766
</list>
767
</tag-desc>
768

769
<tag-name id="stream"><literal>stream</literal></tag-name>
770
<tag-desc>
771

772
<list type="tag">
773
<tag-name id="stream_server_zones"><literal>server_zones</literal></tag-name>
774
<tag-desc>
775
Для каждой <link id="status_zone"/>:
776
<list type="tag">
777

778
<tag-name><literal>processing</literal></tag-name>
779
<tag-desc>
780
Число обрабатываемых в настоящий момент
781
клиентских соединений.
782
</tag-desc>
783

784
<tag-name><literal>connections</literal></tag-name>
785
<tag-desc>
786
Суммарное число
787
соединений, полученных от клиентов.
788
</tag-desc>
789

790
<tag-name id="sessions"><literal>sessions</literal></tag-name>
791
<tag-desc>
792
<list type="tag">
793

794
<tag-name><literal>total</literal></tag-name>
795
<tag-desc>
796
Суммарное число завершённых клиентских сессий.
797
</tag-desc>
798

799
<tag-name>
800
<literal>2xx</literal>,
801
<literal>4xx</literal>,
802
<literal>5xx</literal>
803
</tag-name>
804
<tag-desc>
805
Число завершённых сессий со
806
<link doc="../stream/ngx_stream_core_module.xml" id="var_status">статусами</link>
807
2xx, 4xx или 5xx.
808
</tag-desc>
809

810
</list>
811
</tag-desc>
812

813
<tag-name id="stream_discarded"><literal>discarded</literal></tag-name>
814
<tag-desc>
815
Суммарное число соединений, завершённых без создания сессии.
816
</tag-desc>
817

818
<tag-name><literal>received</literal></tag-name>
819
<tag-desc>
820
Суммарное число байт, полученных от клиентов.
821
</tag-desc>
822

823
<tag-name><literal>sent</literal></tag-name>
824
<tag-desc>
825
Суммарное число байт, отправленных клиентам.
826
</tag-desc>
827

828
</list>
829
</tag-desc>
830

831
<tag-name id="stream_upstreams"><literal>upstreams</literal></tag-name>
832
<tag-desc>
833
Для каждого
834
<link doc="../stream/ngx_stream_upstream_module.xml" id="server">сервера</link>
835
в
836
<link doc="../stream/ngx_stream_upstream_module.xml" id="zone">динамически
837
настраиваемой</link>
838
<link doc="../stream/ngx_stream_upstream_module.xml" id="upstream">группе</link>
839
доступны следующие данные:
840
<list type="tag">
841

842
<tag-name><literal>id</literal></tag-name>
843
<tag-desc>
844
Идентификатор сервера.
845
</tag-desc>
846

847
<tag-name><literal>server</literal></tag-name>
848
<tag-desc>
849
<link doc="../stream/ngx_stream_upstream_module.xml" id="server">Адрес</link>
850
сервера.
851
</tag-desc>
852

853
<tag-name id="stream_name"><literal>name</literal></tag-name>
854
<tag-desc>
855
Имя сервера, указанное в директиве
856
<link doc="../stream/ngx_stream_upstream_module.xml" id="server"/>.
857
</tag-desc>
858

859
<tag-name id="stream_service"><literal>service</literal></tag-name>
860
<tag-desc>
861
Значение параметра
862
<link doc="ngx_http_upstream_module.xml" id="service"/>
863
директивы <link doc="ngx_http_upstream_module.xml" id="server"/>.
864
</tag-desc>
865

866
<tag-name><literal>backup</literal></tag-name>
867
<tag-desc>
868
Логическое значение, означающее, является ли сервер
869
<link doc="../stream/ngx_stream_upstream_module.xml" id="backup">запасным</link>.
870
</tag-desc>
871

872
<tag-name><literal>weight</literal></tag-name>
873
<tag-desc>
874
<link doc="../stream/ngx_stream_upstream_module.xml" id="weight">Вес</link>
875
сервера.
876
</tag-desc>
877

878
<tag-name><literal>state</literal></tag-name>
879
<tag-desc>
880
Текущее состояние, которое может быть одним из
881
“<literal>up</literal>”,
882
“<literal>down</literal>”,
883
“<literal>unavail</literal>”,
884
“<literal>checking</literal>”
885
или
886
“<literal>unhealthy</literal>”.
887
</tag-desc>
888

889
<tag-name><literal>active</literal></tag-name>
890
<tag-desc>
891
Текущее число соединений.
892
</tag-desc>
893

894
<tag-name><literal>max_conns</literal></tag-name>
895
<tag-desc>
896
Ограничение
897
<link doc="../stream/ngx_stream_upstream_module.xml" id="max_conns"/>
898
для сервера.
899
</tag-desc>
900

901
<tag-name><literal>connections</literal></tag-name>
902
<tag-desc>
903
Суммарное число
904
клиентских соединений, перенаправленных на этот сервер.
905
</tag-desc>
906

907
<tag-name><literal>connect_time</literal></tag-name>
908
<tag-desc>
909
Среднее время установки соединения с сервером группы.
910
До версии 1.11.6
911
поле было доступно только при использовании метода балансировки
912
<link doc="../stream/ngx_stream_upstream_module.xml" id="least_time"/>.
913
</tag-desc>
914

915
<tag-name><literal>first_byte_time</literal></tag-name>
916
<tag-desc>
917
Среднее время получения первого байта данных.
918
До версии 1.11.6
919
поле было доступно только при использовании метода балансировки
920
<link doc="../stream/ngx_stream_upstream_module.xml" id="least_time"/>.
921
</tag-desc>
922

923
<tag-name><literal>response_time</literal></tag-name>
924
<tag-desc>
925
Среднее время получения последнего байта данных.
926
До версии 1.11.6
927
поле было доступно только при использовании метода балансировки
928
<link doc="../stream/ngx_stream_upstream_module.xml" id="least_time"/>.
929
</tag-desc>
930

931
<tag-name><literal>sent</literal></tag-name>
932
<tag-desc>
933
Суммарное число байт, отправленных на этот сервер.
934
</tag-desc>
935

936
<tag-name><literal>received</literal></tag-name>
937
<tag-desc>
938
Суммарное число байт, полученных с этого сервера.
939
</tag-desc>
940

941
<tag-name><literal>fails</literal></tag-name>
942
<tag-desc>
943
Суммарное число
944
неудачных попыток работы с этим сервером.
945
</tag-desc>
946

947
<tag-name><literal>unavail</literal></tag-name>
948
<tag-desc>
949
Количество раз, когда
950
сервер становился недоступным для клиентских соединений
951
(состояние “<literal>unavail</literal>”)
952
из-за достижения порогового числа неудачных попыток
953
<link doc="../stream/ngx_stream_upstream_module.xml" id="max_fails"/>.
954
</tag-desc>
955

956
<tag-name><literal>health_checks</literal></tag-name>
957
<tag-desc>
958
<list type="tag">
959

960
<tag-name><literal>checks</literal></tag-name>
961
<tag-desc>
962
Суммарное число запросов
963
<link doc="../stream/ngx_stream_upstream_hc_module.xml" id="health_check">проверки
964
работоспособности</link>.
965
</tag-desc>
966

967
<tag-name><literal>fails</literal></tag-name>
968
<tag-desc>
969
Число неудачных проверок работоспособности.
970
</tag-desc>
971

972
<tag-name><literal>unhealthy</literal></tag-name>
973
<tag-desc>
974
Количество раз, когда
975
сервер становился неработоспособным (состояние “<literal>unhealthy</literal>”).
976
</tag-desc>
977

978
<tag-name><literal>last_passed</literal></tag-name>
979
<tag-desc>
980
Логическое значение, означающее, была ли последняя проверка
981
работоспособности удачной и удовлетворял ли ответ заданным
982
<link doc="../stream/ngx_stream_upstream_hc_module.xml" id="match">тестам</link>.
983
</tag-desc>
984

985
</list>
986
</tag-desc>
987

988
<tag-name><literal>downtime</literal></tag-name>
989
<tag-desc>
990
Суммарное время,
991
когда сервер находился в состояниях “<literal>unavail</literal>”,
992
“<literal>checking</literal>” и “<literal>unhealthy</literal>”.
993
</tag-desc>
994

995
<tag-name><literal>downstart</literal></tag-name>
996
<tag-desc>
997
Время (в миллисекундах с начала эпохи),
998
когда сервер стал
999
“<literal>unavail</literal>”,
1000
“<literal>checking</literal>” или “<literal>unhealthy</literal>”.
1001
</tag-desc>
1002

1003
<tag-name><literal>selected</literal></tag-name>
1004
<tag-desc>
1005
Время (в миллисекундах с начала эпохи),
1006
когда сервер в последний раз был выбран для обработки соединения.
1007
</tag-desc>
1008

1009
</list>
1010
</tag-desc>
1011

1012
<tag-name><literal>zombies</literal></tag-name>
1013
<tag-desc>
1014
Текущее число серверов, удалённых
1015
из группы, но всё ещё обрабатывающих активные клиентские соединения.
1016
</tag-desc>
1017

1018
<tag-name><literal>zone</literal></tag-name>
1019
<tag-desc>
1020
Имя <link doc="../stream/ngx_stream_upstream_module.xml" id="zone">зоны</link>
1021
разделяемой памяти,
1022
в которой хранятся конфигурация группы и её рабочее состояние.
1023
</tag-desc>
1024

1025
</list>
1026
</tag-desc>
1027

1028
</list>
1029
</para>
1030

1031
</section>
1032

1033
<section id="compatibility" name="Совместимость">
1034

1035
<para>
1036
<list type="bullet">
1037

1038
<listitem>
1039
Поле <link id="zone"/> в
1040
<link id="upstreams">http</link> и <link id="stream_upstreams">stream</link>
1041
upstreams
1042
было добавлено в <link id="version">версии</link> 8.
1043
</listitem>
1044

1045
<listitem>
1046
Поля <link id="slabs"/>
1047
были добавлены в <link id="version">версии</link> 8.
1048
</listitem>
1049

1050
<listitem>
1051
Состояние
1052
<link id="state">checking</link>
1053
было добавлено в <link id="version">версии</link> 8.
1054
</listitem>
1055

1056
<listitem>
1057
Поля
1058
<link id="name"/> и <link id="service"/> в
1059
<link id="upstreams">http</link> и <link id="stream_upstreams">stream</link>
1060
upstreams
1061
были добавлены в <link id="version">версии</link> 8.
1062
</listitem>
1063

1064
<listitem>
1065
Поля <link id="nginx_build"/> и <link id="ppid"/>
1066
были добавлены в <link id="version">версии</link> 8.
1067
</listitem>
1068

1069
<listitem>
1070
Поля <link id="sessions"/>
1071
и поле <link id="stream_discarded">discarded</link> в
1072
stream <link id="stream_server_zones">server_zones</link>
1073
были добавлены в <link id="version">версии</link> 7.
1074
</listitem>
1075

1076
<listitem>
1077
Поле <link id="zombies"/>
1078
было перемещено из <link doc="../debugging_log.xml">debug</link>-версии nginx
1079
в <link id="version">версии</link> 6.
1080
</listitem>
1081

1082
<listitem>
1083
Поля <link id="ssl"/>
1084
были добавлены в <link id="version">версии</link> 6.
1085
</listitem>
1086

1087
<listitem>
1088
Поле <link id="discarded"/> в
1089
<link id="server_zones"/>
1090
было добавлено в <link id="version">версии</link> 6.
1091
</listitem>
1092

1093
<listitem>
1094
Поля <link id="queue"/>
1095
были добавлены в <link id="version">версии</link> 6.
1096
</listitem>
1097

1098
<listitem>
1099
Поле <link id="pid"/>
1100
было добавлено в <link id="version">версии</link> 6.
1101
</listitem>
1102

1103
<listitem>
1104
Список серверов в <link id="upstreams"/> был
1105
перемещён в <link id="peers"/> в
1106
<link id="version">версии</link> 6.
1107
</listitem>
1108

1109
<listitem>
1110
Поле <literal>keepalive</literal> сервера группы
1111
было удалено в <link id="version">версии</link> 5.
1112
</listitem>
1113

1114
<listitem>
1115
<link id="stream">stream</link>
1116
был добавлен в <link id="version">версии</link> 5.
1117
</listitem>
1118

1119
<listitem>
1120
Поле <link id="generation"/>
1121
было добавлено в <link id="version">версии</link> 5.
1122
</listitem>
1123

1124
<listitem>
1125
Поле <link id="respawned"/> в
1126
<link id="processes"/>
1127
было добавлено в <link id="version">версии</link> 5.
1128
</listitem>
1129

1130
<listitem>
1131
Поля <link id="header_time"/> и <link id="response_time"/> в
1132
<link id="upstreams"/>
1133
были добавлены в <link id="version">версии</link> 5.
1134
</listitem>
1135

1136
<listitem>
1137
Поле <link id="selected"/> в
1138
<link id="upstreams"/>
1139
было добавлено в <link id="version">версии</link> 4.
1140
</listitem>
1141

1142
<listitem>
1143
Состояние <link id="state">draining</link> в
1144
<link id="upstreams"/>
1145
было добавлено в <link id="version">версии</link> 4.
1146
</listitem>
1147

1148
<listitem>
1149
Поля <link id="id"/> и <link id="max_conns"/> в
1150
<link id="upstreams"/>
1151
были добавлены в <link id="version">версии</link> 3.
1152
</listitem>
1153

1154
<listitem>
1155
Поле <literal>revalidated</literal> в <link id="caches"/>
1156
было добавлено в <link id="version">версии</link> 3.
1157
</listitem>
1158

1159
<listitem>
1160
<link id="server_zones"/>, <link id="caches"/>
1161
и <link id="load_timestamp"/>
1162
были добавлены в <link id="version">версии</link> 2.
1163
</listitem>
1164

1165
</list>
1166
</para>
1167

1168
</section>
1169

1170
</module>
1171

1172
Product

Resources

Company
