ClickHouse Cloud でのクエリこのシステムテーブルのデータは、ClickHouse Cloud の各ノードにローカルに保持されています。したがって、すべてのデータを完全に把握するには、
clusterAllReplicas 関数を使用する必要があります。詳細については、こちらを参照してください。説明
addressToLine、addressToLineWithInlines、addressToSymbol、および demangle イントロスペクション関数を使用します。
カラム
hostname(LowCardinality(String)) — クエリを実行するサーバーのホスト名。event_date(Date) — サンプリング時点の日付。event_time(DateTime) — サンプリング時点のタイムスタンプ。event_time_microseconds(DateTime64(6)) — マイクロ秒精度のサンプリング時点を示すタイムスタンプ。timestamp_ns(UInt64) — サンプリング時点のタイムスタンプ (ナノ秒単位) 。revision(UInt32) — ClickHouse server のビルドリビジョン。clickhouse-clientでサーバーに接続すると、Connected to ClickHouse server version 19.18.1.のような文字列が表示されます。このフィールドにはサーバーのversionではなく、revisionが含まれます。trace_type(Enum8(‘Real’ = 0, ‘CPU’ = 1, ‘Memory’ = 2, ‘MemorySample’ = 3, ‘MemoryPeak’ = 4, ‘ProfileEvent’ = 5, ‘JemallocSample’ = 6, ‘MemoryAllocatedWithoutCheck’ = 7, ‘Instrumentation’ = 8)) — トレースの種類:Realは、実時間に基づいてスタックトレースを収集することを表します。CPUは、CPU 時間に基づいてスタックトレースを収集することを表します。Memoryは、メモリ割り当てが次のウォーターマークを超えた際に、割り当てと解放を収集することを表します。MemorySampleは、ランダムな割り当てと解放を収集することを表します。MemoryPeakは、ピークメモリ使用量の更新を収集することを表します。ProfileEventは、プロファイルイベントの増分を収集することを表します。JemallocSampleは、jemalloc サンプルを収集することを表します。MemoryAllocatedWithoutCheckは、メモリ制限を一切無視して行われる大規模な割り当て (>16MiB) の収集を表します (ClickHouse 開発者専用) 。Instrumentationは、XRay を通じて実行されたインストルメンテーションによって収集されたトレースを表します。cpu_id(UInt64) — CPUの識別子。thread_id(UInt64) — スレッドID。thread_name(LowCardinality(String)) — スレッド名。query_id(String) —query_logシステムテーブルから実行されていたクエリの詳細を取得するために使用できるクエリ識別子です。trace(Array(UInt64)) — サンプリング時点のスタックトレース。各要素は、ClickHouseサーバープロセス内の仮想メモリアドレスです。size(Int64) — トレースの種類が Memory、MemorySample、MemoryAllocatedWithoutCheck、または MemoryPeak の場合は、割り当てられたメモリ量です。それ以外のトレースの種類では 0 です。ptr(UInt64) — 割り当てられたchunkのアドレスです。memory_context(Enum8(‘Unknown’ = -1, ‘Global’ = 0, ‘User’ = 1, ‘Process’ = 2, ‘Thread’ = 3, ‘Max’ = 4)) — Memory Tracker のコンテキスト (Memory/MemoryPeak のみ) :Unknownコンテキストは、このtrace_typeでは定義されていません。Globalはサーバー コンテキストを表します。Userはユーザー/マージ コンテキストを表します。Processはプロセス (つまりクエリ) コンテキストを表します。Threadはスレッド (特定のプロセスのスレッド) コンテキストを表します。Maxは特殊な値で、メモリトラッカーがブロックされていないことを示します (blocked_contextカラム用) 。memory_blocked_context(Enum8(‘Unknown’ = -1, ‘Global’ = 0, ‘User’ = 1, ‘Process’ = 2, ‘Thread’ = 3, ‘Max’ = 4)) — メモリトラッカーがブロックされているコンテキスト (ClickHouse 開発者向け) :Unknownコンテキストはこの trace_type では定義されていません。Globalはサーバーコンテキストを表します。Userはユーザー/merge コンテキストを表します。Processはプロセス (つまりquery) コンテキストを表します。Threadはスレッド (特定のプロセスのスレッド) コンテキストを表します。Maxは特殊な値で、メモリトラッカーがブロックされていないことを意味します (blocked_context カラム用) 。event(LowCardinality(String)) — トレースタイプが ProfileEvent の場合は更新されたプロファイルイベントの名前、それ以外のトレースタイプでは空文字列です。increment(Int64) — トレースの種類が ProfileEvent の場合、profile event の増分値です。それ以外のトレースの種類では 0 になります。symbols(Array(LowCardinality(String))) — シンボル化が有効な場合、traceに対応するデマングル済みのシンボル名が含まれます。シンボル化の有効/無効は、サーバー設定ファイルのtrace_log内にあるsymbolize設定で切り替えられます。lines(Array(LowCardinality(String))) — シンボル化が有効な場合、traceに対応する、行番号付きのファイル名を表す文字列が格納されます。function_id(Nullable(Int32)) — trace 型が Instrumentation の場合、ELF バイナリの xray_instr_map セクション内の関数に割り当てられる ID。function_name(Nullable(String)) — トレースタイプが Instrumentation の場合、インストルメントされた関数名。handler(Nullable(String)) — trace 型の Instrumentation では、インストルメントされた関数のハンドラー。entry_type(Nullable(Enum8(‘Entry’ = 0, ‘Exit’ = 1))) — トレース型の Instrumentation の場合、インストルメントされた関数のエントリタイプ。duration_nanoseconds(Nullable(UInt64)) — トレース型の Instrumentation において、関数が実行されていた時間をナノ秒単位で表します。
build_id—'E2EEB60ED9503BFFA825B628D480CCDC40B2D416'のエイリアス。
trace_log にある symbolize で有効または無効に切り替えられます。
例
Chrome Event Trace Format への変換
chrome_trace.sql ファイルとして保存してください。
trace.json ファイルにエクスポートすれば、そのファイルを Perfetto または speedscope にインポートできます。
関連項目
- SYSTEM INSTRUMENT — インストルメンテーションポイントを追加または削除します。
- system.instrumentation — インストルメント済みのポイントを確認します。
- system.symbols — インストルメンテーションポイントを追加するためのシンボルを確認します。