system.query_thread_log

説明

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

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

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

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

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

log_queries_probability) 設定を使用すると、query_thread_log テーブルに記録されるクエリ数を減らせます。

カラム

hostname (LowCardinality(String)) — クエリを実行するサーバーのホスト名。
event_date (Date) — スレッドがクエリの実行を完了した日付。
event_time (DateTime) — スレッドによるクエリの実行が完了した日時。
event_time_microseconds (DateTime64(6)) — スレッドによるクエリの実行がマイクロ秒精度で完了した日時。
query_start_time (DateTime) — クエリ実行の開始時刻。
query_start_time_microseconds (DateTime64(6)) — マイクロ秒精度でのクエリ実行の開始時刻。
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 (LowCardinality(String)) — スレッド名。
thread_id (UInt64) — 内部スレッド ID。
master_thread_id (UInt64) — 初期スレッドのOS上での初期ID。
current_database (LowCardinality(String)) — 現在のデータベース名。
query (String) — クエリ文字列。
normalized_query_hash (UInt64) — 正規化されたクエリのハッシュ。定数などは取り除かれています。
is_initial_query (UInt8) — クエリが初期クエリかどうか。設定可能な値: 1 — 初期 (最上位) クエリ、0 — 分散実行用のクエリや内部サブクエリを含む、別のクエリによって開始された子クエリ。
connection_address (IPv6) — 接続元のクライアント IP アドレス。proxy 経由で接続している場合、これは proxy のアドレスになります。
connection_port (UInt16) — 接続元のクライアントのポートです。プロキシ経由で接続している場合は、プロキシのポートになります。
user (LowCardinality(String)) — 現在のクエリを実行したユーザー名。
query_id (String) — クエリの ID。
address (IPv6) — クエリの実行元として使用された IP アドレス。プロキシ経由で接続しており、auth_use_forwarded_address が設定されている場合、これはプロキシではなくクライアントのアドレスになります。
port (UInt16) — クエリの実行時に使用されたクライアントのポート。プロキシ経由で接続しており、auth_use_forwarded_address が設定されている場合、これはプロキシではなくクライアント側のポートになります。
initial_user (LowCardinality(String)) — 同じクエリチェーン内で初期クエリを実行したユーザー名。
initial_query_id (String) — 同じクエリチェーン内の初期クエリの ID。
initial_address (IPv6) — 同じクエリチェーン内の初期クエリの送信元 IP アドレス。
initial_port (UInt16) — 同じクエリチェーン内の初期クエリの送信元クライアントポート。
initial_query_start_time (DateTime) — 同じクエリチェーン内の初期クエリの開始時刻。
initial_query_start_time_microseconds (DateTime64(6)) — 同じクエリチェーン内の初期クエリの開始時刻 (マイクロ秒精度) 。
authenticated_user (LowCardinality(String)) — セッション内で認証されたユーザー名。
interface (UInt8) — クエリの開始元となったインターフェイス。設定可能な値: 1 — TCP、2 — HTTP。
is_secure (UInt8) — 接続がセキュアかどうかを示すフラグ。
os_user (LowCardinality(String)) — clickhouse-client を実行する OS ユーザー名。
client_hostname (LowCardinality(String)) — clickhouse-client または別の TCP クライアントを実行しているクライアントマシンのホスト名。
client_name (LowCardinality(String)) — clickhouse-client またはその他の TCP クライアントの名前。
client_agent (LowCardinality(String)) — 環境変数から検出された、クライアントを呼び出した AI コーディング agent (例: claude-code、cursor) 。agent が検出されなかった場合は空です。
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 クライアントのバージョンにおけるパッチ部分です。
script_query_number (UInt32) — 複数クエリからなるスクリプトにおける連番のクエリ番号。
script_line_number (UInt32) — 複数クエリを含むスクリプト内で、現在のクエリが開始される行番号。
http_method (UInt8) — クエリの開始に使用された HTTP メソッド。設定可能な値: 0 - クエリは TCP インターフェイス経由で実行された、1 - GET メソッドが使用された、2 - POST メソッドが使用された、4 - PUT メソッドが使用された、5 - DELETE メソッドが使用された、6 - HEAD メソッドが使用された。
http_user_agent (LowCardinality(String)) — HTTPリクエストで渡されるUser-Agentヘッダー。
http_referer (String) — HTTPクエリで送信される HTTP ヘッダー Referer (クエリを実行したページの絶対アドレスまたは部分的なアドレスを含みます) 。
forwarded_for (String) — HTTPクエリに含まれるHTTPヘッダー X-Forwarded-For。
quota_key (String) — quotas 設定で指定する'quota key'。
distributed_depth (UInt64) — サーバー間でクエリが転送された回数。
revision (UInt32) — ClickHouse のリビジョン番号。
ProfileEvents (Map(LowCardinality(String), UInt64)) — このスレッドのさまざまなメトリクスを計測する ProfileEvents です。各イベントの説明は system.events テーブルにあります。

別名:

ProfileEvents.Names — mapKeys(ProfileEvents) の別名です。
ProfileEvents.Values — mapValues(ProfileEvents) の別名です。

例

 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}

説明

カラム

例

関連項目