Перейти к содержанию

Диагностика и Супервизор

Страница описывает инструмент надзора за SCADA/BMS-платформа ГАУС — Супервизор. Он наблюдает за состоянием компонентов платформы, показывает их логи, проводит углублённую диагностику (база данных, сеть, процессы, события ОС), позволяет управлять службами (запуск, остановка, перезапуск) и выполняет резервное копирование. Супервизор — отдельная утилита с веб-интерфейсом; тот же интерфейс встраивается в десктоп-клиент ГАУС отдельным окном и доступен встроенному ИИ-ассистенту.

Назначение Супервизора

Платформа состоит из нескольких самостоятельных компонентов (серверное ядро, служебные сервисы, драйверы связи, СУБД), которые могут работать на разных узлах. Супервизор даёт единую точку наблюдения и управления всеми компонентами платформы: в одном месте видно, что запущено и здорово, где возникают ошибки, что пишут логи и как ведут себя база данных и сеть. Отсюда же можно перезапускать службы и выполнять резервное копирование, не заходя на каждый узел вручную.

Супервизор рассчитан на работу поверх любой установки платформы: он распознаёт компоненты автоматически. Так один инструмент обслуживает объекты платформы ГАУС.

Мониторинг компонентов

Супервизор отслеживает состояние большого числа компонентов платформы (ядро, служебные сервисы, драйверы) и обновляет статусы с небольшим интервалом опроса (порядка секунд), поэтому сводка отражает состояние, близкое к реальному времени.

По каждому компоненту видно, запущен ли он и находится ли в нормальном состоянии. Компонент не в норме — сигнал разобраться: посмотреть логи этого компонента и углублённую диагностику соответствующей подсистемы (см. ниже).

Как проверить состояние компонентов платформы

Предусловия: Супервизор запущен и вы вошли в его веб-интерфейс (см. раздел «Доступ и аутентификация»).

  1. Откройте вкладку «Обзор» — сводное состояние всех компонентов платформы (серверное ядро, служебные сервисы, драйверы связи). Статусы обновляются с небольшим интервалом опроса (порядка секунд), поэтому сводка близка к реальному времени.
  2. Просмотрите список: по каждому компоненту видно, запущен ли он и находится ли в норме.
  3. Если все компоненты в норме — платформа здорова, дальнейших действий не требуется.
  4. Если какой-то компонент не в норме — откройте его логи (вкладка «Логи») и посмотрите сообщения об ошибках и обстоятельства их появления (см. Где смотреть проблемы и логи).
  5. При подозрении на проблему окружения (СУБД, сеть) откройте вкладку углублённой диагностики соответствующей подсистемы — «PostgreSQL», «Сеть» или «Система», — чтобы отличить проблему платформы от проблемы окружения.

Проверка: на вкладке «Обзор» видно состояние каждого компонента, а по компоненту не в норме определено, платформенная это проблема или проблема окружения, и какую подсистему чинить.

Разделы веб-интерфейса

Веб-интерфейс Супервизора разбит на вкладки; каждая отвечает за свою область диагностики:

  • Обзор — сводное состояние всех компонентов платформы, быстрый взгляд «всё ли в норме».
  • Процессы — работающие процессы компонентов платформы и их показатели.
  • Логи — просмотр логов компонентов в одном месте.
  • PostgreSQL — диагностика СУБД PostgreSQL, лежащей в основе хранилища конфигурации, трендов и журналов.
  • Сеть — сетевая диагностика (доступность узлов, соединения между компонентами).
  • Система — события и состояние операционной системы узла.
  • Резервные копии — создание и восстановление копий, расписания с хранением (см. Резервное копирование и восстановление).

Просмотр логов

Вкладка логов сводит журналы компонентов в одном месте, чтобы не собирать их по узлам вручную. Логи используют при разборе проблем: когда компонент в Обзоре не в норме или поведение платформы вызывает вопросы, начинают с его логов — там видно сообщения об ошибках и обстоятельства их появления. Супервизор способен транслировать логи в реальном времени, так что можно наблюдать за компонентом в момент возникновения проблемы.

Где смотреть проблемы и логи

Предусловия: вы вошли в веб-интерфейс Супервизора.

  1. Откройте вкладку «Обзор»: она подсвечивает компоненты не в норме — это первичный указатель, где искать проблему.
  2. Откройте вкладку «Логи» — она сводит журналы всех компонентов в одном месте, не нужно собирать их по узлам вручную.
  3. Отфильтруйте логи по проблемному компоненту (и, если возможно, по времени возникновения сбоя), чтобы отсечь лишнее.
  4. Прочитайте сообщения об ошибках и обстоятельства их появления. При необходимости включите трансляцию логов в реальном времени и воспроизведите проблему, наблюдая за компонентом в момент сбоя.
  5. Если ошибка указывает на окружение (СУБД, сеть, ОС) — откройте соответствующую вкладку углублённой диагностики: «PostgreSQL», «Сеть» или «Система».
  6. Если сообщение содержит код ошибки платформы вида AGS-XXXX — сверьтесь со справочником Коды ошибок.

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

Углублённая диагностика

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

  • База данных (PostgreSQL) — доступность и состояние СУБД, на которой держатся конфигурация, тренды и журналы.
  • Сеть — доступность узлов и соединений между компонентами.
  • Процессы и целостность — что реально запущено на узле, нет ли отклонений.
  • События операционной системы — системные события узла, влияющие на работу платформы.

Результаты этих проверок направляют устранение неполадок в нужную сторону: если сбоит СУБД или сеть, платформа не виновата, и чинить нужно окружение — см. Устранение неполадок.

