サンプリングクエリプロファイラ

ClickHouseはクエリ実行を分析するためのサンプリングプロファイラを実行します。プロファイラを使用すると、クエリ実行中に最も頻繁に使用されたソースコードルーチンを見つけることができます。CPU時間とアイドル時間を含むウォールクロック時間を追跡できます。

クエリプロファイラはClickHouse Cloudで自動的に有効になっており、次のようにサンプルクエリを実行できます。

注記

ClickHouse Cloudで次のクエリを実行している場合は、FROM system.trace_logをFROM clusterAllReplicas(default, system.trace_log)に変更して、クラスターのすべてのノードから選択してください。

セルフマネージドデプロイメントでクエリプロファイラを使用するには：

• サーバー構成のtrace_logセクションを設定します。

  このセクションはプロファイラの機能結果を含むtrace_logシステムテーブルを構成します。デフォルトで設定されています。このテーブルのデータは、実行中のサーバーでのみ有効であることに注意してください。サーバーの再起動後、ClickHouseはテーブルをクリーンアップせず、保存されたすべての仮想メモリアドレスが無効になる可能性があります。

• query_profiler_cpu_time_period_nsまたはquery_profiler_real_time_period_ns設定を設定します。両方の設定は同時に使用可能です。

  これらの設定を使用すると、プロファイラタイマーを構成できます。これらはセッション設定であるため、サーバ全体、個別のユーザーまたはユーザープロファイル、対話型セッション、各個別のクエリのために異なるサンプリング頻度を取得できます。

デフォルトのサンプリング頻度は1秒あたり1サンプルで、CPUとリアルタイマーの両方が有効になっています。この頻度でClickHouseクラスターに関する十分な情報を収集できます。同時に、この頻度で作業すると、プロファイラはClickHouseサーバーのパフォーマンスに影響を与えません。各個別のクエリをプロファイルする必要がある場合は、より高いサンプリング頻度を使用することをお勧めします。

trace_logシステムテーブルを分析するには：

• clickhouse-common-static-dbgパッケージをインストールします。 DEBパッケージからインストールを参照してください。

• allow_introspection_functions設定によってイントロスペクション関数を許可します。

  セキュリティ上の理由から、イントロスペクション関数はデフォルトで無効になっています。

• addressToLine、addressToLineWithInlines、addressToSymbolおよびdemangle イントロスペクション関数を使用して、ClickHouseコード内の関数名とその位置を取得します。あるクエリのプロファイルを取得するには、trace_logテーブルからデータを集約する必要があります。個々の関数または全体のスタックトレースによってデータを集約できます。

trace_log情報を視覚化する必要がある場合は、flamegraphやspeedscopeを試してください。

サンプル

このサンプルでは：

• クエリ識別子と現在の日付でtrace_logデータをフィルタリングします。

• スタックトレースで集約します。

• イントロスペクション関数を使用して、次のレポートを取得します：

  • シンボル名と対応するソースコード関数。
  • これらの関数のソースコードの位置。