Обновление до v25.02

Процедура обновления на версию v25.02 не отличается от стандартной, но требует дополнительных действий:

  • выполнения миграций метрик;
  • (опционально) настройки распределения запросов на построение графиков;
  • (опционально) задания порогов регистрации инцидентов.

Процедура миграции метрик

  1. На всех экземплярах с ClickHouse скачать файл миграции.

    wget https://docs.mitigator.ru/master/kb/update2502/update2502.sql -O /srv/mitigator/update2502.sql
  2. Выполнить миграцию:

    docker-compose exec -T clickhouse clickhouse-client -mn < update2502.sql

    Сообщения печатаются только в случае ошибок. В этом случае текст сообщения нужно сообщить разработчикам.

  3. Перезапустите Carbon Clickhouse:

    docker-compose restart carbon-clickhouse

Миграция может занять продолжительное время. В этот промежуток времени защитные функции MITIGATOR полностью работоспособны, но не будут отображаться графики за прошлые периоды (текущие графики будут доступны).

Процедура настройки распределения запросов на построение графиков

В версии v25.02 добавлена возможность равномерного распределения запросов графиков по хранилищам метрик. Список серверов для чтения задаётся переменной CARBONAPI_BACKENDS сервиса carbonapi.

Для схемы по умолчанию (две ноды с хранилищами), достаточно

  • обновить файл docker-compose.failover.yml на нодах с хранилищем:

    wget https://docs.mitigator.ru/v25.02/dist/multi/docker-compose.failover.yml
  • обновить файл docker-compose.worker.failover.yml на нодах без хранилища:

    wget https://docs.mitigator.ru/v25.02/dist/multi/docker-compose.worker.failover.yml

Для схем с тремя и более отказоустойчивыми хранилищами необходимо добавить в файлы docker-compose.failover.yml и docker-compose.worker.failover.yml секцию с сервисом carbonapi и в переменной CARBONAPI_BACKENDS перечислить адреса всех нод с хранилищем:

carbonapi:
  environment:
    CARBONAPI_BACKENDS: "http://${SERVER1}:9090,http://${SERVER2}:9090,http://${SERVER3}:9090"

Пороги автодетектирования для регистрации инцидентов

При обновлении на v25.02 пороги Incidents. с нулевыми значениями будут удалены. Инциденты в политиках защиты без порогов Incidents. регистрироваться не будут. Рекомендуется проверить пороги для регистрации инцидентов в политиках защиты и задать требуемые значения, где это необходимо.