various fixes

docs/en/operations/utilities/clickhouse-benchmark.md

@@ -40,10 +40,10 @@ clickhouse-benchmark [keys] < queries_file;
 
 ## Keys {#clickhouse-benchmark-keys}
 
--   `--query=WORD` — Query to execute. If this parameter is not passed, `clickhouse-benchmark` will read queries from standard input. 
+-   `--query=QUERY` — Query to execute. If this parameter is not passed, `clickhouse-benchmark` will read queries from standard input. 
 -   `-c N`, `--concurrency=N` — Number of queries that `clickhouse-benchmark` sends simultaneously. Default value: 1.
 -   `-d N`, `--delay=N` — Interval in seconds between intermediate reports (to disable reports set 0). Default value: 1.
--   `-h WORD`, `--host=WORD` — Server host. Default value: `localhost`. For the [comparison mode](#clickhouse-benchmark-comparison-mode) you can use multiple `-h` keys.
+-   `-h HOST`, `--host=HOST` — Server host. Default value: `localhost`. For the [comparison mode](#clickhouse-benchmark-comparison-mode) you can use multiple `-h` keys.
 -   `-p N`, `--port=N` — Server port. Default value: 9000. For the [comparison mode](#clickhouse-benchmark-comparison-mode) you can use multiple `-p` keys.
 -   `-i N`, `--iterations=N` — Total number of queries. Default value: 0 (repeat forever).
 -   `-r`, `--randomize` — Random order of queries execution if there is more than one input query.

docs/ru/operations/utilities/clickhouse-benchmark.md

@@ -5,7 +5,7 @@ toc_title: clickhouse-benchmark
 
 # clickhouse-benchmark {#clickhouse-benchmark}
 
-Устанавливает соединение с сервером ClickHouse и неоднократно посылает указанные запросы.
+Устанавливает соединение с сервером ClickHouse и запускает циклическое выполнение указанных запросов.
 
 **Синтаксис**
 
@@ -25,7 +25,7 @@ $ echo "single query" | clickhouse-benchmark [keys]
 $ clickhouse-benchmark [keys] <<< "single query"
 ```
 
-Если нужно послать набор запросов, создайте текстовый файл и расположите каждый запрос на отдельной строке в файле. Например:
+Если нужно выполнить набор запросов, создайте текстовый файл и расположите каждый запрос на отдельной строке в файле. Например:
 
 ``` sql
 SELECT * FROM system.numbers LIMIT 10000000;
@@ -40,22 +40,22 @@ clickhouse-benchmark [keys] < queries_file;
 
 ## Ключи {#clickhouse-benchmark-keys}
 
--   `--query=WORD` — запрос для исполнения. Если параметр не передан, `clickhouse-benchmark` будет считывать запросы из стандартного ввода. 
+-   `--query=QUERY` — исполняемый запрос. Если параметр не передан, `clickhouse-benchmark` будет считывать запросы из стандартного ввода. 
 -   `-c N`, `--concurrency=N` — количество запросов, которые `clickhouse-benchmark` отправляет одновременно. Значение по умолчанию: 1.
--   `-d N`, `--delay=N` — интервал в секундах между промежуточными сообщениями (чтобы отключить сообщения, установите 0). Значение по умолчанию: 1.
--   `-h WORD`, `--host=WORD` — хост сервера. Значение по умолчанию: `localhost`. Для [сравнительного режима](#clickhouse-benchmark-comparison-mode) можно использовать несколько `-h` ключей. 
--   `-p N`, `--port=N` — порт сервера. Значение по умолчанию: 9000. Для [сравнительного режима](#clickhouse-benchmark-comparison-mode) можно использовать несколько `-p` ключей. 
+-   `-d N`, `--delay=N` — интервал в секундах между промежуточными отчетами (чтобы отключить отчеты, установите 0). Значение по умолчанию: 1.
+-   `-h HOST`, `--host=HOST` — хост сервера. Значение по умолчанию: `localhost`. Для [режима сравнения](#clickhouse-benchmark-comparison-mode) можно использовать несколько `-h` ключей. 
+-   `-p N`, `--port=N` — порт сервера. Значение по умолчанию: 9000. Для [режима сравнения](#clickhouse-benchmark-comparison-mode) можно использовать несколько `-p` ключей. 
 -   `-i N`, `--iterations=N` — общее число запросов. Значение по умолчанию: 0 (вечно будет повторяться).
--   `-r`, `--randomize` — случайный порядок выполнения запросов при наличии более одного входного запроса.
+-   `-r`, `--randomize` — использовать случайный порядок выполнения запросов при наличии более одного входного запроса.
 -   `-s`, `--secure` — используется `TLS` соединение.
 -   `-t N`, `--timelimit=N` — лимит по времени в секундах. `clickhouse-benchmark` перестает отправлять запросы при достижении лимита по времени. Значение по умолчанию: 0 (лимит отключен).
--   `--confidence=N` — уровень доверия для  T-критерия. Возможные значения: 0 (80%), 1 (90%), 2 (95%), 3 (98%), 4 (99%), 5 (99.5%). Значение по умолчанию: 5. В [сравнительном режиме](#clickhouse-benchmark-comparison-mode) `clickhouse-benchmark` проверяет [двухвыборочный  t-критерий Стьюдента для независимых выборок](https://en.wikipedia.org/wiki/Student%27s_t-test#Independent_two-sample_t-test) чтобы определить, различны ли две выборки при выбранном уровне доверия.
--   `--cumulative` — выводит совокупность данных, а не данные за интервал.
+-   `--confidence=N` — уровень доверия для  T-критерия. Возможные значения: 0 (80%), 1 (90%), 2 (95%), 3 (98%), 4 (99%), 5 (99.5%). Значение по умолчанию: 5. В [режиме сравнения](#clickhouse-benchmark-comparison-mode) `clickhouse-benchmark` проверяет [двухвыборочный  t-критерий Стьюдента для независимых выборок](https://en.wikipedia.org/wiki/Student%27s_t-test#Independent_two-sample_t-test) чтобы определить, различны ли две выборки при выбранном уровне доверия.
+-   `--cumulative` — выводить статистику за все время работы, а не за последний временной интервал.
 -   `--database=DATABASE_NAME` — имя базы данных ClickHouse. Значение по умолчанию: `default`. 
--   `--json=FILEPATH` — формат вывода `JSON`. Когда этот ключ указан, `clickhouse-benchmark` выводит сообщение в указанный JSON-файл.
+-   `--json=FILEPATH` — дополнительный вывод в формате `JSON`. Когда этот ключ указан, `clickhouse-benchmark` выводит отчет в указанный JSON-файл.
 -   `--user=USERNAME` — имя пользователя ClickHouse. Значение по умолчанию: `default`.
 -   `--password=PSWD` — пароль пользователя ClickHouse. Значение по умолчанию: пустая строка.
--   `--stacktrace` — вывод трассировки стека исключений.
+-   `--stacktrace` — вывод трассировки стека исключений. Когда этот ключ указан, `clickhouse-bencmark` выводит трассировку стека исключений.
 -   `--stage=WORD` — стадия обработки запроса на сервере. ClickHouse останавливает обработку запроса и возвращает ответ `clickhouse-benchmark` на заданной стадии. Возможные значения: `complete`, `fetch_columns`, `with_mergeable_state`. Значение по умолчанию: `complete`. 
 -   `--help` — показывает справку.
 
@@ -94,17 +94,17 @@ localhost:9000, queries 10, QPS: 6.772, RPS: 67904487.440, MiB/s: 518.070, resul
 
 -   Строка статуса, содержащая (в таком же порядке):
 
-    -   Конечная точка сервера ClickHouse.
+    -   Endpoint сервера ClickHouse.
     -   Число обработанных запросов.
     -   QPS: количество запросов, выполняемых сервером за секунду в течение `--delay` интервала.
     -   RPS: количество строк, читаемых сервером за секунду в течение `--delay` интервала.
     -   MiB/s: количество Мебибайтов, считываемых сервером за секунду в течение `--delay` интервала.
-    -   result RPS: количество столбцов, размещаемое сервером в результат запроса за секунду в течение `--delay` интервала.
+    -   result RPS: количество строк, добавленное сервером в результат запроса за секунду в течение `--delay` интервала.
     -   result MiB/s. количество Мебибайтов, размещаемое сервером в результат запроса за секунду в течение `--delay` интервала.
 
 -   Процентили времени выполнения запросов.
 
-## Сравнительный режим {#clickhouse-benchmark-comparison-mode}
+## Режим сравнения {#clickhouse-benchmark-comparison-mode}
 
 `clickhouse-benchmark` может сравнивать производительность двух работающих серверов ClickHouse.