mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-15 02:41:59 +00:00
20 KiB
20 KiB
| slug |
|---|
| /ja/operations/system-tables/query_log |
query_log
実行されたクエリに関する情報を含んでいます。例えば、開始時間、処理の持続時間、エラーメッセージなどがあります。
:::note
このテーブルは INSERT クエリの投入データを含んでいません。
:::
クエリのロギング設定はサーバー構成のquery_logセクションで変更できます。
クエリのロギングを無効にするには、log_queries = 0を設定します。しかし、問題解決のためにこのテーブルの情報は重要であるため、ロギングをオフにすることは推奨しません。
データのフラッシュ期間は、サーバー設定のquery_logセクションの flush_interval_milliseconds パラメータで設定されています。強制的にフラッシュするには、SYSTEM FLUSH LOGS クエリを使用してください。
ClickHouseはテーブルからデータを自動的に削除しません。詳細は導入を参照してください。
system.query_log テーブルは2種類のクエリを登録します：
- クライアントによって直接実行された初期クエリ。
- 他のクエリによって開始された子クエリ（分散クエリ実行のため）。これらのタイプのクエリについては、親クエリに関する情報が
initial_*カラムに表示されます。
各クエリは、そのステータス（type カラムを参照）に応じて、query_log テーブルに1または2行を生成します：
- クエリ実行が成功した場合、
QueryStartおよびQueryFinishタイプの2行が生成されます。 - クエリ処理中にエラーが発生した場合、
QueryStartおよびExceptionWhileProcessingタイプの2つのイベントが生成されます。 - クエリ開始前にエラーが発生した場合、
ExceptionBeforeStartタイプの単一のイベントが生成されます。
log_queries_probability 設定を使用して、query_log テーブルに登録されるクエリ数を減らすことができます。
log_formatted_queries 設定を使用して、フォーマットされたクエリを formatted_query カラムにログできます。
カラム:
hostname(LowCardinality(String)) — クエリを実行するサーバーのホスト名。type(Enum8) — クエリの実行時に発生したイベントのタイプ。値:'QueryStart' = 1— クエリ実行の成功した開始。'QueryFinish' = 2— クエリ実行の成功した終了。'ExceptionBeforeStart' = 3— クエリ実行の開始前に発生した例外。'ExceptionWhileProcessing' = 4— クエリ実行中に発生した例外。
event_date(Date) — クエリの開始日。event_time(DateTime) — クエリの開始時間。event_time_microseconds(DateTime64) — マイクロ秒精度のクエリの開始時間。query_start_time(DateTime) — クエリ実行の開始時間。query_start_time_microseconds(DateTime64) — マイクロ秒精度のクエリ実行開始時間。query_duration_ms(UInt64) — クエリ実行の持続時間（ミリ秒）。read_rows(UInt64) — クエリ実行に参加するすべてのテーブルおよびテーブル関数から読み取られた行の合計数。通常のサブクエリ、INおよびJOINのサブクエリを含む。分散クエリに対してread_rowsはすべてのレプリカで読み取られた行の合計数を含む。各レプリカはread_rows値を送信し、クエリのサーバー発信者はすべての受信およびローカル値をまとめる。キャッシュのボリュームはこの値に影響を与えません。read_bytes(UInt64) — クエリ実行に参加するすべてのテーブルおよびテーブル関数から読み取られたバイト数の合計。通常のサブクエリ、INおよびJOINのサブクエリを含む。分散クエリに対してread_bytesはすべてのレプリカで読み取られた行の合計数を含む。各レプリカはread_bytes値を送信し、クエリのサーバー発信者はすべての受信およびローカル値をまとめる。キャッシュのボリュームはこの値に影響を与えません。written_rows(UInt64) —INSERTクエリに対して、書き込まれた行の数。その他のクエリでは0。written_bytes(UInt64) —INSERTクエリに対して、書き込まれたバイト数（未圧縮）。その他のクエリでは0。result_rows(UInt64) —SELECTクエリの結果の行数、またはINSERTクエリの行数。result_bytes(UInt64) — クエリ結果を保存するために使用されるRAMのバイト数。memory_usage(UInt64) — クエリによるメモリ消費。current_database(String) — 現在のデータベースの名前。query(String) — クエリ文字列。formatted_query(String) — フォーマットされたクエリ文字列。normalized_query_hash(UInt64) — 類似したクエリのリテラル値を除いた同一のハッシュ値。query_kind(LowCardinality(String)) — クエリの種類。databases(Array(LowCardinality(String))) — クエリに存在するデータベースの名前。tables(Array(LowCardinality(String))) — クエリに存在するテーブルの名前。columns(Array(LowCardinality(String))) — クエリに存在するカラムの名前。partitions(Array(LowCardinality(String))) — クエリに存在するパーティションの名前。projections(String) — クエリ実行中に使用されたプロジェクションの名前。views(Array(LowCardinality(String))) — クエリに存在する (マテリアライズドまたはライブ) ビューの名前。exception_code(Int32) — 例外コード。exception(String) — 例外メッセージ。stack_trace(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) — 親クエリを行うために使用されたクライアントポート。initial_query_start_time(DateTime) — 初期クエリの開始時間（分散クエリ実行）。initial_query_start_time_microseconds(DateTime64) — マイクロ秒精度の初期クエリ開始時間（分散クエリ実行）。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クエリで渡されたHTTPヘッダーUserAgent。http_referer(String) — HTTPクエリで渡されたHTTPヘッダーReferer（クエリを行うページの絶対または部分アドレスを含む）。forwarded_for(String) — HTTPクエリで渡されたHTTPヘッダーX-Forwarded-For。quota_key(String) — quotas 設定で指定されたquota key（keyedを参照）。revision(UInt32) — ClickHouseのリビジョン。ProfileEvents(Map(String, UInt64)) — 異なるメトリクスを測定するProfileEvents。それらの説明はテーブル system.events で見つけることができます。Settings(Map(String, String)) — クライアントがクエリを実行したときに変更された設定。設定の変更をログに記録するには、log_query_settingsパラメータを1に設定してください。log_comment(String) — ログコメント。max_query_size より長くない任意の文字列に設定できます。定義されていない場合は空文字列。thread_ids(Array(UInt64)) — クエリ実行に参加するスレッドID。これらのスレッドは必ずしも同時に動作していたとは限りません。peak_threads_usage(UInt64)) — クエリを実行する同時スレッドの最大数。used_aggregate_functions(Array(String)) — クエリ実行中に使用された集約関数の標準名。used_aggregate_function_combinators(Array(String)) — クエリ実行中に使用された集約関数コンビネータの標準名。used_database_engines(Array(String)) — クエリ実行中に使用されたデータベースエンジンの標準名。used_data_type_families(Array(String)) — クエリ実行中に使用されたデータタイプファミリーの標準名。used_dictionaries(Array(String)) — クエリ実行中に使用されたDictionaryの標準名。XMLファイルを使用して設定されたDictionaryの場合、Dictionaryの名前となり、SQL文で作成されたDictionaryの場合、標準名は完全修飾されたオブジェクト名となります。used_formats(Array(String)) — クエリ実行中に使用されたフォーマットの標準名。used_functions(Array(String)) — クエリ実行中に使用された関数の標準名。used_storages(Array(String)) — クエリ実行中に使用されたストレージの標準名。used_table_functions(Array(String)) — クエリ実行中に使用されたテーブル関数の標準名。used_privileges(Array(String)) - クエリ実行中に正常にチェックされた権限。missing_privileges(Array(String)) - クエリ実行中に不足している権限。query_cache_usage(Enum8) — クエリ実行中のクエリキャッシュの使用。値:'Unknown'= ステータス不明。'None'= クエリ結果がクエリキャッシュに書き込まれず、または読み出されない。'Write'= クエリ結果がクエリキャッシュに書き込まれた。'Read'= クエリ結果がクエリキャッシュから読み出された。
例
SELECT * FROM system.query_log WHERE type = 'QueryFinish' ORDER BY query_start_time DESC LIMIT 1 FORMAT Vertical;
Row 1:
──────
hostname: clickhouse.eu-central1.internal
type: QueryFinish
event_date: 2021-11-03
event_time: 2021-11-03 16:13:54
event_time_microseconds: 2021-11-03 16:13:54.953024
query_start_time: 2021-11-03 16:13:54
query_start_time_microseconds: 2021-11-03 16:13:54.952325
query_duration_ms: 0
read_rows: 69
read_bytes: 6187
written_rows: 0
written_bytes: 0
result_rows: 69
result_bytes: 48256
memory_usage: 0
current_database: default
query: DESCRIBE TABLE system.query_log
formatted_query:
normalized_query_hash: 8274064835331539124
query_kind:
databases: []
tables: []
columns: []
projections: []
views: []
exception_code: 0
exception:
stack_trace:
is_initial_query: 1
user: default
query_id: 7c28bbbb-753b-4eba-98b1-efcbe2b9bdf6
address: ::ffff:127.0.0.1
port: 40452
initial_user: default
initial_query_id: 7c28bbbb-753b-4eba-98b1-efcbe2b9bdf6
initial_address: ::ffff:127.0.0.1
initial_port: 40452
initial_query_start_time: 2021-11-03 16:13:54
initial_query_start_time_microseconds: 2021-11-03 16:13:54.952325
interface: 1
os_user: sevirov
client_hostname: clickhouse.eu-central1.internal
client_name: ClickHouse
client_revision: 54449
client_version_major: 21
client_version_minor: 10
client_version_patch: 1
http_method: 0
http_user_agent:
http_referer:
forwarded_for:
quota_key:
revision: 54456
log_comment:
thread_ids: [30776,31174]
ProfileEvents: {'Query':1,'NetworkSendElapsedMicroseconds':59,'NetworkSendBytes':2643,'SelectedRows':69,'SelectedBytes':6187,'ContextLock':9,'RWLockAcquiredReadLocks':1,'RealTimeMicroseconds':817,'UserTimeMicroseconds':427,'SystemTimeMicroseconds':212,'OSCPUVirtualTimeMicroseconds':639,'OSReadChars':894,'OSWriteChars':319}
Settings: {'load_balancing':'random','max_memory_usage':'10000000000'}
used_aggregate_functions: []
used_aggregate_function_combinators: []
used_database_engines: []
used_data_type_families: []
used_dictionaries: []
used_formats: []
used_functions: []
used_storages: []
used_table_functions: []
used_privileges: []
missing_privileges: []
query_cache_usage: None
関連項目
- system.query_thread_log — 各クエリ実行スレッドに関する情報を含むテーブルです。