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

> Visualisez les données de system.query_log pour simplifier le débogage des requêtes et optimiser leurs performances

# Query insights

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

La fonctionnalité **Query Insights** facilite l’exploitation du journal des requêtes intégré de ClickHouse grâce à des visualisations et des tableaux. La table `system.query_log` de ClickHouse est une source d’information essentielle pour l’optimisation des requêtes, le débogage, ainsi que la surveillance de l’état général et des performances du cluster.

<div id="query-overview">
  ## Vue d’ensemble des requêtes
</div>

Après avoir sélectionné un service, l’élément de navigation **Monitoring** dans la barre latérale gauche devrait se déployer pour afficher un nouveau sous-élément **Query insights**. Cliquer sur cette option ouvre la nouvelle page Query insights :

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/YtLHbpLqKXQpx3d8/images/cloud/sqlconsole/insights_overview.png?fit=max&auto=format&n=YtLHbpLqKXQpx3d8&q=85&s=0d652d49bcb888193cd0ac6f2f2e32e1" size="md" alt="Vue d’ensemble de l’UI de Query Insights" border width="1712" height="790" data-path="images/cloud/sqlconsole/insights_overview.png" />

<div id="top-level-metrics">
  ## Métriques de haut niveau
</div>

Les encadrés statistiques en haut représentent quelques métriques de haut niveau de base des requêtes sur la période sélectionnée. En dessous, trois graphiques de séries temporelles affichent le volume de requêtes, la latence et le taux d’erreur, ventilés par type de requête (select, insert, other) sur la fenêtre temporelle sélectionnée. Le graphique de latence peut également être ajusté pour afficher les latences p50, p90 et p99 :

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/YtLHbpLqKXQpx3d8/images/cloud/sqlconsole/insights_latency.png?fit=max&auto=format&n=YtLHbpLqKXQpx3d8&q=85&s=364b9601588d3ba628b68c26b964beeb" size="md" alt="Graphique de latence de l’UI Query Insights" border width="1456" height="384" data-path="images/cloud/sqlconsole/insights_latency.png" />

<div id="recent-queries">
  ## Requêtes récentes
</div>

Sous les métriques de haut niveau, un tableau affiche les entrées du journal des requêtes (regroupées par hash de requête normalisée et par utilisateur) sur l’intervalle de temps sélectionné :

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/YtLHbpLqKXQpx3d8/images/cloud/sqlconsole/insights_recent.png?fit=max&auto=format&n=YtLHbpLqKXQpx3d8&q=85&s=a029b38784d333cb62c2a9fbe1cfb474" size="md" alt="Tableau des requêtes récentes dans l’UI Query Insights" border width="1625" height="736" data-path="images/cloud/sqlconsole/insights_recent.png" />

Les requêtes récentes peuvent être filtrées et triées selon n’importe quel champ disponible. Le tableau peut également être configuré pour afficher ou masquer des champs supplémentaires, tels que les tables et les latences p90 et p99.

<div id="query-drill-down">
  ## Drill-down sur les requêtes
</div>

Sélectionner une requête dans le tableau **Requêtes récentes** ouvre un volet latéral contenant des métriques et des informations propres à la requête sélectionnée :

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/YtLHbpLqKXQpx3d8/images/cloud/sqlconsole/insights_drilldown.png?fit=max&auto=format&n=YtLHbpLqKXQpx3d8&q=85&s=3371e463e4ec089807a443432cdada1f" size="md" alt="UI de Query Insights, drill-down sur une requête" border width="1889" height="963" data-path="images/cloud/sqlconsole/insights_drilldown.png" />

Comme nous pouvons le voir dans le volet latéral, cette requête a été exécutée plus de 3 000 fois au cours des dernières 24 heures. Toutes les métriques de l'onglet **Query info** sont agrégées, mais nous pouvons également afficher les métriques de chaque exécution en sélectionnant l'onglet **Query history** :

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-fbfa8bee/YtLHbpLqKXQpx3d8/images/cloud/sqlconsole/insights_query_info.png?fit=max&auto=format&n=YtLHbpLqKXQpx3d8&q=85&s=4629def1dbb76a6646c02097e3ee5be4" size="sm" alt="UI de Query Insights, informations sur la requête" border width="591" height="961" data-path="images/cloud/sqlconsole/insights_query_info.png" />

<br />

Dans ce panneau, les éléments `Settings` et `Profile Events` de chaque exécution de requête peuvent être développés pour afficher des informations supplémentaires.
