Веб-панель мониторинга Console Light#
Angie предоставляет широкий спектр возможностей мониторинга своей работы; помимо метрик в API и модуля Prometheus, можно использовать визуальную консоль, устанавливаемую в дополнение к серверу.
Связанные модули
Модуль API: каждый виджет читает дерево
/status/.Модуль HTTP: status_zone и
status_zone=в resolver наполняют «HTTP-зоны» и «DNS-резолверы».Модуль Stream: status_zone и
status_zone=в resolver наполняют «TCP/UDP-зоны» и «DNS-резолверы».Модуль HTTP Limit Conn: зоны дополняют вкладку «HTTP-зоны».
Модуль Limit Req: зоны дополняют вкладку «HTTP-зоны».
Модуль Stream Limit Conn: зоны дополняют вкладку «TCP/UDP-зоны».
Модуль HTTP Proxy: proxy_cache_path наполняет «Кэши».
Модуль FastCGI: fastcgi_cache_path наполняет «Кэши».
Модуль SCGI: scgi_cache_path наполняет «Кэши».
Модуль uWSGI: uwsgi_cache_path наполняет «Кэши».
Модуль Mail:
status_zone=в resolver наполняет «DNS-резолверы».
Console Light#
Console Light — это облегченный интерфейс мониторинга активности в реальном времени, который отображает ключевые показатели нагрузки и производительности сервера. Консоль основана на возможностях API-интерфейса Angie; данные мониторинга активности генерируются в реальном времени. Кроме того, консоль позволяет динамически изменять конфигурацию Angie там, где эту возможность предоставляет сам API.
Пример развернутой и настроенной консоли: https://console.angie.software/
История версий#
Версия | Дата выпуска | Изменения |
|---|---|---|
1.9.0 | 14.08.2026 | Добавлено отображение состояний |
1.8.2 | 23.01.2026 | Исправлена ссылка на документацию Angie ADC. |
1.8.1 | 08.09.2025 | Корректировка терминологии в разделе "Настройки" и в подсказках. |
1.8.0 | 03.07.2025 | Отображение метрик времени отклика для проксируемых HTTP- и TCP/UDP-серверов |
1.7.2 | 07.04.2025 | Добавлена опция "busy" в контроллере фильтров на страницах "HTTP/TCP/UDP-апстримы". |
1.7.1 | 04.04.2025 | Исправлены некорректные значения в таблицах "HTTP/Location Zones" на странице "HTTP Zones". |
1.7.0 | 02.04.2025 |
|
1.6.1 | 27.01.2025 |
|
1.6.0 | 23.01.2025 |
|
1.5.0 | Не выпускалась публично. | |
1.4.0 | 08.08.2024 | Добавлено отображение статуса мониторинга в фавиконке веб-сайта. |
1.3.0 | 28.04.2024 | Добавлена возможность перевода сервера в состояние |
1.2.1 | 26.12.2023 | Добавлены активные проверки состояния в контексте |
1.2.0 | 25.12.2023 | Добавлено редактирование серверов в контексте |
Установка и настройка#
Console Light публикуется в виде пакетов
angie-console-light (Angie)
и
angie-pro-console-light (Angie PRO)
в
наших репозиториях
и устанавливается так же, как и любой другой пакет;
кроме того, можно скачать исходный код
с нашего веб-сайта
или
GitHub.
После установки настройте консоль, добавив такой фрагмент location внутри блока server в конфигурации сервера (обратите внимание на комментарии):
location /console/ {
# Только локальный доступ
allow 127.0.0.1;
deny all;
auto_redirect on;
alias /usr/share/angie-console-light/html/;
# Только во FreeBSD:
# alias /usr/local/www/angie-console-light/html/;
index index.html;
location /console/api/ {
api /status/;
}
# Чтобы после аутентификации работали функции редактирования (только PRO)
location /console/api/config/ {
auth_basic "Защищенный сайт";
auth_basic_user_file conf/htpasswd;
api /config/;
}
}
Не забудьте применить измененную конфигурацию:
$ sudo angie -t && sudo service angie reload
После этого консоль будет доступна
на сервере, заданном блоком server,
по указанному для location пути;
выше путь задан как /console/.
Включить аутентификацию аналогично примеру выше можно для произвольного раздела API, например:
location /console/server_zones/ {
auth_basic "Защищенный сайт";
auth_basic_user_file conf/htpasswd;
}
Можно также запретить доступ к произвольному разделу
настроенного таким образом location для консоли, например:
location /console/api/resolvers/ {
deny all;
}
Интерфейс#
Консоль представляет собой единый экран с набором вкладок, каждая из которых содержит ряд виджетов с данными мониторинга.
Совет
В разделах ниже описания элементов интерфейса даны в порядке слева направо.
Вкладка Angie#

