メインコンテンツへスキップ
メインコンテンツへスキップ

system.query_thread_log

Querying in ClickHouse Cloud

The data in this system table is held locally on each node in ClickHouse Cloud. Obtaining a complete view of all data, therefore, requires the clusterAllReplicas function. See here for further details.

クエリを実行するスレッドに関する情報を含みます。たとえば、スレッド名、スレッドの開始時刻、クエリ処理時間などです。

ログの記録を開始するには:

  1. query_thread_log セクションでパラメータを設定します。
  2. log_query_threads を 1 に設定します。

データのフラッシュ間隔は、query_thread_log のサーバー設定セクション内にある flush_interval_milliseconds パラメータで設定します。フラッシュを強制的に実行するには、SYSTEM FLUSH LOGS クエリを使用します。

ClickHouse はテーブルからデータを自動的には削除しません。詳細は Introduction を参照してください。

query_thread_log テーブルに登録されるクエリ数を減らすには、log_queries_probability 設定を使用できます。

Columns:

  • hostname (LowCardinality(String)) — クエリを実行するサーバーのホスト名。
  • event_date (Date) — スレッドがクエリの実行を完了した日付。
  • event_time (DateTime) — スレッドがクエリの実行を完了した日時。
  • event_time_microseconds (DateTime) — スレッドがクエリの実行を完了した日時（マイクロ秒精度まで）。
  • query_start_time (DateTime) — クエリ実行開始時刻。
  • query_start_time_microseconds (DateTime64) — クエリ実行の開始時刻（マイクロ秒単位の精度）。
  • query_duration_ms (UInt64) — クエリの実行時間。
  • read_rows (UInt64) — 読み込まれた行数。
  • read_bytes (UInt64) — 読み込まれたバイト数。
  • written_rows (UInt64) — INSERT クエリでは書き込まれた行数を示します。それ以外のクエリでは、この列の値は 0 です。
  • written_bytes (UInt64) — INSERT クエリの場合は書き込まれたバイト数。それ以外のクエリの場合、この列の値は 0 になります。
  • memory_usage (Int64) — このスレッドのコンテキストにおいて、割り当てられたメモリ量と解放されたメモリ量の差を表します。
  • peak_memory_usage (Int64) — このスレッドのコンテキストにおいて、割り当てられたメモリ量と解放されたメモリ量の差が最大となったときの値。
  • thread_name (String) — スレッドの名前。
  • thread_id (UInt64) — OS のスレッド ID。
  • master_thread_id (UInt64) — OS によって割り当てられた最初のスレッドの ID。
  • query (String) — クエリを表す文字列。
  • is_initial_query (UInt8) — クエリの種類。取りうる値：
    • 1 — クエリがクライアントによって開始された場合。
    • 0 — 分散クエリ実行のために、別のクエリから開始された場合。
  • user (String) — 現在のクエリを実行したユーザー名。
  • query_id (String) — クエリ ID。
  • address (IPv6) — クエリの実行に使用されたIPアドレス。
  • port (UInt16) — クエリの送信に使用されたクライアントのポート番号。
  • initial_user (String) — 初回のクエリを実行したユーザー名（分散クエリ実行時）。
  • initial_query_id (String) — 分散クエリ実行における初期クエリの ID。
  • initial_address (IPv6) — 親クエリが実行された元の IP アドレス。
  • initial_port (UInt16) — 親クエリの実行に使用されたクライアントポート。
  • interface (UInt8) — クエリがどのインターフェイスから実行されたかを表します。取り得る値:
    • 1 — TCP
    • 2 — HTTP
  • os_user (String) — clickhouse-client を実行する OS のユーザー名。
  • client_hostname (String) — clickhouse-client または他の TCP クライアントが実行されているクライアントマシンのホスト名です。
  • client_name (String) — clickhouse-client または別の TCP クライアントの名前。
  • client_revision (UInt32) — clickhouse-client またはその他の TCP クライアントのリビジョン番号。
  • client_version_major (UInt32) — clickhouse-client またはその他の TCP クライアントのメジャーバージョン。
  • client_version_minor (UInt32) — clickhouse-client またはその他の TCP クライアントのマイナーバージョン。
  • client_version_patch (UInt32) — clickhouse-client または他の TCP クライアントのバージョンのパッチ番号。
  • http_method (UInt8) — クエリを発行した HTTP メソッド。取りうる値:
    • 0 — クエリは TCPインターフェイスから実行されました。
    • 1 — GET メソッドが使用されました。
    • 2 — POST メソッドが使用されました。
  • http_user_agent (String) — HTTP リクエストで渡された UserAgent ヘッダー。
  • quota_key (String) — quotas 設定で指定される「quota key」（keyed を参照）です。
  • revision (UInt32) — ClickHouse のリビジョン番号。
  • ProfileEvents (Map(String, UInt64)) — このスレッドに関するさまざまなメトリクスを測定する ProfileEvents。各イベントの説明は、system.events テーブルで確認できます。

例

 SELECT * FROM system.query_thread_log LIMIT 1 \G

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}

関連項目

  • system.query_log — クエリの実行に関する共通情報を含む query_log システムテーブルの説明。
  • system.query_views_log — クエリ中に実行された各ビューに関する情報を含むシステムテーブル。