NGINX: различия между версиями

Материал из Dynatrace
Строка 3: Строка 3:
* Все входящие запросы.
* Все входящие запросы.
* Исходящие запросы, исходящие от одного из следующих:
* Исходящие запросы, исходящие от одного из следующих:
** модуль ngx_http_proxy_module (прокси_пасс)
** модуль ngx_http_proxy_module ( proxy_pass )
** модуль ngx_http_fastcgi_module (fastcgi_pass)
** модуль ngx_http_fastcgi_module (fastcgi_pass)
** модуль ngx_http_memcached_module (memcached_pass)
** модуль ngx_http_memcached_module (memcached_pass)
Строка 11: Строка 11:


== Поддерживаемые версии NGINX            ==
== Поддерживаемые версии NGINX            ==
Поддержка одного агента для NGINX основана на проверенных двоичных файлах NGINX. Следующие изображения помогут вам определить, подходит ли выпуск для поддержки одного агента:
Поддержка ЕдиногоАгента для NGINX основана на проверенных двоичных файлах NGINX. Следующие изображения помогут вам определить, подходит ли выпуск для поддержки ЕдинымАгентом:


В Ключ-Астром информационное сообщение появляется в деталях процесса NGINX, когда предпринимается попытка использовать неподдерживаемый двоичный файл или недоступен API для расширенных показателей NGINX Plus.
В Ключ-Астром информационное сообщение появляется в деталях процесса NGINX, когда предпринимается попытка использовать неподдерживаемый двоичный файл или недоступен API для расширенных показателей NGINX Plus.
{| class="wikitable"
{| class="wikitable"
!Версия NGINX
!Версия NGINX
!Vendor released
!Выпущено вендором
!Vendor End of life
!Конец поддержки вендором
!Поддерживается Ключ-Астром до тех пор, пока
!Первая поддерживаемая версия ЕдиногоАгена
!Первая поддерживаемая версия Ключ-Астром ЕдиныйАгент
!Последняя поддерживаемая версия ЕдиногоАгента
!Последняя поддерживаемая версия Ключ-Астром ЕдиныйАгент
!Поддержка Ключ-Астром до
!Уровень поддержки Ключ-Астром
|-
|-
|1.11.5+
|1.11.5+
|
| -
|
| -
|
|1.189
| -
| -
|Поддерживается<sup>1</sup>
|-
|1.11.5+
| -
| -
|1.169
|1.169
|
| -
| -
|Поддерживается<sup>1</sup>
|-
|-
|1.11.5+
|1.11.5+
|
| -
|
| -
|
|1.145
|1.145
|
| -
| -
|Поддерживается<sup>1</sup>
|-
|-
|1.4 - 1.11.4
|1.4 - 1.11.4
|
| -
|
| -
|
| -
|
| -
|
| -
|Поддерживается<sup>2</sup>
|}
|}
<sup>1</sup> Последние версии обычно поддерживаются в течение 2 недель после последнего выпуска ЕдиногоАгента.
<sup>2</sup> Пока конкретные используемые двоичные файлы находятся либо в списке поддерживаемых двоичных файлов, либо соответствующая отладочная информация доступна локально.
{| class="wikitable"
{| class="wikitable"
!Версия NGINX Plus  
!Версия NGINX Plus  
!Vendor released
!Выпущено вендором
!Vendor End of life
!Конец поддержки вендором
!Поддерживается Ключ-Астром до тех пор, пока
!Первая поддерживаемая версия ЕдиногоАгена
!Первая поддерживаемая версия Ключ-Астром ЕдиныйАгент
!Последняя поддерживаемая версия ЕдиногоАгента
!Последняя поддерживаемая версия Ключ-Астром ЕдиныйАгент
!Поддержка Ключ-Астром до
!Уровень поддержки Ключ-Астром
|-
|R11+
| -
| -
|1.189
| -
| -
|Поддерживается<sup>1</sup>
|-
|-
|R11+
|R11+
|
| -
|
| -
|
|1.169
|1.169
|
| -
| -
|Поддерживается<sup>1</sup>
|-
|-
|R11+
|R11+
|
| -
|
| -
|
|1.145
|1.145
|
| -
| -
|Поддерживается<sup>1</sup>
|-
|-
|R1 - R10
|R1 - R10
|
| -
|
| -
|
| -
|
| -
|
| -
|Поддерживается<sup>2</sup>
|}
|}
<sup>1</sup> Последние версии обычно поддерживаются в течение 2 недель после последнего выпуска ЕдиногоАгента.
<sup>2</sup> Пока конкретные используемые двоичные файлы находятся либо в списке поддерживаемых двоичных файлов, либо соответствующая отладочная информация доступна локально.
{| class="wikitable"
{| class="wikitable"
!Версия Tengine  
!Версия Tengine  
!Vendor released
!Выпущено вендором
!Vendor End of life
!Конец поддержки вендором
!Поддерживается Ключ-Астром до тех пор, пока
!Первая поддерживаемая версия ЕдиногоАгена
!Первая поддерживаемая версия Ключ-Астром ЕдиныйАгент
!Последняя поддерживаемая версия ЕдиногоАгента
!Последняя поддерживаемая версия Ключ-Астром ЕдиныйАгент
!Поддержка Ключ-Астром до
!Уровень поддержки Ключ-Астром
|-
|-
|1.4.2 - 2.2.3
|1.4.2 - 2.2.3
|
| -
|
| -
|
|1.173
|1.173
|
| -
| -
|Поддерживается
|}
|}
{| class="wikitable"
{| class="wikitable"
!Версия OpenResty
!Версия OpenResty
!Vendor released
!Выпущено вендором
!Vendor End of life
!Конец поддержки вендором
!Поддерживается Ключ-Астром до тех пор, пока
!Первая поддерживаемая версия ЕдиногоАгена
!Первая поддерживаемая версия Ключ-Астром ЕдиныйАгент
!Последняя поддерживаемая версия ЕдиногоАгента
!Последняя поддерживаемая версия Ключ-Астром ЕдиныйАгент
!Поддержка Ключ-Астром до
!Уровень поддержки Ключ-Астром
|-
|-
|1.13.6.x,          1.15.8.x,          1.17.8.x,          1.19.3.x
|1.19.3.x
|
| -
|
| -
|
| -
|
| -
|
| -
|Поддерживается<sup>1</sup>
|-
|1.17.8.x
| -
| -
| -
| -
| -
|Поддерживается<sup>1</sup>
|-
|1.15.8.x
| -
| -
| -
| -
| -
|Поддерживается<sup>1</sup>
|-
|1.13.6.x
| -
| -
| -
| -
| -
|Поддерживается<sup>1</sup>
|-
|-
|1.11.2.x
|1.11.2.x
|
| -
|
| -
|
| -
|
| -
|
| -
|Ограниченно<sup>2</sup>
|}
|}
<sup>1</sup> Последние версии обычно поддерживаются в течение 2 недель после последнего выпуска ЕдиногоАгента.
<sup>2</sup> Поддерживается, пока двоичный файл находится в списке поддерживаемых двоичных файлов.


