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

クエリインサイト

クエリインサイト 機能は、可視化やテーブルを通じて、ClickHouse の組み込みクエリログをより簡単に利用できるようにします。ClickHouse の system.query_log テーブルは、クエリの最適化、デバッグ、クラスタ全体の健全性とパフォーマンスの監視にとって重要な情報源です。

クエリ概要

サービスを選択すると、左サイドバーの Monitoring ナビゲーション項目が展開され、新たに クエリインサイト というサブ項目が表示されます。このオプションをクリックすると、新しいクエリインサイトページが開きます。

Query Insights UI Overview

トップレベルメトリクス

上部の統計ボックスは、選択した期間におけるいくつかの基本的なクエリのトップレベルメトリクスを表しています。その下には、クエリ種別 (select、insert、other) ごとに分解されたクエリ数、レイテンシ、エラー率を、選択した時間範囲にわたって可視化する 3 つの時系列チャートが表示されます。レイテンシチャートではさらに、p50、p90、p99 のレイテンシを表示するように切り替えることができます。

Query Insights UI Latency Chart

最近のクエリ

トップレベルメトリクスの下に、選択した時間枠におけるクエリログエントリ(正規化されたクエリハッシュとユーザーごとにグループ化)がテーブルで表示されます。

Query Insights UI Recent Queries Table

最近のクエリは、利用可能な任意のフィールドでフィルタおよびソートできます。また、テーブル名、p90、p99 レイテンシなどの追加フィールドを表示または非表示にするようテーブルを設定することもできます。

クエリのドリルダウン

最近のクエリテーブルからクエリを選択すると、選択したクエリに固有のメトリクスと情報を含むフライアウトが開きます。

Query Insights UI Query Drill down

フライアウトから分かるように、このクエリは過去24時間に 3,000 回以上実行されています。Query info タブに表示されるメトリクスはすべて集計メトリクスですが、Query history タブを選択することで、各実行ごとのメトリクスも表示できます。

Query Insights UI Query Information

このペインからは、各クエリ実行の Settings および Profile Events 項目を展開して、追加情報を表示できます。