upstream_show

Директива upstream_show используется внутри контекста блока location в конфигурациях NGINX, особенно при использовании модуля NGINX для синхронизации upstream из Consul или etcd. Когда эта директива активирована, она выводит детали конфигурации upstream‑серверов, которые были определены и синхронизированы из указанного сервиса конфигурации (например, Consul или etcd). Это особенно полезно для отладки и проверки текущего состояния upstream без необходимости перезагрузки конфигурации или перезапуска сервера NGINX. Отображаемая информация может включать веса серверов, состояние здоровья и состояния подключений, что даёт представление о конфигурации балансировки нагрузки и возможных проблемах с бэкенд‑сервисами.

Поведение директивы upstream_show основано на её способности читать и сообщать существующие конфигурации upstream‑серверов, определённые предыдущими директивами, в первую очередь теми, которые настроены с помощью директивы upsync. Добавив её в блок location, администраторы могут иметь в приложении конечную точку, которая при обращении возвращает текущее состояние upstream‑серверов, что помогает быстро диагностировать проблемы, связанные с сервисами, без прерывания их работы. Поскольку директива не требует параметров или дополнительных аргументов, её использование в файле конфигурации упрощается.