Обновление подсистемы мониторинга

В этой инструкции рассматривается обновление сервера подсистемы мониторинга с версии 1.12 до версии 1.12.1.

Инструкция применима только для случая, когда подсистема мониторинга развёрнута на одном узле в составе Геном.

Обновление распространяется в виде архива vision-distrib-1.12.1-1402.tar.gz.

Подготовка к обновлению

Перед обновлением:

  • создайте резервные копии конфигурационных файлов, в которые вручную вносили изменения, например, параметры интеграции со сторонними системами и настройки NGINX;

  • убедитесь, что на установочном узле подсистемы мониторинга подключены и доступны репозитории пакетов.

Удаление агентов и плагинов

Удалите с узлов все установленные агенты и плагины, используя графический интерфейс подсистемы мониторинга:

  1. На панели навигации выберите Объекты.

  2. На панели Контур выберите нужный ПАК.

  3. Удалите агенты метрик и агенты логов.

    1. Выберите соответствующую вкладку Агенты метрик.

    2. В строках со статусом, отличающимся от НЕ УСТАНОВЛЕН, нажмите кнопку ⋮ и в открывшемся меню выберите Деинсталлировать.

    3. Подтвердите удаление агента.

  4. Удалите плагины с узлов.

    1. Выберите вкладку Плагины.

    2. Выберите все записи.

    3. Нажмите кнопку Операции.

    4. В открывшемся меню выберите Деинсталлировать.

    5. Подтвердите удаление.

Обновление сервера

Чтобы обновить компоненты сервера подсистемы мониторинга:

  1. Загрузите архив vision-distrib-1.12.1-1402.tar.gz на установочный узел подсистемы мониторинга.

  2. Распакуйте архив:

    tar -xzf vision-distrib-1.12.1-1402.tar.gz

  3. Перейдите в директорию с файлами дистрибутива:

    cd vision-distrib-1.12.1-1402/

  4. Запустите установку зависимостей:

    • Из репозиториев ОС (рекомендуется):

      ./setup.sh -g

    • Из состав дистрибутива:

      ./setup.sh -p

  5. Если установка зависимостей прошла успешно, запустите обновление:

    ./setup.sh -u

  6. Проверьте корректность обновления:

    1. Запустите скрипт setup.sh для работы в интерактивном режиме:

      ./setup.sh

    2. Выберите пункт Проверка работы сервисов.

      Обновление считается успешным, если все службы находятся в статусе active.

    3. В веб-интерфейсе подсистемы мониторинга на панели навигации выберите Прочее  О программе.

      Убедитесь, что версия подсистемы мониторинга — 1.12.1-1402.

Обновление plagent

Чтобы обновить plagent:

  1. В веб-интерфейсе подсистемы мониторинга на панели навигации выберите Объекты.

  2. На панели Контур в строке с нужным ПАК нажмите кнопку ⋮ и в открывшемся меню выберите Инвентори.

  3. Сохраните файл инвентаря на свой компьютер.

  4. Укажите в файле инвентаря учётные данные для подключения к узлам.

  5. Загрузите файл инвентаря на установочный узел подсистемы мониторинга.

  6. Перейдите в директорию дистрибутива и запустите скрипт setup.sh в интерактивном режиме.

  7. Выберите пункт Установка plagent.

  8. Укажите путь к файлу инвентаря.

  9. После успешного выполнения установки plagent удалите файл инвентаря.

Ручная настройка параметров мониторинга

Новые компоненты сервера устанавливаются с настройками по умолчанию.

Установщик не обновляет настройки уже существующих компонентов, за исключением NGINX. Его настройки заменяются на эталонные.

Чтобы компоненты корректно работали в новой версии подсистемы мониторинга:

  1. Сравните действующую и эталонную конфигурации компонента.

  2. Если в действующей конфигурации отсутствуют какие-либо параметры, добавьте их.

  3. Если в действующей конфигурации не хватает файлов, скопируйте их из эталонной конфигурации.

    Не заменяйте существующие конфигурационные файлы на эталонные! В этом случае все настройки, сделанные вручную, будут утеряны!

Использование утилиты diff для поиска различий

Для поиска различий в содержимом двух файлов используйте утилиту diff, например:

diff -ry file1 file2

Чтобы улучшить читаемость вывода, добавьте дополнительные параметры:

diff -ry -W 200 --left-column file1 file2

Здесь:

  • -W 200 — увеличение ограничения на количество знаков в строке до 200 (по умолчанию — 130);

  • --left-column — вывод только левой колонки общих строк.

Конфигурационные файлы

Если указан путь к директории, проверьте всё её содержимое.

Для файлов, не указанных ниже, действующая конфигурация генерируется автоматически при запуске скрипта /opt/skala-r/vision/tools/update_server_configs.sh. В качестве источника значений используется файл /opt/skala-r/etc/vision/server/vision_core/config.yml или файл, специфичный для службы.

PostgreSQL

Пути к действующим конфигурационным файлам PostgreSQL зависят от используемого дистрибутива ОС и версии СУБД.

  • РЕД ОС:

    • PostgreSQL 12:

      • /var/lib/pgsql/data/postgresql.conf;

      • /var/lib/pgsql/data/pg_hba.conf.

    • PostgreSQL 16:

      • /var/lib/pgsql/16/data/postgresql.conf;

      • /var/lib/psgsql/16/data/pg_hba.conf.

    • Postgres Pro 16:

      • /var/lib/pgpro/std-16/data/postgresql.conf;

      • /var/lib/pgpro/std-16/data/pg_hba.conf.

  • ALT Linux:

    • PostgreSQL:

      • /var/lib/pgsql/data/postgresql.conf;

      • /var/lib/pgsql/data/pg_hba.conf;

    • Postgres Pro 16:

      • /var/lib/pgpro/std-16/data/postgresql.conf;

      • /var/lib/pgpro/std-16/data/pg_hba.conf.

  • Astra Linux Special Edition:

    • /etc/postgresql/11/main/postgresql.conf;

    • /etc/postgresql/11/main/pg_hba.conf.

Эталонная конфигурация:

  • /opt/skala-r/vision/server/default/postgresql/<version>/postgresql.conf;

  • /opt/skala-r/vision/server/default/postgresql/<version>/pg_hba.conf.

vision_core

Действующая конфигурация: /opt/skala-r/etc/vision/server/vision_core/.

Эталонная конфигурация: /opt/skala-r/vision/server/default/server/vision_core/.

Grafana

Действующая конфигурация: /opt/skala-r/etc/vision/server/grafana/.

Эталонная конфигурация: /opt/skala-r/vision/server/default/server/grafana/.

VictoriaLogs

Действующая конфигурация: /opt/skala-r/etc/vision/server/victorialogs/.

Эталонная конфигурация: /opt/skala-r/vision/server/default/server/victorialogs/.

Применение изменений

Примените сделанные изменения:

  1. Запустите скрипт обновления настроек:

    /opt/skala-r/vision/tools/update_server_configs.sh

  2. Сравните действующую и эталонную конфигурацию vision_core:

    Действующая конфигурация: /opt/skala-r/etc/vision/server/vision_core/config.yml.

    Эталонная конфигурация: /opt/skala-r/vision/server/default/server/vision_core/config.yml.

    Добавьте в действующую конфигурацию отсутствующие значения.

  3. Перезапустите службы, настройки которых изменяли.

Установка агентов и плагинов

  1. Установите заново агенты и плагины, используя графический интерфейс подсистемы мониторинга.

  2. Установите плагины self_alerting_scraper и self_backend_scraper, следуя инструкции Постановка на самомониторинг.