При обновлении с KUMA 3.4 до 4.0.х следует определить, сколько места на диске занимают данные метрик и оценить, стоит ли переопределять значение параметра metrics_disk_request в файле инвентаря k0s.inventory.yml.
Чтобы оценить, сколько места на диске занимают данные метрик в KUMA 3.4:
На целевой машине запустите скрипт get_old_metrics_size.sh с файлом инвентаря k0s.inventory.yml:
sudo ./get_old_metrics_size_sh k0s.inventory.yml
Никаких изменений в существующую установку скрипт не вносит, в процессе работы скрипта выполняется подключение к мастер-контроллеру кластера для определения имени тома Ядра KUMA и к рабочим узлам кластера для определения размера директории внутри подключенного тома.
В результате будет выполнен поиск томов Ядра KUMA на рабочих узлах кластера и определён размер каталога victoria-metrics в них. Результат выполнения скрипта выводится на экран и сохраняется в журнале log/get_old_metrics_size-YYYYMMDD-HHMMSS.log. В журнале сохраняется сообщение следующего вида:
TASK [Print metrics folder size] ***********************************************
ok: [kuma-inst-06.avp.ru] => {}
MSG:
Found KUMA Core 3.4.1.53
Found old metrics folder size: 1Gi
Minimum metrics_data_size required to proceed: 3Gi (including 2Gi threshold)
В сообщении указаны следующие сведения:
Found KUMA Core — найденная версия Ядра KUMA. Found old metrics folder size — текущий размер директории victoria-metrics в ГБ.Minimum metrics_data_size required to proceed — минимально возможный размер тома метрик для миграции с версии 3.4.х. В этот размер заложен дополнительный запас свободного места в 2Gi. При необходимости вы можете отфильтровать вывод по строке Minimum metrics_data_size required to proceed.По результатам полученных данным вам необходимо определить необходимый размер тома сервиса Метрики в KUMA 4.0.x, в зависимости от ваших потребностей. Размер тома для сервиса Метрики не должен быть меньше значения Minimum metrics_data_size required to proceed.
Если при обновлении c версии 3.4.х до версии 4.0.х вы укажете в файле инвентаря k0s.inventory.yml размер тома меньше, чем в Minimum metrics_data_size required to proceed или используете значение параметра metrics_disk_request которое будет меньше значения Minimum metrics_data_size required to proceed, установщик прервет выполнение обновления с версии 3.4.х до версии 4.0.х на этапе валидации установки со следующим сообщением:
TASK [Check metrics volume size requirement] ***********************************
fatal: [kuma-inst-06.avp.ru]: FAILED! => {
"changed": false
}
MSG:
Current metrics folder size: 20Gi
Metrics disk request when low_resources=false: 10Gi
Metrics disk request when low_resources=true: 10Gi
Error: Available metric data exceeds specified volume size.
The available metric data (20Gi + 2Gi threshold) is too large.
Solution: Increase the metrics volume size by updating the metrics_disk_request variable in your inventory file.
В приведённом примере пользователь попытался задать размер тома 10Gi через переменную инвентаря metrics_disk_request, при этом текущий размер данных метрик на диске - 20Gi. В результате желаемое значение размера тома меньше, чем текущий размер данных + порог в 2Gi, поэтому выполнить обновление с 3.4.х невозможно. Установка будет прервана на шаге валидации, при этом никаких изменений в текущую установку не вносится. Можно безопасно выбрать подходящее значение размера тома для метрик, переопределить его в файле инвентаря и повторить попытку обновления.
В начало