=== Поддержка NGINX 1.11.5+, NGINX Plus R11+            ===
=== Поддержка NGINX 1.11.5+, NGINX Plus R11+            ===
Строка 116: Строка 178:


=== Поддержка NGINX 1.4 - 1.11.4, NGINX Plus R1 - R10            ===
=== Поддержка NGINX 1.4 - 1.11.4, NGINX Plus R1 - R10            ===
Один агент использует отладочную информацию NGINX из пакетов NGINX для инструментирования NGINX. Стандартные источники пакетов NGINX регулярно обнаруживаются Ключ-Астром для поддержки новых двоичных файлов.
ЕдиныйАгент использует отладочную информацию NGINX из пакетов NGINX для инструментирования NGINX. Стандартные источники пакетов NGINX регулярно обнаруживаются Ключ-Астром для поддержки новых двоичных файлов.


Вот список поддерживаемых двоичных файлов, для которых Ключ-Астром имеет доступную отладочную информацию:
Вот список поддерживаемых двоичных файлов, для которых Ключ-Астром имеет доступную отладочную информацию:


binaries list
=== Поддержка Tengine            ===
 
=== Поддержкаr Tengine            ===
Движок основан на NGINX и предоставляет некоторые расширенные возможности.
Движок основан на NGINX и предоставляет некоторые расширенные возможности.


