Improve upgrade docs

2 files changed, 24 insertions, 5 deletions

diff --git a/ydb/docs/ru/core/administration/upgrade.md b/ydb/docs/ru/core/administration/upgrade.md
index 94821621fdd..dda97bfa1c7 100644
--- a/ydb/docs/ru/core/administration/upgrade.md
+++ b/ydb/docs/ru/core/administration/upgrade.md
@@ -2,14 +2,18 @@
 
 {{ ydb-short-name }} распределенная система, поддерживающая плавное обновление (rolling restart) без даунтайма и деградации производительности.
 
-## Порядок обновления {#upgrade_order}
+## Порядок обновления {#upgrade-order}
 
-Базовым сценарием является последовательное обновление:
+Базовым сценарием является обновление исполняемого файла и последовательный рестарт каждого узла:
 
-1. Обновление storage-узлов.
-2. Обновление динамических узлов.
+1. Обновление и рестарт storage узлов;
+2. Обновление и рестар динамических узлов.
 
-Процесс остановки и запуска описан на странице [Безопасные рестарт и выключение узлов](../maintenance/manual/node_restarting.md). Узлы {{ ydb-short-name }} следует обновлять последовательно по одному, после каждого шага контролировать состояние кластера через [{{ ydb-short-name }} Monitoring](../maintenance/embedded_monitoring/ydb_monitoring.md).
+Процесс остановки и запуска описан на странице [Безопасные рестарт и выключение узлов](../maintenance/manual/node_restarting.md). 
+Узлы {{ ydb-short-name }} следует обновлять последовательно по одному, после каждого шага контролировать состояние кластера через [{{ ydb-short-name }} Monitoring](../maintenance/embedded_monitoring/ydb_monitoring.md) - на вкладке `Storage` не должно быть пулов в состоянии `Degraded` (как на примере ниже). В противном случае обновление необходимо остановить.
+
+
+![Monitoring_storage_state](../maintenance/embedded_monitoring/_assets/monitoring_storage_state.png)
 
 ## Совместимость версий {#version-compatability}
 
@@ -21,3 +25,18 @@
 * X.Y.* → X.Y-2.* — обновление невозможно, мажорные версии непоследовательны.
 
 Список доступных версий можно получить на [странице загрузки](https://ydb.tech/ru/docs/downloads/).
+
+{% note info %}
+
+**Примеры совместимых версий:**
+
+v.22.2.5	->	v.22.2.47 - обновление возможно
+v.22.2.47	->	v.22.4.21 - обновление возможно 
+v.22.2.40	->	v.22.4.21 - обновление невозможно, необходимо сначала обновиться до последней версии (v.22.2.47)
+v.22.2.47	->	v.22.5.5 - обновление невозможно, необходимо обновиться до следующей мажорной версии v.22.4.*
+
+{% endnote %}
+
+## Проверка результата обновления {#upgrade_check}
+
+Проверить версии узлов после обновления можно на странице `Nodes` мониторинга.
diff --git a/ydb/docs/ru/core/maintenance/embedded_monitoring/_assets/monitoring_storage_state.png b/ydb/docs/ru/core/maintenance/embedded_monitoring/_assets/monitoring_storage_state.png
new file mode 100644
index 00000000000..8ab2d020e13
--- /dev/null
+++ b/ydb/docs/ru/core/maintenance/embedded_monitoring/_assets/monitoring_storage_state.png