Это основная вкладка, где в сводном виде отображаются основные показатели мониторинга Angie, сведенные на основе данных из нескольких разделов API.
Примечание
Виджеты со статистикой отображаются, если настроены соответствующие блоки в конфигурации Angie.
Виджет Сведения#
Здесь выводится номер версии Angie со ссылкой на соответствующую документацию, а также адрес сервера и время последней перезагрузки конфигурации.
Кроме того, если включена директива api_config_files, ссылка Configs открывает список файлов конфигурации, загруженных на сервере. Затем каждый файл можно просмотреть в компактном виде с подсветкой синтаксиса.
Виджет Соединения#
Здесь представлена основная статистика серверных соединений, формируемая на
основе раздела API /status/connections/:
| Текущее количество соединений |
| Число принимаемых за секунду соединений |
| Число активных соединений |
| Число соединений в состоянии ожидания |
| Количество сброшенных соединений |
Также доступно:
| Общее число соединений, принятых с последней перезагрузки сервера |
Виджет HTTP-зоны#
Предупреждение
Требует задать директиву status_zone
в контексте server или location.
Здесь представлена статистика зон разделяемой памяти контекста http,
формируемая на основе раздела API /status/http/server_zones/:
| Общее количество зон |
| Количество зон с какими-либо проблемами |
| Скорость входящего и исходящего трафика в байтах в секунду |
Виджет HTTP-апстримы#
Здесь представлена статистика апстримов контекста http, формируемая на
основе раздела API /status/http/upstreams/:
| Общее количество апстримов |
| Количество апстримов с какими-либо проблемами |
| Статистика серверов с разделением по состоянию |
Виджет TCP/UDP-зоны#
Предупреждение
Требует задать директиву status_zone в блоке
server контекста stream.
Пример:
stream {
server {
# ...
status_zone foo;
}
}
Здесь представлена статистика зон разделяемой памяти контекста stream,
формируемая на основе раздела API /status/stream/server_zones/:
| Общее количество клиентских соединений |
| Текущее количество клиентских соединений |
| Количество обрабатываемых в секунду соединений |
Виджет TCP/UDP-апстримы#
Здесь представлена статистика апстримов контекста stream, формируемая на
основе раздела API /status/stream/upstreams/:
| Общее количество апстримов |
| Количество апстримов с какими-либо проблемами |
| Статистика серверов с разделением по состоянию |
Виджет Кэши#
Предупреждение
Требует задать зону кэша директивой proxy_cache_path, fastcgi_cache_path, scgi_cache_path или uwsgi_cache_path.
Здесь представлена статистика зон кэша контекста http, формируемая на
основе раздела API /status/http/caches/:
| Общее количество зон кэша |
| Количество проблемных зон, причем каждый проблемный шард зоны
с шардингом учитывается отдельно; если таких нет, но есть зоны
с предупреждениями, вместо этой метки выводится |
| Количество горячих (метаданные загружены) и холодных (метаданные загружаются в память) зон |
Зона кэша получает предупреждение, если:
ее
Коэффициент попаданияна вкладке Кэши, вычисляемый за временное окно из настроек, ниже 30% (у зоны без ответов за это окно он равен 0%);ее объем на диске превышает
max_sizeне более чем на 5%.
Если объем зоны на диске превышает max_size более чем на 5%, зона
считается проблемной. Для зоны с шардингом эти проверки
объема выполняются для каждого шарда отдельно, а шард с превышением не более
чем на 5% дает всей зоне предупреждение.
Виджет DNS-резолверы#
Здесь представлена статистика DNS-резолверов, формируемая на основе раздела API /status/resolvers/:
| Общее количество зон резолверов |
| Количество зон, в которых с момента предыдущего обновления данных
число ответов, отличных от |
| Число запросов ( |
Вкладка HTTP-зоны#
Предупреждение
Требует задать директиву status_zone
в контексте server или location. Для раздела «Зоны
ограничения соединений» также нужна директива limit_conn_zone, а для
раздела «Зоны ограничения запросов» — директива limit_req_zone; обе
задаются в контексте http.
Раздел Серверные зоны#

Здесь в сводном виде отображается статистика мониторинга зон разделяемой памяти
для контекста server в http, формируемая на основе раздела API
/status/http/server_zones/. Для каждой
зоны представлены следующие данные:
| Имя зоны Совет Щелкните стрелку рядом с пунктом |
| Общее количество запросов, а также число запросов в секунду |
| Количество ответов с разбиением по кодам статуса, а также их общее количество |
| Скорость исходящего и входящего трафика в байтах в секунду, а также общие объемы исходящего и входящего трафика в байтах |
| Суммарные показатели количества: успешных SSL-рукопожатий; повторных использований SSL-сессий; SSL-рукопожатий с истекшим таймаутом; неуспешных SSL-рукопожатий |
Раздел Зоны путей (Location)#

Здесь в сводном виде отображается статистика мониторинга зон разделяемой памяти
для контекста location в http, формируемая на основе раздела API
/status/http/location_zones/. Для
каждой зоны представлены следующие данные:
| Имя зоны Совет Щелкните стрелку рядом с пунктом |
| Общее количество запросов, а также число запросов в секунду |
| Количество ответов с разбиением по кодам статуса, а также их общее количество |
| Скорость исходящего и входящего трафика в байтах в секунду, а также общие объемы исходящего и входящего трафика в байтах |
Раздел Зоны ограничения соединений (Limit Conn)#

Здесь приведена статистика зон, заданных директивой limit_conn_zone
в контексте http, формируемая на основе раздела API
/status/http/limit_conns/. Для каждой зоны
представлены следующие данные:
| Имя зоны Совет Щелкните значок рядом с пунктом |
| Общее количество соединений, проверенных зоной и не ограниченных |
| Общее количество отклоненных соединений |
| Общее количество соединений, отклоненных из-за переполнения хранилища зоны |
| Общее количество соединений, не проверявшихся зоной из-за пустого ключа или ключа длиннее 255 байт (учитываются, только если соединение не отклонила ни одна зона) |
Раздел Зоны ограничения запросов (Limit Req)#

Здесь приведена статистика зон, заданных директивой limit_req_zone
в контексте http, формируемая на основе раздела API
/status/http/limit_reqs/. Для каждой зоны
представлены следующие данные:
| Имя зоны Совет Щелкните значок рядом с пунктом |
| Общее количество запросов, проверенных зоной и не задержанных и не отклоненных |
| Общее количество задержанных запросов |
| Общее количество отклоненных запросов |
| Общее количество запросов, отклоненных из-за переполнения хранилища зоны |
| Общее количество запросов, не проверявшихся зоной из-за пустого ключа или ключа длиннее 65535 байт (учитываются, только если запрос проверила и не отклонила другая зона) |
Вкладка HTTP-апстримы#

На этой вкладке в сводном виде отображается статистика мониторинга апстримов
контекста http, формируемая на основе раздела API
/status/http/upstreams/.
В режиме отладки также отображается процент загрузки памяти.
Кнопка
Показать список апстримовпереключает краткий список апстримов с указанием числа проблемных апстримов и пиров.Переключатель
Только проблемныепереключает режим вывода статистики по проблемным апстримам.Кнопка редактирования переключает интерфейс
редактирования апстрима.Раскрывающийся список с правой стороны таблицы каждого апстрима позволяет отфильтровать серверы в определенном состоянии (
Активные,Проблемные,На проверке,Выключенные).
Для каждого апстрима, помимо имени и коэффициента использования зоны разделяемой памяти, представлены следующие данные:
| Имена, общее время простоя и веса серверов апстрима Совет Щелкните стрелку рядом с пунктом |
| Общее количество и скорость обработки запросов |
| Количество ответов с разбиением по кодам статуса |
| Количество активных соединений и их максимальный предел, если он задан |
| Скорость исходящего и входящего трафика в байтах в секунду, а также общие объемы исходящего и входящего трафика в байтах |
| Количество неуспешных обращений к серверу и число раз, когда сервер
считался недоступным (объект |
| Общее количество проверок сервера, количество неуспешных проверок, а также время последней проверки |
| Время от начала запроса до отправки первого байта ответа;
общее время от начала запроса до завершения отправки всего ответа
(объект |
Редактирование апстримов#
В Angie PRO рядом с каждым апстримом есть кнопка редактирования; при нажатии она выводит еще две кнопки:
Вкладка TCP/UDP-зоны#
Предупреждение
Требует задать директиву status_zone в блоке
server контекста stream. Для раздела «Зоны ограничения
соединений» также нужна директива
limit_conn_zone в контексте stream.
Пример:
stream {
# ...
limit_conn_zone $connection zone=limit-conn-stream:10m;
server {
# ...
status_zone foo;
# необязательно: учитывает соединения этого сервера в зоне
limit_conn limit-conn-stream 1;
}
}
Раздел TCP/UDP-зоны#

Здесь в сводном виде отображается статистика мониторинга зон разделяемой памяти
контекста server в stream, формируемая на основе раздела API
/status/stream/server_zones/. Для каждой
зоны представлены следующие данные:
| Имя зоны |
| Текущее и общее количество соединений, а также число соединений в секунду |
| Количество сессий с разбиением по кодам статуса, а также их общее число |
| Скорость исходящего и входящего трафика в байтах в секунду, а также общие объемы исходящего и входящего трафика в байтах |
| Суммарные показатели количества: успешных SSL-рукопожатий; неуспешных SSL-рукопожатий; повторных использований SSL-сессий |
Раздел Зоны ограничения соединений (Limit Conn)#

Здесь приведена статистика зон, заданных директивой
limit_conn_zone в контексте stream,
формируемая на основе раздела API /status/stream/limit_conns/. Для каждой зоны представлены следующие данные:
| Имя зоны Совет Щелкните значок рядом с пунктом |
| Общее количество соединений, проверенных зоной и не ограниченных |
| Общее количество отклоненных соединений |
| Общее количество соединений, отклоненных из-за переполнения хранилища зоны |
| Общее количество соединений, не проверявшихся зоной из-за пустого ключа или ключа длиннее 255 байт (учитываются, только если соединение не отклонила ни одна зона) |
Вкладка TCP/UDP-апстримы#

На этой вкладке в сводном виде отображается статистика мониторинга апстримов
контекста stream, формируемая на основе раздела API
/status/stream/upstreams/.
В режиме отладки также отображается процент загрузки памяти.
Кнопка
Показать список апстримовпереключает отображение краткого списка апстримов с указанием числа проблемных апстримов и пиров.Переключатель
Только проблемныевключает и отключает режим вывода статистики по проблемным апстримам.Кнопка редактирования открывает виджет
редактирования апстрима.Раскрывающийся список с правой стороны таблицы каждого апстрима позволяет отфильтровать серверы в определенном состоянии (
Активные,Проблемные,На проверке,Выключенные).
Для каждого апстрима представлены следующие данные:
| Имена, общее время простоя и веса серверов апстрима Совет Щелкните стрелку рядом с пунктом |
| Количество активных соединений и их максимальный предел, если он задан |
| Скорость исходящего и входящего трафика в байтах в секунду, а также общие объемы исходящего и входящего трафика в байтах |
| Количество неуспешных обращений к серверу и число раз, когда сервер
считался недоступным (объект |
| Общее количество проверок сервера, количество неуспешных проверок, а также время последней проверки |
| Время, затраченное на установку соединения с бэкендом;
время от начала запроса до получения первого байта ответа;
общее время, прошедшее от начала запроса до получения последнего байта ответа
(объект |
Редактирование апстримов#
В Angie PRO рядом с каждым апстримом есть кнопка редактирования; при нажатии она выводит еще две кнопки:
Вкладка Кэши#

Предупреждение
Требует задать зону кэша директивой proxy_cache_path, fastcgi_cache_path, scgi_cache_path или uwsgi_cache_path.
На этой вкладке в сводном виде отображается статистика мониторинга зон
кэша контекста http, формируемая на основе раздела API
/status/http/caches/. Для каждой зоны
представлены следующие данные:
| Имя зоны Совет Щелкните значок рядом с пунктом |
| Состояние кэша: холодный (метаданные загружаются в память) или горячий (метаданные загружены) |
| Коэффициент использования памяти |
| Максимальный объем кэша на диске в байтах; знак бесконечности, если объем кэша не ограничен |
| Текущий объем кэша на диске в байтах |
| Коэффициент использования диска |
| Объем трафика (в байтах), переданного из кэша, записанного в кэш и возвращенного в обход кэша |
| Доля ответов, переданных из кэша ( |
Для зоны с включенным шардингом значения
Макс. объем, Использовано и Использовано диска
отслеживаются отдельно для каждого шарда; в строке самой зоны выводятся
прочерки, а зона обозначена как раскрывающийся список, в котором перечислены
отдельные шарды:
| Путь шарда на диске |
| Состояние шарда: холодный (метаданные загружаются в память) или горячий (метаданные загружены) |
| Максимальный объем шарда на диске в байтах; знак бесконечности, если объем шарда не ограничен |
| Текущий объем шарда на диске в байтах |
| Коэффициент использования диска |
Вкладка DNS-резолверы#

На этой вкладке в сводном виде отображается статистика запросов в зонах разделяемой памяти DNS, формируемая на основе раздела API /status/resolvers/. Для каждой зоны представлены следующие данные:
| Имя зоны Совет Щелкните стрелку рядом с пунктом |
| Количество запросов типа A и AAAA, SRV, PTR |
| Количество ответов с разделением по соответствующим кодам
( |
Виджет Настройки#

Позволяет настроить общие параметры консоли:
Частоту обновления данных. Значение по умолчанию — 1 сек.
Порог доли ответов
4xxсреди всех запросов HTTP-зоны или сервера HTTP-апстрима. При его превышении зона или сервер учитывается как предупреждение в виджете «HTTP-зоны» или «HTTP-апстримы», а значок соответствующей вкладки становится «желтым», если там нет проблем; на вкладке «HTTP-зоны» строка такой зоны тоже помечается «желтым». Значение по умолчанию — 30%.Временное окно для вычисления соотношения успешных попаданий в кэш. Значение по умолчанию — 300 сек.
Порог ошибок DNS. При его превышении зона резолвера становится «красной». Значение по умолчанию — 3%.
Язык интерфейса консоли. Доступные варианты: английский (English) и русский. По умолчанию язык консоли выбирается на основе локали, установленной в браузере.
Панель управления консолью#
На всех вкладках в середине левой части страницы есть выдвигающаяся панель с
двумя кнопками
. Верхняя приостанавливает и вновь запускает обновление
данных из API, а нижняя позволяет обновить данные вручную, когда обновление
приостановлено.


