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

> Visualize os dados de system.query_log para simplificar a depuração de consultas e a otimização de desempenho

# Query Insights

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

O recurso **Query Insights** torna mais fácil usar o log de consultas integrado do ClickHouse por meio de visualizações e tabelas. A tabela `system.query_log` do ClickHouse é uma fonte essencial de informações para otimização de consultas, depuração e monitoramento da integridade e do desempenho geral do cluster.

<div id="query-overview">
  ## Visão geral da consulta
</div>

Após selecionar um serviço, o item de navegação **Monitoring** na barra lateral esquerda deve se expandir para exibir um novo subitem, **Query insights**. Ao clicar nessa opção, a nova página do Query insights é aberta:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/pb3p2qvhHWkIWhRw/images/cloud/sqlconsole/insights_overview.png?fit=max&auto=format&n=pb3p2qvhHWkIWhRw&q=85&s=29f88486270a16fecf702ab664994935" size="md" alt="Visão geral da UI do Query Insights" border width="1712" height="790" data-path="images/cloud/sqlconsole/insights_overview.png" />

<div id="top-level-metrics">
  ## Métricas principais
</div>

As caixas de estatísticas no topo mostram algumas métricas básicas de consulta para o período selecionado. Abaixo delas, disponibilizamos três gráficos de séries temporais que mostram o volume de consultas, a latência e a taxa de erros, segmentados por tipo de consulta (select, insert, other) na janela de tempo selecionada. O gráfico de latência também pode ser ajustado para exibir as latências p50, p90 e p99:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/pb3p2qvhHWkIWhRw/images/cloud/sqlconsole/insights_latency.png?fit=max&auto=format&n=pb3p2qvhHWkIWhRw&q=85&s=77fd70f20769046fe41128adadc8d9f7" size="md" alt="Gráfico de latência da UI do Query Insights" border width="1456" height="384" data-path="images/cloud/sqlconsole/insights_latency.png" />

<div id="recent-queries">
  ## Consultas recentes
</div>

Abaixo das métricas principais, uma tabela exibe entradas do log de consultas (agrupadas por hash da consulta normalizada e usuário) no intervalo de tempo selecionado:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/ddNWBC5mE_w-syUp/images/cloud/sqlconsole/insights_recent.png?fit=max&auto=format&n=ddNWBC5mE_w-syUp&q=85&s=05e6899e22b5e63b015ec1789bbae651" size="md" alt="UI do Query Insights: tabela de Consultas recentes" border width="1625" height="736" data-path="images/cloud/sqlconsole/insights_recent.png" />

As consultas recentes podem ser filtradas e ordenadas por qualquer campo disponível. A tabela também pode ser configurada para exibir ou ocultar campos adicionais, como tabelas e latências p90 e p99.

<div id="query-drill-down">
  ## Detalhamento da consulta
</div>

Ao selecionar uma consulta na tabela de consultas recentes, será aberto um painel lateral com métricas e informações específicas da consulta selecionada:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/pb3p2qvhHWkIWhRw/images/cloud/sqlconsole/insights_drilldown.png?fit=max&auto=format&n=pb3p2qvhHWkIWhRw&q=85&s=fdbe0898d7e6efa412e753a6a5820684" size="md" alt="UI do Query Insights: detalhamento da consulta" border width="1889" height="963" data-path="images/cloud/sqlconsole/insights_drilldown.png" />

Como podemos ver no painel lateral, esta consulta específica foi executada mais de 3000 vezes nas últimas 24 horas. Todas as métricas na aba **Informações da consulta** são métricas agregadas, mas também podemos ver as métricas de execuções individuais selecionando a aba **Histórico da consulta**:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/ddNWBC5mE_w-syUp/images/cloud/sqlconsole/insights_query_info.png?fit=max&auto=format&n=ddNWBC5mE_w-syUp&q=85&s=e23df58f6815f155383ae6d11fac6b10" size="sm" alt="UI do Query Insights: informações da consulta" border width="591" height="961" data-path="images/cloud/sqlconsole/insights_query_info.png" />

<br />

Nesse painel, os itens `Settings` e `Profile Events` de cada execução de consulta podem ser expandidos para exibir informações adicionais.