Управление службами

Супервизор умеет запускать, останавливать и перезапускать службы платформы прямо из интерфейса. Это удобно при обновлении компонентов и при устранении неполадок, когда службу нужно перезапустить, — без ручного захода на узел.

Управление службами требует, чтобы Супервизор был запущен с достаточными правами в операционной системе (правами на управление службами ОС). Без таких прав диагностика и просмотр остаются доступны, а команды start/stop/restart — нет.

Управление службами — операция с последствиями

Остановка или перезапуск службы прерывает её работу: платформа или её часть на время становятся недоступны. Выполняйте управление службами осознанно и вне критичных окон эксплуатации. Помните, что серверное ядро выходит в готовность не мгновенно — после перезапуска дождитесь его полной инициализации, прежде чем считать операцию завершённой (см. Развёртывание и обновление).

Как перезапустить службу компонента

Предусловия: Супервизор запущен с достаточными правами в ОС (правами на управление службами) — иначе команды start/stop/restart недоступны, останутся только диагностика и просмотр. Операцию выполняйте вне критичного окна эксплуатации: перезапуск на время делает компонент недоступным.

  1. Откройте вкладку «Обзор» и найдите нужный компонент; определите по нему службу для перезапуска.
  2. Убедитесь, что команды управления службами доступны (кнопки start/stop/restart активны). Если они недоступны — Супервизор запущен без прав на управление службами ОС; запустите его с достаточными правами.
  3. Выполните перезапуск нужной службы.
  4. Дождитесь, пока служба поднимется. Для серверного ядра учтите, что оно выходит в готовность не мгновенно (инициализация может занять до полутора-двух минут, тем дольше, чем крупнее проект и объём истории) — не перезапускайте службу повторно, пока идёт инициализация.

Проверка: на вкладке «Обзор» компонент вернулся в норму, а в его логах нет новых ошибок. Для серверного ядра дождитесь полной готовности, прежде чем подключать клиентов.

Доступ и аутентификация

Веб-интерфейс Супервизора защищён учётной записью — логином и паролем. Доступ возможен как через браузер, так и из встроенного окна в десктоп-клиенте.

  • При первом входе используются заводские учётные данные, которые следует сменить сразу — иначе инструмент останется доступен со значениями по умолчанию.
  • Логин и пароль меняются в самом интерфейсе Супервизора (пункт смены учётных данных позволяет изменить логин и/или пароль). После смены заводского пароля предупреждение о дефолтных учётных данных перестаёт показываться.
  • После входа действует сессия ограниченного срока; по истечении требуется повторный вход. Для машинных клиентов (встроенное окно клиента) вход выполняется автоматически по сохранённым учётным данным.

Смените заводские учётные данные

Оставленные по умолчанию логин и пароль Супервизора — прямой риск: инструмент позволяет перезапускать службы, а также создавать и восстанавливать резервные копии данных платформы. Меняйте их при первичной настройке.

Встраивание в клиент и доступ ИИ-ассистента

Тот же веб-интерфейс Супервизора встраивается в десктоп-клиент ГАУС отдельным окном, так что диагностику можно смотреть, не выходя из клиента. Чтобы это работало, в настройках клиента (раздел настроек Супервизора) задают адрес Супервизора и учётные данные для доступа к нему; клиент открывает встроенное окно уже авторизованным.

Кроме того, встроенный ИИ-ассистент может читать диагностику (сводку состояния, проблемы, состояние компонентов, логи, статус резервных копий) и — при наличии прав — управлять службами (перезапуск) через Супервизор. Права ИИ ограничены: операции чтения диагностики доступны при праве на чтение, а управляющие действия (перезапуск служб) — только при праве на изменение. ИИ не может сделать через Супервизор больше, чем разрешено учётной записи, от имени которой он работает.

Согласованность версий

Супервизор и его клиентская часть должны быть совместимы по версии. Обновляйте их согласованно: старая клиентская часть может не суметь обратиться к обновлённому Супервизору (см. раздел «Согласованность версий» на странице Развёртывание и обновление).

О разграничении прав ИИ-ассистента см. ГАУС Copilot и Безопасность.

Резервное копирование

Модуль резервного копирования — часть Супервизора (вкладка «Резервные копии»): создание и восстановление копий по категориям данных, расписания с политикой хранения. Он вынесен на отдельную страницу — Резервное копирование и восстановление.

Типовые сценарии

  • «Что-то не работает» — с чего начать. Откройте вкладку «Обзор»: если компонент не в норме — перейдите к его логам, затем к углублённой диагностике его подсистемы (СУБД, сеть). Так вы отделите проблему платформы от проблемы окружения.
  • Перезапуск зависшей службы. На вкладке управления перезапустите нужную службу; для серверного ядра дождитесь полной готовности, прежде чем подключать клиентов.
  • Проверка после обновления. После замены компонента убедитесь по «Обзору», что все компоненты в норме и в логах нет новых ошибок (см. Развёртывание и обновление).

Частые вопросы и подводные камни

  • Команды start/stop/restart недоступны (только чтение). Супервизор запущен без прав на управление службами ОС. Диагностика при этом работает, управление — нет.
  • Встроенное окно в клиенте не подключается. Проверьте, что в настройках клиента заданы верные адрес и учётные данные Супервизора и что версии Супервизора и клиента совместимы.
  • ИИ-ассистент не может перезапустить службу. У учётной записи, от имени которой работает ИИ, нет права на изменение — это ограничение модели прав, а не ошибка.

Связанные страницы