Строка 133: Строка 193:
Чтобы ЕдиныйАгент сообщал о показателях HTTP-соединения, вам необходимо создать NGINX с помощью http_stub_status_module.
Чтобы ЕдиныйАгент сообщал о показателях HTTP-соединения, вам необходимо создать NGINX с помощью http_stub_status_module.


Как построить NGINX с помощью http_stub_status_module
=== Как собрать NGINX с помощью http_stub_status_module ===
Используйте параметр конфигурации <code>--with-http_stub_status_module</code>.


Как проверить, был ли двоичный файл NGINX собран с помощью http_stub_status_module
=== Как проверить, был ли двоичный файл NGINX собран с помощью http_stub_status_module ===
Вызовите nginx -V в вашей командной строке. Это вернет параметры конфигурации NGINX. Убедитесь, что выходные данные содержат параметр <code>--with-http_stub_status_module</code>.


== NGINX Plus metrics            ==
== NGINX Plus metrics            ==
Метрики NGINX Plus захватываются из NGINX Plus Status API (до R15) или NGINX Plus API (R16 +).
Метрики NGINX Plus захватываются из NGINX Plus Status API (до R15) или NGINX Plus API (R16 +).


API должен быть включен и доступен из ЕдиныйАгент. Если API защищен аутентификацией NGINX, убедитесь, что он доступен с локального хоста для запросов HTTP-GET.
API должен быть включен и доступен для ЕдиногоАгента. Если API защищен аутентификацией NGINX, убедитесь, что он доступен с локального хоста для запросов HTTP-GET.

Версия 14:41, 27 ноября 2022

Для NGINX Ключ-Астром предоставляет информацию о:

  • Все входящие запросы.
  • Исходящие запросы, исходящие от одного из следующих:
    • модуль ngx_http_proxy_module ( proxy_pass )
    • модуль ngx_http_fastcgi_module (fastcgi_pass)
    • модуль ngx_http_memcached_module (memcached_pass)
    • модуль ngx_http_scgi_module (scgi_pass)
    • модуль ngx_http_uwsgi_module (uwsgi_pass)|
  • Захват расширенных показателей NGINX Plus.

Поддерживаемые версии NGINX

Поддержка ЕдиногоАгента для NGINX основана на проверенных двоичных файлах NGINX. Следующие изображения помогут вам определить, подходит ли выпуск для поддержки ЕдинымАгентом:

В Ключ-Астром информационное сообщение появляется в деталях процесса NGINX, когда предпринимается попытка использовать неподдерживаемый двоичный файл или недоступен API для расширенных показателей NGINX Plus.

Версия NGINX Выпущено вендором Конец поддержки вендором Первая поддерживаемая версия ЕдиногоАгена Последняя поддерживаемая версия ЕдиногоАгента Поддержка Ключ-Астром до Уровень поддержки Ключ-Астром
1.11.5+ - - 1.189 - - Поддерживается1
1.11.5+ - - 1.169 - - Поддерживается1
1.11.5+ - - 1.145 - - Поддерживается1
1.4 - 1.11.4 - - - - - Поддерживается2

1 Последние версии обычно поддерживаются в течение 2 недель после последнего выпуска ЕдиногоАгента.

2 Пока конкретные используемые двоичные файлы находятся либо в списке поддерживаемых двоичных файлов, либо соответствующая отладочная информация доступна локально.

