Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

настройки сеанса log_queries_*

Эти настройки доступны в system.settings и автоматически генерируются из исходного кода.

log_queries

Тип
Bool
По умолчанию
1

Включает журналирование запросов.

Запросы, отправляемые в ClickHouse при включении этой настройки, записываются в соответствии с правилами, заданными в параметре конфигурации сервера query_log.

Пример:

log_queries=1

log_queries_cut_to_length

Тип
UInt64
По умолчанию
100000

Если длина запроса превышает указанный порог (в байтах), при записи в query log запрос обрезается. Также ограничивается длина запроса, выводимого в обычный текстовый журнал.

log_queries_min_query_duration_ms

Тип
Milliseconds
По умолчанию
0

Если включено (ненулевое значение), запросы, выполняющиеся быстрее значения этой настройки, не будут записываться в журнал (это можно рассматривать как long_query_time для MySQL Slow Query Log); по сути, это означает, что вы не найдете их в следующих таблицах:

  • system.query_log
  • system.query_thread_log

В журнал попадут только запросы следующих типов:

  • QUERY_FINISH

  • EXCEPTION_WHILE_PROCESSING

  • Тип: миллисекунды

  • Значение по умолчанию: 0 (любой запрос)

log_queries_min_type

Тип
LogQueriesType
По умолчанию
QUERY_START

Минимальный тип записи в query_log.

Возможные значения:

  • QUERY_START (=1)
  • QUERY_FINISH (=2)
  • EXCEPTION_BEFORE_START (=3)
  • EXCEPTION_WHILE_PROCESSING (=4)

Можно использовать, чтобы ограничить, какие сущности будут попадать в query_log; например, если вас интересуют только ошибки, используйте EXCEPTION_WHILE_PROCESSING:

log_queries_min_type='EXCEPTION_WHILE_PROCESSING'

log_queries_probability

Тип
Float
По умолчанию
1

Позволяет записывать в системные таблицы query_log, query_thread_log и query_views_log только часть запросов, случайным образом отобранных с указанной вероятностью. Это помогает снизить нагрузку при большом количестве запросов в секунду.

Возможные значения:

  • 0 — Запросы не записываются в системные таблицы.
  • Положительное число с плавающей точкой в диапазоне [0..1]. Например, если значение настройки равно 0.5, в системные таблицы записывается примерно половина запросов.
  • 1 — Все запросы записываются в системные таблицы.
Navigation