> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.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 = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </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-postgresql-tls-support/mXojvHhEhDtRJeuO/images/cloud/sqlconsole/insights_overview.webp?fit=max&auto=format&n=mXojvHhEhDtRJeuO&q=85&s=5ad333135c292bb8822f8880f29e6350" size="md" alt="Обзор интерфейса Query Insights" border width="1712" height="790" data-path="images/cloud/sqlconsole/insights_overview.webp" />

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

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

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/mXojvHhEhDtRJeuO/images/cloud/sqlconsole/insights_latency.webp?fit=max&auto=format&n=mXojvHhEhDtRJeuO&q=85&s=e19d821ee9fb8b5d2942749a9a98bb4a" size="md" alt="График задержки в интерфейсе Query Insights" border width="1456" height="384" data-path="images/cloud/sqlconsole/insights_latency.webp" />

<div id="recent-queries">
  ## Недавние запросы
</div>

Под сводными метриками верхнего уровня таблица показывает записи журнала запросов (сгруппированные по нормализованному хешу запроса и пользователю) за выбранный временной интервал:

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/mXojvHhEhDtRJeuO/images/cloud/sqlconsole/insights_recent.webp?fit=max&auto=format&n=mXojvHhEhDtRJeuO&q=85&s=8ec5893fa42a7e4bc3818186ea7b0ac4" size="md" alt="Интерфейс Query Insights: таблица недавних запросов" border width="1625" height="736" data-path="images/cloud/sqlconsole/insights_recent.webp" />

В разделе недавних запросов можно фильтровать и сортировать данные по любому доступному полю. Таблицу также можно настроить так, чтобы отображать или скрывать дополнительные поля, например таблицы, задержки p90 и p99."}]}

<div id="query-drill-down">
  ## Детализация запроса
</div>

При выборе запроса в таблице недавних запросов откроется выдвижная панель с метриками и информацией по выбранному запросу:

<Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/mXojvHhEhDtRJeuO/images/cloud/sqlconsole/insights_drilldown.webp?fit=max&auto=format&n=mXojvHhEhDtRJeuO&q=85&s=e4e66dacb9e71cc20ad629dc1554fa30" size="md" alt="Интерфейс Query Insights: детализация запроса" border width="1889" height="963" data-path="images/cloud/sqlconsole/insights_drilldown.webp" />

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

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

<br />

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