Версия NGINX Plus Выпущено вендором Конец поддержки вендором Первая поддерживаемая версия ЕдиногоАгена Последняя поддерживаемая версия ЕдиногоАгента Поддержка Ключ-Астром до Уровень поддержки Ключ-Астром
R11+ - - 1.189 - - Поддерживается1
R11+ - - 1.169 - - Поддерживается1
R11+ - - 1.145 - - Поддерживается1
R1 - R10 - - - - - Поддерживается2

1 Последние версии обычно поддерживаются в течение 2 недель после последнего выпуска ЕдиногоАгента.

2 Пока конкретные используемые двоичные файлы находятся либо в списке поддерживаемых двоичных файлов, либо соответствующая отладочная информация доступна локально.

Версия Tengine Выпущено вендором Конец поддержки вендором Первая поддерживаемая версия ЕдиногоАгена Последняя поддерживаемая версия ЕдиногоАгента Поддержка Ключ-Астром до Уровень поддержки Ключ-Астром
1.4.2 - 2.2.3 - - 1.173 - - Поддерживается
Версия OpenResty Выпущено вендором Конец поддержки вендором Первая поддерживаемая версия ЕдиногоАгена Последняя поддерживаемая версия ЕдиногоАгента Поддержка Ключ-Астром до Уровень поддержки Ключ-Астром
1.19.3.x - - - - - Поддерживается1
1.17.8.x - - - - - Поддерживается1
1.15.8.x - - - - - Поддерживается1
1.13.6.x - - - - - Поддерживается1
1.11.2.x - - - - - Ограниченно2

1 Последние версии обычно поддерживаются в течение 2 недель после последнего выпуска ЕдиногоАгента.

2 Поддерживается, пока двоичный файл находится в списке поддерживаемых двоичных файлов.

Поддержка NGINX 1.11.5+, NGINX Plus R11+

Стандартные источники пакетов NGINX регулярно обнаруживаются Ключ-Астром для поддержки новейших двоичных файлов.

Поддержка последних выпусков NGINX включена в следующие последующие выпуски одного агента (обычно в течение двух недель после каждого выпуска NGINX). Поддержка новейшего API NGINX Plus может отличаться от поддержки двоичных файлов NGINX.

Поддержка NGINX 1.4 - 1.11.4, NGINX Plus R1 - R10

ЕдиныйАгент использует отладочную информацию NGINX из пакетов NGINX для инструментирования NGINX. Стандартные источники пакетов NGINX регулярно обнаруживаются Ключ-Астром для поддержки новых двоичных файлов.

Вот список поддерживаемых двоичных файлов, для которых Ключ-Астром имеет доступную отладочную информацию:

Поддержка Tengine

Движок основан на NGINX и предоставляет некоторые расширенные возможности.

Показатели HTTP-соединения NGINX

Метриками HTTP-соединения являются:

  • Количество вновь поступающих соединений, принятых для обработки или отброшенных
  • Количество открытых в данный момент подключений (активно выполняющих операции ввода-вывода чтения/записи или ожидающих подключения к сети)

Чтобы ЕдиныйАгент сообщал о показателях HTTP-соединения, вам необходимо создать NGINX с помощью http_stub_status_module.

Как собрать NGINX с помощью http_stub_status_module

Используйте параметр конфигурации --with-http_stub_status_module.

Как проверить, был ли двоичный файл NGINX собран с помощью http_stub_status_module

Вызовите nginx -V в вашей командной строке. Это вернет параметры конфигурации NGINX. Убедитесь, что выходные данные содержат параметр --with-http_stub_status_module.

NGINX Plus metrics

Метрики NGINX Plus захватываются из NGINX Plus Status API (до R15) или NGINX Plus API (R16 +).

API должен быть включен и доступен для ЕдиногоАгента. Если API защищен аутентификацией NGINX, убедитесь, что он доступен с локального хоста для запросов HTTP-GET.