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

> Визуализируйте данные system.query_log, чтобы упростить отладку запросов и оптимизацию производительности

# Query insights

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

<div id="query-insights">
  # Query Insights
</div>

Функция **Query Insights** упрощает работу со встроенным журналом запросов ClickHouse с помощью визуализаций и таблиц. Таблица `system.query_log` в ClickHouse — ключевой источник информации для оптимизации запросов, отладки, а также мониторинга общего состояния и производительности кластера.

<div id="query-overview">
  ## Обзор запросов
</div>

После выбора сервиса пункт **Monitoring** в левой боковой панели должен развернуться, и в нем появится новый подпункт **Query insights**. При нажатии на него открывается новая страница Query insights:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/dKGeoWn0mtJu5Ssd/images/cloud/sqlconsole/insights_overview.png?fit=max&auto=format&n=dKGeoWn0mtJu5Ssd&q=85&s=4f5271246be3fb5fdd065af93279f812" size="md" alt="Обзор интерфейса Query Insights" border width="1712" height="790" data-path="images/cloud/sqlconsole/insights_overview.png" />

<div id="top-level-metrics">
  ## Метрики верхнего уровня
</div>

Блоки статистики в верхней части показывают несколько основных метрик запросов за выбранный период времени. Ниже представлены три графика временных рядов, отражающие объём запросов, задержку и долю ошибок в разбивке по типу запроса (select, insert, other) в выбранном временном окне. График задержки можно дополнительно настроить для отображения значений p50, p90 и p99:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/dKGeoWn0mtJu5Ssd/images/cloud/sqlconsole/insights_latency.png?fit=max&auto=format&n=dKGeoWn0mtJu5Ssd&q=85&s=44c1ff41484f2053e8bd300b79386123" size="md" alt="График задержки в интерфейсе Query Insights" 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-mintlify-86180b7b/dKGeoWn0mtJu5Ssd/images/cloud/sqlconsole/insights_recent.png?fit=max&auto=format&n=dKGeoWn0mtJu5Ssd&q=85&s=44752c10841504f14b6cc2856804f086" size="md" alt="Интерфейс Query Insights: таблица недавних запросов" 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-mintlify-86180b7b/dKGeoWn0mtJu5Ssd/images/cloud/sqlconsole/insights_drilldown.png?fit=max&auto=format&n=dKGeoWn0mtJu5Ssd&q=85&s=8556e0f25833da0839c6f52541ad1305" size="md" alt="Интерфейс Query Insights: детализация запроса" border width="1889" height="963" data-path="images/cloud/sqlconsole/insights_drilldown.png" />

Как видно из выдвижной панели, этот запрос выполнялся более 3000 раз за последние 24 часа. Все метрики на вкладке **Информация о запросе** являются агрегированными, но метрики отдельных запусков также можно просмотреть, выбрав вкладку **История запроса**:

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-86180b7b/dKGeoWn0mtJu5Ssd/images/cloud/sqlconsole/insights_query_info.png?fit=max&auto=format&n=dKGeoWn0mtJu5Ssd&q=85&s=11091681cdeb37739052d0dafb5bf3de" size="sm" alt="Интерфейс Query Insights: информация о запросе" border width="591" height="961" data-path="images/cloud/sqlconsole/insights_query_info.png" />

<br />

На этой панели для каждого запуска запроса можно развернуть элементы `Settings` и `Profile Events`, чтобы увидеть дополнительную информацию.
