> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> system.query_log データを可視化し、クエリのデバッグとパフォーマンス最適化を容易にします

# クエリインサイト

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

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

<div id="query-overview">
  ## クエリの概要
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/i_CQC_ZlrVqpDXd2/images/cloud/sqlconsole/insights_overview.png?fit=max&auto=format&n=i_CQC_ZlrVqpDXd2&q=85&s=61fda661530633bcad49cafd8a5bd677" size="md" alt="クエリインサイトUIの概要" border width="1712" height="790" data-path="images/cloud/sqlconsole/insights_overview.png" />

<div id="top-level-metrics">
  ## 上部の主要メトリクス
</div>

上部の統計ボックスには、選択した期間における基本的な主要クエリメトリクスが表示されます。その下には、選択した時間範囲におけるクエリ量、レイテンシ、エラー率を、クエリの種類 (select、insert、other) ごとに分類して示す 3 つの時系列チャートが表示されます。レイテンシチャートはさらに調整でき、p50、p90、p99 のレイテンシを表示できます。

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/i_CQC_ZlrVqpDXd2/images/cloud/sqlconsole/insights_latency.png?fit=max&auto=format&n=i_CQC_ZlrVqpDXd2&q=85&s=4a7c9f5b41df9b190d2b955f3e5e91ac" size="md" alt="クエリインサイト UI のレイテンシチャート" border width="1456" height="384" data-path="images/cloud/sqlconsole/insights_latency.png" />

<div id="recent-queries">
  ## 最近のクエリ
</div>

上部の主要メトリクスの下には、選択した時間枠内のクエリログのエントリを表示するテーブルがあります (正規化クエリハッシュとユーザーごとにグループ化) 。

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/i_CQC_ZlrVqpDXd2/images/cloud/sqlconsole/insights_recent.png?fit=max&auto=format&n=i_CQC_ZlrVqpDXd2&q=85&s=d952b3ab50def5af5132ab2fd3d4deba" size="md" alt="クエリインサイト UI の最近のクエリテーブル" border width="1625" height="736" data-path="images/cloud/sqlconsole/insights_recent.png" />

最近のクエリは、利用可能な任意のフィールドでフィルタリングやソートを行えます。また、テーブル、p90、p99 レイテンシなどの追加フィールドの表示/非表示も設定できます。

<div id="query-drill-down">
  ## クエリのドリルダウン
</div>

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

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/i_CQC_ZlrVqpDXd2/images/cloud/sqlconsole/insights_drilldown.png?fit=max&auto=format&n=i_CQC_ZlrVqpDXd2&q=85&s=ed715ed9ff0c9fb5eabb108ed202c232" size="md" alt="Query Insights UI クエリのドリルダウン" border width="1889" height="963" data-path="images/cloud/sqlconsole/insights_drilldown.png" />

フライアウトを見ると、このクエリは直近 24 時間で 3,000 回以上実行されていることがわかります。**Query info** タブのメトリクスはすべて集計メトリクスですが、**Query history** タブを選択すると、個々の実行ごとのメトリクスも確認できます。

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/i_CQC_ZlrVqpDXd2/images/cloud/sqlconsole/insights_query_info.png?fit=max&auto=format&n=i_CQC_ZlrVqpDXd2&q=85&s=dcb53353a7a8b5d8059e7e1301990425" size="sm" alt="Query Insights UI クエリ情報" border width="591" height="961" data-path="images/cloud/sqlconsole/insights_query_info.png" />

<br />

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