> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Системная таблица, содержащая информацию о потоках, выполняющих запросы, например, имя потока, время начала потока, длительность обработки запроса.

# system.query_thread_log

<Info>
  **Запросы в ClickHouse Cloud**

  Данные в этой системной таблице хранятся локально на каждом узле ClickHouse Cloud. Поэтому, чтобы получить полное представление обо всех данных, требуется функция `clusterAllReplicas`. Дополнительные сведения см. [здесь](/ru/reference/system-tables/overview#system-tables-in-clickhouse-cloud).
</Info>

<div id="description">
  ## Описание
</div>

Содержит сведения о потоках, выполняющих запросы, например имя потока, время его запуска и длительность обработки запроса.

Чтобы начать ведение журнала:

1. Настройте параметры в разделе [query\_thread\_log](/ru/reference/settings/server-settings/settings#query_thread_log).
2. Установите [log\_query\_threads](/ru/reference/settings/session-settings#log_query_threads) в 1.

Период сброса данных задается параметром `flush_interval_milliseconds` в разделе настройки сервера [query\_thread\_log](/ru/reference/settings/server-settings/settings#query_thread_log). Чтобы принудительно выполнить сброс, используйте запрос [SYSTEM FLUSH LOGS](/ru/reference/statements/system#flush-logs).

ClickHouse не удаляет данные из таблицы автоматически. Подробнее см. в разделе [Introduction](/ru/reference/system-tables/overview#system-tables-introduction).

Вы можете использовать настройку [log\_queries\_probability](/ru/reference/settings/session-settings#log_queries_probability)) чтобы уменьшить количество запросов, регистрируемых в таблице `query_thread_log`.

<div id="columns">
  ## Столбцы
</div>

* `hostname` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — Имя хоста сервера, выполняющего запрос.
* `event_date` ([Date](/ru/reference/data-types/date)) — Дата завершения выполнения запроса потоком.
* `event_time` ([DateTime](/ru/reference/data-types/datetime)) — дата и время завершения выполнения запроса потоком.
* `event_time_microseconds` ([DateTime64(6)](/ru/reference/data-types/datetime64)) — Дата и время завершения выполнения запроса потоком с точностью до микросекунд.
* `query_start_time` ([DateTime](/ru/reference/data-types/datetime)) — время начала выполнения запроса.
* `query_start_time_microseconds` ([DateTime64(6)](/ru/reference/data-types/datetime64)) — Время начала выполнения запроса с точностью до микросекунды.
* `query_duration_ms` ([UInt64](/ru/reference/data-types/int-uint)) — Продолжительность выполнения запроса.
* `read_rows` ([UInt64](/ru/reference/data-types/int-uint)) — Количество прочитанных строк.
* `read_bytes` ([UInt64](/ru/reference/data-types/int-uint)) — количество прочитанных байтов.
* `written_rows` ([UInt64](/ru/reference/data-types/int-uint)) — Для запросов INSERT — количество записанных строк. Для остальных запросов значение столбца равно 0.
* `written_bytes` ([UInt64](/ru/reference/data-types/int-uint)) — Для запросов INSERT — количество записанных байтов. Для других запросов значение столбца равно 0.
* `memory_usage` ([Int64](/ru/reference/data-types/int-uint)) — Разница между объёмом выделенной и освобождённой памяти в контексте данного потока.
* `peak_memory_usage` ([Int64](/ru/reference/data-types/int-uint)) — Максимальная разница между объёмом выделенной и освобождённой памяти в контексте данного потока.
* `thread_name` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — имя потока.
* `thread_id` ([UInt64](/ru/reference/data-types/int-uint)) — внутренний идентификатор потока.
* `master_thread_id` ([UInt64](/ru/reference/data-types/int-uint)) — исходный идентификатор первичного потока в ОС.
* `current_database` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — Имя текущей базы данных.
* `query` ([String](/ru/reference/data-types/string)) — строка запроса.
* `normalized_query_hash` ([UInt64](/ru/reference/data-types/int-uint)) — Хеш нормализованного запроса, из которого удалены константы и т. п.
* `is_initial_query` ([UInt8](/ru/reference/data-types/int-uint)) — Тип запроса. Возможные значения: 1 — запрос был инициирован клиентом, 0 — запрос был инициирован другим запросом в рамках выполнения распределённого запроса.
* `connection_address` ([IPv6](/ru/reference/data-types/ipv6)) — IP-адрес клиента, с которого установлено соединение. При подключении через прокси это будет адрес прокси-сервера.
* `connection_port` ([UInt16](/ru/reference/data-types/int-uint)) — Порт клиента, с которого установлено соединение. При подключении через прокси это будет порт прокси.
* `user` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — имя пользователя, инициировавшего текущий запрос.
* `query_id` ([String](/ru/reference/data-types/string)) — идентификатор запроса.
* `address` ([IPv6](/ru/reference/data-types/ipv6)) — IP-адрес, использованный для выполнения запроса. При подключении через прокси и включённом параметре `auth_use_forwarded_address` здесь будет указан адрес клиента, а не прокси.
* `port` ([UInt16](/ru/reference/data-types/int-uint)) — Порт клиента, который использовался для выполнения запроса. При подключении через прокси, если задано значение `auth_use_forwarded_address`, здесь будет указан порт клиента, а не прокси.
* `initial_user` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — Имя пользователя, выполнившего первоначальный запрос (для выполнения распределённого запроса).
* `initial_query_id` ([String](/ru/reference/data-types/string)) — идентификатор первоначального запроса (для выполнения распределённого запроса).
* `initial_address` ([IPv6](/ru/reference/data-types/ipv6)) — IP-адрес, с которого был запущен родительский запрос.
* `initial_port` ([UInt16](/ru/reference/data-types/int-uint)) — Клиентский порт, с которого был отправлен родительский запрос.
* `initial_query_start_time` ([DateTime](/ru/reference/data-types/datetime)) — Время начала выполнения первоначального запроса.
* `initial_query_start_time_microseconds` ([DateTime64(6)](/ru/reference/data-types/datetime64)) — Время начала выполнения исходного запроса
* `authenticated_user` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — Имя пользователя, прошедшего аутентификацию в этом сеансе.
* `interface` ([UInt8](/ru/reference/data-types/int-uint)) — Интерфейс, через который был инициирован запрос. Возможные значения: 1 — TCP, 2 — HTTP.
* `is_secure` ([UInt8](/ru/reference/data-types/int-uint)) — Флаг, указывающий, было ли соединение защищённым.
* `os_user` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — имя пользователя ОС, от имени которого запущен clickhouse-client.
* `client_hostname` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — имя хоста клиентской машины, на которой запущен clickhouse-client или другой клиент TCP.
* `client_name` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — имя clickhouse-client или другого TCP-клиента.
* `client_revision` ([UInt32](/ru/reference/data-types/int-uint)) — Версия clickhouse-client или другого TCP-клиента.
* `client_version_major` ([UInt32](/ru/reference/data-types/int-uint)) — Мажорная версия clickhouse-client или другого TCP-клиента.
* `client_version_minor` ([UInt32](/ru/reference/data-types/int-uint)) — Минорная версия `clickhouse-client` или другого клиента TCP.
* `client_version_patch` ([UInt32](/ru/reference/data-types/int-uint)) — Номер патча в версии clickhouse-client или другого TCP-клиента.
* `script_query_number` ([UInt32](/ru/reference/data-types/int-uint)) — Последовательный номер запроса в скрипте с несколькими запросами.
* `script_line_number` ([UInt32](/ru/reference/data-types/int-uint)) — Номер строки в скрипте из нескольких запросов, с которой начинается текущий запрос.
* `http_method` ([UInt8](/ru/reference/data-types/int-uint)) — HTTP-метод, которым был инициирован запрос. Возможные значения: 0 — запрос был выполнен через интерфейс TCP, 1 — использовался метод GET., 2 — использовался метод POST.
* `http_user_agent` ([LowCardinality(String)](/ru/reference/data-types/lowcardinality)) — заголовок User-Agent, переданный в HTTP-запросе.
* `http_referer` ([String](/ru/reference/data-types/string)) — HTTP-заголовок `Referer`, передаваемый в HTTP-запросе (содержит абсолютный или частичный адрес страницы, с которой выполняется запрос).
* `forwarded_for` ([String](/ru/reference/data-types/string)) — HTTP-заголовок `X-Forwarded-For`, передаваемый в HTTP-запросе.
* `quota_key` ([String](/ru/reference/data-types/string)) — 'ключ квоты', указанный в настройке quotas.
* `distributed_depth` ([UInt64](/ru/reference/data-types/int-uint)) — Сколько раз запрос перенаправлялся между серверами.
* `revision` ([UInt32](/ru/reference/data-types/int-uint)) — версия ревизии ClickHouse.
* `ProfileEvents` ([Map(LowCardinality(String), UInt64)](/ru/reference/data-types/map)) — `ProfileEvents`, содержащие различные метрики для этого потока. Их описание можно найти в таблице system.events.

**Псевдонимы:**

* `ProfileEvents.Names` — псевдоним для `mapKeys(ProfileEvents)`.
* `ProfileEvents.Values` — псевдоним для `mapValues(ProfileEvents)`.

<div id="example">
  ## Пример
</div>

```sql theme={null}
 SELECT * FROM system.query_thread_log LIMIT 1 \G
```

```text theme={null}
Row 1:
──────
hostname:                      clickhouse.eu-central1.internal
event_date:                    2020-09-11
event_time:                    2020-09-11 10:08:17
event_time_microseconds:       2020-09-11 10:08:17.134042
query_start_time:              2020-09-11 10:08:17
query_start_time_microseconds: 2020-09-11 10:08:17.063150
query_duration_ms:             70
read_rows:                     0
read_bytes:                    0
written_rows:                  1
written_bytes:                 12
memory_usage:                  4300844
peak_memory_usage:             4300844
thread_name:                   TCPHandler
thread_id:                     638133
master_thread_id:              638133
query:                         INSERT INTO test1 VALUES
is_initial_query:              1
user:                          default
query_id:                      50a320fd-85a8-49b8-8761-98a86bcbacef
address:                       ::ffff:127.0.0.1
port:                          33452
initial_user:                  default
initial_query_id:              50a320fd-85a8-49b8-8761-98a86bcbacef
initial_address:               ::ffff:127.0.0.1
initial_port:                  33452
interface:                     1
os_user:                       bharatnc
client_hostname:               tower
client_name:                   ClickHouse
client_revision:               54437
client_version_major:          20
client_version_minor:          7
client_version_patch:          2
http_method:                   0
http_user_agent:
quota_key:
revision:                      54440
ProfileEvents:        {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'CompressedReadBufferBlocks':1,'CompressedReadBufferBytes':10,'IOBufferAllocs':1,'IOBufferAllocBytes':89,'ContextLock':15,'RWLockAcquiredReadLocks':1}
```

<div id="see-also">
  ## См. также
</div>

* [system.query\_log](/ru/reference/system-tables/query_log) — Описание системной таблицы `query_log`, содержащей общую информацию о выполнении запросов.
* [system.query\_views\_log](/ru/reference/system-tables/query_views_log) — Эта таблица содержит информацию о каждом представлении, задействованном при выполнении запроса.
