aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDaniil Cherednik <dcherednik@yandex-team.ru>2022-03-11 14:53:31 +0300
committerDaniil Cherednik <dcherednik@yandex-team.ru>2022-03-11 14:53:31 +0300
commit4e88d9ba201a15fa209d034b3a99bf1a0567e912 (patch)
treed500bdde1385fd448aa03135e1b15b919e2b780e
parentea69f517857d29b00e225e5d58c6115cc224bdc8 (diff)
downloadydb-4e88d9ba201a15fa209d034b3a99bf1a0567e912.tar.gz
Change "timeouts.md"
ref:97d916b3ae443f4b522097bcdb35ddb587ce3671
-rw-r--r--ydb/docs/ru/core/best_practices/_includes/timeouts.md9
1 files changed, 8 insertions, 1 deletions
diff --git a/ydb/docs/ru/core/best_practices/_includes/timeouts.md b/ydb/docs/ru/core/best_practices/_includes/timeouts.md
index adb0fd70bc..34fb5cfa95 100644
--- a/ydb/docs/ru/core/best_practices/_includes/timeouts.md
+++ b/ydb/docs/ru/core/best_practices/_includes/timeouts.md
@@ -5,6 +5,13 @@ description: 'Значение operation_timeout определяет время
В разделе приведено описание доступных таймаутов и представлены примеры использования на различных языках программирования.
+## Предпосылки к использованию таймаутов
+Механизм тайматов в ydb призван решить следующие проблемы
+1) Не дать запросу выполнятся так долго, что результат запроса становится не интересен для дальнейшего использования.
+2) Обнаружение проблем сетевой связаности
+
+Оба этих случая важны для обеспечения отказоустойчивости системы в целом. Рассмотрим таймауты подробнее.
+
## Таймаут на операцию
Значение ``operation_timeout`` определяет время, в течение которого результат запроса интересен пользователю. Если за данное время операция не выполнилась, сервер возвращает ошибку c кодом ``Timeout`` и попытается прекратить выполнение запроса, однако отмена запроса не гарантируется. Таким образом, запрос, на который пользователю была возвращена ошибка ``Timeout``, может быть как успешно выполнен на сервере, так и отменен.
@@ -15,7 +22,7 @@ description: 'Значение operation_timeout определяет время
## Транспортный таймаут
-На каждый запрос клиент может выставить транспортный таймаут. Данное значение позволяет определить количество времени, которое клиент готов ждать ответа от сервера. Если за данное время сервер не ответил, то клиенту будет возвращена транспортная ошибка c кодом ``DeadlineExceeded``.
+На каждый запрос клиент должен выставить транспортный таймаут. Данное значение позволяет определить количество времени, которое клиент готов ждать ответа от сервера. Если за данное время сервер не ответил, то клиенту будет возвращена транспортная ошибка c кодом ``DeadlineExceeded``. Важно выставить такое значение клиентского таймаута чтоб при нормальной работе приложения и сети транспортные таймауты не срабатывали.
## Применение таймаутов