Диагностика и Супервизор¶
Страница описывает инструмент надзора за SCADA/BMS-платформа ГАУС — Супервизор. Он наблюдает за состоянием компонентов платформы, показывает их логи, проводит углублённую диагностику (база данных, сеть, процессы, события ОС), позволяет управлять службами (запуск, остановка, перезапуск) и выполняет резервное копирование. Супервизор — отдельная утилита с веб-интерфейсом; тот же интерфейс встраивается в десктоп-клиент ГАУС отдельным окном и доступен встроенному ИИ-ассистенту.
Назначение Супервизора¶
Платформа состоит из нескольких самостоятельных компонентов (серверное ядро, служебные сервисы, драйверы связи, СУБД), которые могут работать на разных узлах. Супервизор даёт единую точку наблюдения и управления всеми компонентами платформы: в одном месте видно, что запущено и здорово, где возникают ошибки, что пишут логи и как ведут себя база данных и сеть. Отсюда же можно перезапускать службы и выполнять резервное копирование, не заходя на каждый узел вручную.
Супервизор рассчитан на работу поверх любой установки платформы: он распознаёт компоненты автоматически. Так один инструмент обслуживает объекты платформы ГАУС.
Мониторинг компонентов¶
Супервизор отслеживает состояние большого числа компонентов платформы (ядро, служебные сервисы, драйверы) и обновляет статусы с небольшим интервалом опроса (порядка секунд), поэтому сводка отражает состояние, близкое к реальному времени.
По каждому компоненту видно, запущен ли он и находится ли в нормальном состоянии. Компонент не в норме — сигнал разобраться: посмотреть логи этого компонента и углублённую диагностику соответствующей подсистемы (см. ниже).
Как проверить состояние компонентов платформы¶
Предусловия: Супервизор запущен и вы вошли в его веб-интерфейс (см. раздел «Доступ и аутентификация»).
- Откройте вкладку «Обзор» — сводное состояние всех компонентов платформы (серверное ядро, служебные сервисы, драйверы связи). Статусы обновляются с небольшим интервалом опроса (порядка секунд), поэтому сводка близка к реальному времени.
- Просмотрите список: по каждому компоненту видно, запущен ли он и находится ли в норме.
- Если все компоненты в норме — платформа здорова, дальнейших действий не требуется.
- Если какой-то компонент не в норме — откройте его логи (вкладка «Логи») и посмотрите сообщения об ошибках и обстоятельства их появления (см. Где смотреть проблемы и логи).
- При подозрении на проблему окружения (СУБД, сеть) откройте вкладку углублённой диагностики соответствующей подсистемы — «PostgreSQL», «Сеть» или «Система», — чтобы отличить проблему платформы от проблемы окружения.
Проверка: на вкладке «Обзор» видно состояние каждого компонента, а по компоненту не в норме определено, платформенная это проблема или проблема окружения, и какую подсистему чинить.
Разделы веб-интерфейса¶
Веб-интерфейс Супервизора разбит на вкладки; каждая отвечает за свою область диагностики:
- Обзор — сводное состояние всех компонентов платформы, быстрый взгляд «всё ли в норме».
- Процессы — работающие процессы компонентов платформы и их показатели.
- Логи — просмотр логов компонентов в одном месте.
- PostgreSQL — диагностика СУБД PostgreSQL, лежащей в основе хранилища конфигурации, трендов и журналов.
- Сеть — сетевая диагностика (доступность узлов, соединения между компонентами).
- Система — события и состояние операционной системы узла.
- Резервные копии — создание и восстановление копий, расписания с хранением (см. Резервное копирование и восстановление).
Просмотр логов¶
Вкладка логов сводит журналы компонентов в одном месте, чтобы не собирать их по узлам вручную. Логи используют при разборе проблем: когда компонент в Обзоре не в норме или поведение платформы вызывает вопросы, начинают с его логов — там видно сообщения об ошибках и обстоятельства их появления. Супервизор способен транслировать логи в реальном времени, так что можно наблюдать за компонентом в момент возникновения проблемы.
Где смотреть проблемы и логи¶
Предусловия: вы вошли в веб-интерфейс Супервизора.
- Откройте вкладку «Обзор»: она подсвечивает компоненты не в норме — это первичный указатель, где искать проблему.
- Откройте вкладку «Логи» — она сводит журналы всех компонентов в одном месте, не нужно собирать их по узлам вручную.
- Отфильтруйте логи по проблемному компоненту (и, если возможно, по времени возникновения сбоя), чтобы отсечь лишнее.
- Прочитайте сообщения об ошибках и обстоятельства их появления. При необходимости включите трансляцию логов в реальном времени и воспроизведите проблему, наблюдая за компонентом в момент сбоя.
- Если ошибка указывает на окружение (СУБД, сеть, ОС) — откройте соответствующую вкладку углублённой диагностики: «PostgreSQL», «Сеть» или «Система».
- Если сообщение содержит код ошибки платформы вида
AGS-XXXX— сверьтесь со справочником Коды ошибок.
Проверка: в логах найдена запись, объясняющая проблему, и по ней понятно, какой компонент или подсистему нужно чинить.
Углублённая диагностика¶
Помимо статуса «запущен / не запущен», Супервизор проводит более глубокие проверки ключевых подсистем, помогающие отличить проблему самой платформы от проблемы окружения:
- База данных (PostgreSQL) — доступность и состояние СУБД, на которой держатся конфигурация, тренды и журналы.
- Сеть — доступность узлов и соединений между компонентами.
- Процессы и целостность — что реально запущено на узле, нет ли отклонений.
- События операционной системы — системные события узла, влияющие на работу платформы.
Результаты этих проверок направляют устранение неполадок в нужную сторону: если сбоит СУБД или сеть, платформа не виновата, и чинить нужно окружение — см. Устранение неполадок.
Управление службами¶
Супервизор умеет запускать, останавливать и перезапускать службы платформы прямо из интерфейса. Это удобно при обновлении компонентов и при устранении неполадок, когда службу нужно перезапустить, — без ручного захода на узел.
Управление службами требует, чтобы Супервизор был запущен с достаточными правами в операционной системе (правами на управление службами ОС). Без таких прав диагностика и просмотр остаются доступны, а команды start/stop/restart — нет.
Управление службами — операция с последствиями
Остановка или перезапуск службы прерывает её работу: платформа или её часть на время становятся недоступны. Выполняйте управление службами осознанно и вне критичных окон эксплуатации. Помните, что серверное ядро выходит в готовность не мгновенно — после перезапуска дождитесь его полной инициализации, прежде чем считать операцию завершённой (см. Развёртывание и обновление).
Как перезапустить службу компонента¶
Предусловия: Супервизор запущен с достаточными правами в ОС (правами на управление службами) — иначе команды start/stop/restart недоступны, останутся только диагностика и просмотр. Операцию выполняйте вне критичного окна эксплуатации: перезапуск на время делает компонент недоступным.
- Откройте вкладку «Обзор» и найдите нужный компонент; определите по нему службу для перезапуска.
- Убедитесь, что команды управления службами доступны (кнопки start/stop/restart активны). Если они недоступны — Супервизор запущен без прав на управление службами ОС; запустите его с достаточными правами.
- Выполните перезапуск нужной службы.
- Дождитесь, пока служба поднимется. Для серверного ядра учтите, что оно выходит в готовность не мгновенно (инициализация может занять до полутора-двух минут, тем дольше, чем крупнее проект и объём истории) — не перезапускайте службу повторно, пока идёт инициализация.
Проверка: на вкладке «Обзор» компонент вернулся в норму, а в его логах нет новых ошибок. Для серверного ядра дождитесь полной готовности, прежде чем подключать клиентов.
Доступ и аутентификация¶
Веб-интерфейс Супервизора защищён учётной записью — логином и паролем. Доступ возможен как через браузер, так и из встроенного окна в десктоп-клиенте.
- При первом входе используются заводские учётные данные, которые следует сменить сразу — иначе инструмент останется доступен со значениями по умолчанию.
- Логин и пароль меняются в самом интерфейсе Супервизора (пункт смены учётных данных позволяет изменить логин и/или пароль). После смены заводского пароля предупреждение о дефолтных учётных данных перестаёт показываться.
- После входа действует сессия ограниченного срока; по истечении требуется повторный вход. Для машинных клиентов (встроенное окно клиента) вход выполняется автоматически по сохранённым учётным данным.
Смените заводские учётные данные
Оставленные по умолчанию логин и пароль Супервизора — прямой риск: инструмент позволяет перезапускать службы, а также создавать и восстанавливать резервные копии данных платформы. Меняйте их при первичной настройке.
Встраивание в клиент и доступ ИИ-ассистента¶
Тот же веб-интерфейс Супервизора встраивается в десктоп-клиент ГАУС отдельным окном, так что диагностику можно смотреть, не выходя из клиента. Чтобы это работало, в настройках клиента (раздел настроек Супервизора) задают адрес Супервизора и учётные данные для доступа к нему; клиент открывает встроенное окно уже авторизованным.
Кроме того, встроенный ИИ-ассистент может читать диагностику (сводку состояния, проблемы, состояние компонентов, логи, статус резервных копий) и — при наличии прав — управлять службами (перезапуск) через Супервизор. Права ИИ ограничены: операции чтения диагностики доступны при праве на чтение, а управляющие действия (перезапуск служб) — только при праве на изменение. ИИ не может сделать через Супервизор больше, чем разрешено учётной записи, от имени которой он работает.
Согласованность версий
Супервизор и его клиентская часть должны быть совместимы по версии. Обновляйте их согласованно: старая клиентская часть может не суметь обратиться к обновлённому Супервизору (см. раздел «Согласованность версий» на странице Развёртывание и обновление).
О разграничении прав ИИ-ассистента см. ГАУС Copilot и Безопасность.
Резервное копирование¶
Модуль резервного копирования — часть Супервизора (вкладка «Резервные копии»): создание и восстановление копий по категориям данных, расписания с политикой хранения. Он вынесен на отдельную страницу — Резервное копирование и восстановление.
Типовые сценарии¶
- «Что-то не работает» — с чего начать. Откройте вкладку «Обзор»: если компонент не в норме — перейдите к его логам, затем к углублённой диагностике его подсистемы (СУБД, сеть). Так вы отделите проблему платформы от проблемы окружения.
- Перезапуск зависшей службы. На вкладке управления перезапустите нужную службу; для серверного ядра дождитесь полной готовности, прежде чем подключать клиентов.
- Проверка после обновления. После замены компонента убедитесь по «Обзору», что все компоненты в норме и в логах нет новых ошибок (см. Развёртывание и обновление).
Частые вопросы и подводные камни¶
- Команды start/stop/restart недоступны (только чтение). Супервизор запущен без прав на управление службами ОС. Диагностика при этом работает, управление — нет.
- Встроенное окно в клиенте не подключается. Проверьте, что в настройках клиента заданы верные адрес и учётные данные Супервизора и что версии Супервизора и клиента совместимы.
- ИИ-ассистент не может перезапустить службу. У учётной записи, от имени которой работает ИИ, нет права на изменение — это ограничение модели прав, а не ошибка.
Связанные страницы¶
- Резервное копирование и восстановление — Резервное копирование и восстановление.
- Развёртывание и обновление компонентов — Развёртывание и обновление.
- Безопасность и права ИИ-ассистента — Безопасность.
- Устранение неполадок — Устранение неполадок.
- Коды ошибок платформы — Коды ошибок.