Aller au contenu principal

Utiliser les tableaux de bord d’observabilité

info

Bêta

Cette fonctionnalité est en bêta. Les administrateurs de Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Aperçus . Voir Gérer les prévisualisations Databricks.

Lorsque vous configurez l’observabilité pour un projet, Lakebase crée des tableaux de bord Lakeview prêts à l’emploi sur vos tables de télémétrie, afin que vous obteniez des graphiques riches et interactifs de votre activité Postgres sans avoir à en créer vous-même. Ils lisent les mêmes tables Delta dans Unity Catalog que celles utilisées par insight et Genie.

La page Monitoring du projet comporte deux tab. Le Metrics tab est toujours présent, avec des Graphes en direct d’un seul compute (CPU, mémoire, connexions, taux de réussite du cache) pour une réponse sans configuration à la question « ma base de données est-elle saine en ce moment ? » Le tab Advanced Postgres Telemetry apparaît une fois que vous avez configuré l’observabilité et contient une carte renvoyant à chacun de ces tableaux de bord. Comme ils s’exécutent sur la télémétrie capturée dans les tables Delta, ils persistent après les redémarrages et répondent aux questions que Metrics ne peut pas traiter : quelle query est lente, si un plan a changé et ce qui diffère entre deux intervalles de temps.

Prérequis

  • Un projet d'autoscaling Lakebase avec observabilité configurée et un compute en cours d'exécution.
  • Les tableaux de bord sont créés la première fois que la configuration écrit de la télémétrie ; veuillez donc patienter quelques minutes après avoir configuré l'observabilité pour la première fois. Tout comme les tables, ils n'apparaissent pas tant que la télémétrie n'a pas circulé au moins une fois.

Ouvrir un tableau de bord

Ouvrez les tableaux de bord d’un projet depuis l’onglet Advanced Postgres Telemetry tab :

  1. Ouvrez votre projet et accédez à Monitoring .
  2. Sélectionnez le tab Advanced Postgres Telemetry . Il répertorie une carte pour chaque tableau de bord créé par la configuration d'observabilité du projet.
  3. Cliquez sur une carte pour ouvrir ce tableau de bord dans Databricks SQL, dans un nouveau tab. Le tableau de bord s’ouvre filtré sur l’Endpoint principal (lecture/écriture) de la Branch.

Le tab Advanced Postgres Telemetry sous la page monitoring d'un projet, affichant une carte pour le tableau de bord Lakebase Overview et une carte pour le tableau de bord Lakebase Time Interval Comparison, chacun renvoyant vers le tableau de bord Lakeview publié.

Si le tab affiche un état vide au lieu de cartes, l’un des deux éléments suivants est manquant :

  • Aucune configuration assignée — le projet n'est pas encore surveillé. Assignez ou créez d'abord une configuration d'observabilité dans les paramètres du projet. Voir Capture de la télémétrie vers le Lakehouse.
  • Aucun tableau de bord pour le moment — une configuration est attribuée mais n'a pas encore créé ses tableaux de bord. Ils apparaissent une fois que la configuration assure leur provisionnement, peu après le début du flux de télémétrie.
remarque

Vous pouvez également ouvrir les tableaux de bord directement. Dans le workspace, accédez à Dashboards et recherchez Lakebase Overview ou Lakebase Time Interval Comparison . Comme les tableaux de bord sont des tableaux de bord Lakeview ordinaires dans votre workspace (voir The dashboards are yours), ils y sont consultables comme n'importe quel autre.

Les tableaux de bord default

Deux tableaux de bord sont créés pour chaque configuration d'observabilité. Chaque tableau de bord dispose de filtres qui définissent la portée de ses vues, afin que vous puissiez restreindre la fenêtre temporelle et le compute qui vous intéressent. Les filtres exacts et leur emplacement diffèrent entre les deux tableaux de bord, comme décrit ci-dessous.

Présentation de Lakebase

Une vue d'ensemble de la santé et des performances d'un projet sur une plage temporelle, pour un ou plusieurs Endpoint. Il comporte trois pages.

La page de vue d'ensemble du tableau de bord de vue d'ensemble Lakebase, affichant les graphiques de compute au fil du temps : CPU et RAM, utilisation du CPU en cœurs, E/S disque et E/S réseau, délimités par la plage de dates et les filtres d'Endpoint en haut.

La page Overview couvre le compute, les connexions, les queries et les attentes en un coup d'œil :

Graphique

Ce qu'il montre

Lectures à partir de

CPU et RAM au fil du temps

Utilisation du CPU et de la mémoire du compute sur la fenêtre sélectionnée.

compute_gauges

Utilisation du CPU au fil du temps (cœurs utilisés)

Cœurs utilisés au fil du temps. Des périodes prolongées proches de votre CPU alloué indiquent que le compute est limité par le processeur.

compute_counters

E/S disque au fil du temps (Mo/s)

Throughput de lecture/écriture disque au fil du temps.

compute_counters

E/S réseau au fil du temps (Mo/s)

Throughput réseau au fil du temps.

compute_counters

Connexions par endpoint

Nombre de connexions au fil du temps, ventilé par endpoint.

active_session_history

Sessions actives au fil du temps

Sessions actives simultanées au fil du temps.

active_session_history

Volume d'exécution des queries au fil du temps

Nombre de requêtes exécutées au fil du temps.

pg_stat_statements_counters

Temps d'exécution moyen des query (ms)

Latence moyenne des query au fil du temps.

pg_stat_statements_counters

Top 20 des queries par nombre d'appels

Les requêtes les plus fréquemment exécutées dans la fenêtre.

pg_stat_statements_counters

Top 10 des requêtes : temps d’exécution total au fil du temps

Les queries consommant le plus de temps d'exécution total, suivies sur la fenêtre.

pg_stat_statements_counters

Top 10 des queries : % de changement du temps d’exécution moyen (vs moyenne)

Requêtes dont la latence moyenne s’écarte le plus de leur propre moyenne, afin de faire apparaître les régressions.

pg_stat_statements_counters

Temps d'attente par classe au fil du temps

Temps passé à attendre, ventilé par classe d'attente (verrous, E/S et autres), au fil du temps. La classe dominante indique où les queries sont bloquées.

wait_event_counters

Top 25 des requêtes les plus lentes (historique des plans)

Les exécutions individuelles les plus lentes capturées dans l’historique du plan.

plan_history

Aperçu de la mémoire LFC par endpoint

Utilisation de la mémoire du cache de fichiers local par endpoint, un indicateur de la taille du jeu de travail.

compute_gauges

Graphique

Ce qu'il montre

Lectures à partir de

CPU et RAM au fil du temps

Utilisation du CPU et de la mémoire du compute sur la fenêtre sélectionnée.

compute_gauges

Utilisation du CPU au fil du temps (cœurs utilisés)

Cœurs utilisés au fil du temps. Des périodes prolongées proches de votre CPU alloué indiquent que le compute est limité par le processeur.

compute_counters

E/S disque au fil du temps (Mo/s)

Throughput de lecture/écriture disque au fil du temps.

compute_counters

E/S réseau au fil du temps (Mo/s)

Throughput réseau au fil du temps.

compute_counters

Connexions par endpoint

Nombre de connexions au fil du temps, ventilé par endpoint.

active_session_history

Sessions actives au fil du temps

Sessions actives simultanées au fil du temps.

active_session_history

Volume d'exécution des queries au fil du temps

Nombre de requêtes exécutées au fil du temps.

pg_stat_statements_counters

Temps d'exécution moyen des query (ms)

Latence moyenne des query au fil du temps.

pg_stat_statements_counters

Top 20 des queries par nombre d'appels

Les requêtes les plus fréquemment exécutées dans la fenêtre.

pg_stat_statements_counters

Top 10 des requêtes : temps d’exécution total au fil du temps

Les queries consommant le plus de temps d'exécution total, suivies sur la fenêtre.

pg_stat_statements_counters

Top 10 des queries : % de changement du temps d’exécution moyen (vs moyenne)

Requêtes dont la latence moyenne s’écarte le plus de leur propre moyenne, afin de faire apparaître les régressions.

pg_stat_statements_counters

Temps d'attente par classe au fil du temps

Temps passé à attendre, ventilé par classe d'attente (verrous, E/S et autres), au fil du temps. La classe dominante indique où les queries sont bloquées.

wait_event_counters

Top 25 des requêtes les plus lentes (historique des plans)

Les exécutions individuelles les plus lentes capturées dans l’historique du plan.

plan_history

Aperçu de la mémoire LFC par endpoint

Utilisation de la mémoire du cache de fichiers local par endpoint, un indicateur de la taille du jeu de travail.

compute_gauges

La page Analyse de query permet d’approfondir une seule query (sélectionnée avec le filtre ID de query de la page) :

Graphique

Ce qu'il montre

Lectures à partir de

Appels de query & temps d'exécution moyen au fil du temps

Volume d'appels et latence moyenne pour la query sélectionnée au fil du temps.

pg_stat_statements_counters

Temps d'exécution par hash de plan

Temps d'exécution par hash de plan, afin que vous puissiez voir quand le plan d'une query a changé et comment chaque plan fonctionne. Un ralentissement soudain apparaît souvent ici sous la forme d'un nouveau hash de plan plus lent.

plan_history

Statistiques de durée des query

Statistiques de durée pour les exécutions de la query sélectionnée.

plan_history

Statistiques moyennes d'E/S au fil du temps

Moyenne des E/S effectuées par la query sélectionnée au fil du temps.

plan_history

Les 5 exécutions les plus longues

Les cinq exécutions individuelles les plus lentes de la query sélectionnée.

plan_history

Graphique

Ce qu'il montre

Lectures à partir de

Appels de query & temps d'exécution moyen au fil du temps

Volume d'appels et latence moyenne pour la query sélectionnée au fil du temps.

pg_stat_statements_counters

Temps d'exécution par hash de plan

Temps d'exécution par hash de plan, afin que vous puissiez voir quand le plan d'une query a changé et comment chaque plan fonctionne. Un ralentissement soudain apparaît souvent ici sous la forme d'un nouveau hash de plan plus lent.

plan_history

Statistiques de durée des query

Statistiques de durée pour les exécutions de la query sélectionnée.

plan_history

Statistiques moyennes d'E/S au fil du temps

Moyenne des E/S effectuées par la query sélectionnée au fil du temps.

plan_history

Les 5 exécutions les plus longues

Les cinq exécutions individuelles les plus lentes de la query sélectionnée.

plan_history

La page Global Filters contient les contrôles qui définissent la portée de toutes les autres pages : Date Range , Endpoint et Include Postgres Database .

Comparaison d'intervalle de temps Lakebase

Compare l'activité d'un endpoint sur deux intervalles de temps que vous choisissez (un « avant » et un « après ») pour faire ressortir les changements et les régressions, par exemple après un déploiement ou un pic de trafic. Vous définissez la Période A et la Période B avec les sélecteurs de plage de dates et choisissez l'endpoint, puis vous lisez les deux périodes côte à côte :

Le tableau de bord de comparaison d'intervalles de temps Lakebase, affichant les sélecteurs de plage de dates Période A et Période B ainsi qu'un tableau de comparaison des queries avec le nombre d'appels, les temps d'exécution et les colonnes de variation en pourcentage pour les deux périodes côte à côte afin que les changements entre elles ressortent.

Graphique

Ce qu'il montre

Lectures à partir de

Principaux événements d'attente — Période A / Période B

Les événements d'attente dominants dans chaque période, sous forme de barres côte à côte.

wait_event_counters

Événements d’attente dans le temps — Période A / Période B

Évolution des événements d'attente au sein de chaque période.

wait_event_counters

Tableau comparatif des événements d'attente

Événements d'attente pour les deux périodes dans un seul tableau, afin que les décalages ressortent.

wait_event_counters

Tableau de comparaison des requêtes

Statistiques de query pour les deux périodes côte à côte, afin de repérer quelles queries sont devenues plus lentes ou plus sollicitées.

pg_stat_statements_counters

Graphique

Ce qu'il montre

Lectures à partir de

Principaux événements d'attente — Période A / Période B

Les événements d'attente dominants dans chaque période, sous forme de barres côte à côte.

wait_event_counters

Événements d’attente dans le temps — Période A / Période B

Évolution des événements d'attente au sein de chaque période.

wait_event_counters

Tableau comparatif des événements d'attente

Événements d'attente pour les deux périodes dans un seul tableau, afin que les décalages ressortent.

wait_event_counters

Tableau de comparaison des requêtes

Statistiques de query pour les deux périodes côte à côte, afin de repérer quelles queries sont devenues plus lentes ou plus sollicitées.

pg_stat_statements_counters

Pour connaître la signification de chaque colonne dans ces tables, consultez la référence des tables de télémétrie.

Partager un tableau de bord

Les tableaux de bord sont créés en tant que brouillons dont vous êtes propriétaire, vous pouvez donc les ouvrir et les utiliser immédiatement.

Si vous souhaitez partager un tableau de bord avec d'autres utilisateurs, publiez-le. Lorsque vous publiez, vous choisissez comment ses requêtes sont exécutées pour ces utilisateurs :

  • Informations d'identification intégrées — les queries s'exécutent en tant qu'éditeur et vous gérez l'accès au niveau du tableau de bord. Il s'agit de l'option la plus simple.
  • Informations d’identification du visionneur — les requêtes sont exécutées en tant que chaque visionneur ; vous leur accordez donc des autorisations sur les tables de télémétrie sous-jacentes. Cela demande plus de travail, mais permet à d'autres utilisateurs d'exécuter leurs propres requêtes personnalisées sur les mêmes données.

Personnaliser et étendre un tableau de bord

Vous êtes libre de modifier les tableaux de bord. Comme il s'agit dans chaque cas d'un tableau de bord Lakeview ordinaire, vous pouvez le modifier comme n'importe quel autre : renommer ou supprimer des Graphes, changer les visualisations, ajuster les filtres default, ou ajouter vos propres Graphes et pages basés sur les mêmes tables de télémétrie (ou joints avec toute autre donnée dans Unity Catalog). Pour savoir comment modifier les tableaux de bord Lakeview, consultez Tableaux de bord.

Si vous préférez conserver les originaux intacts, clonez d'abord un tableau de bord et personnalisez la copie.

Pour créer de nouvelles vues, écrivez vos propres requêtes sur les tables de télémétrie avec n'importe quel outil Databricks SQL. Les données sont au format Delta standard dans votre propre Unity Catalog.

Les tableaux de bord sont à vous

Les tableaux de bord et les tables de télémétrie sont détenus par l'utilisateur . Lakebase les crée, mais ils vous appartiennent, et la suppression de la configuration ne les supprime jamais :

  • La suppression de la configuration d'observabilité ne les supprime pas. Si vous supprimez ou réattribuez une configuration, ses tableaux de bord et ses tables de télémétrie restent en place. Toutes les modifications que vous avez apportées à un tableau de bord sont conservées. Supprimez-les vous-même si vous n'en voulez plus.
  • Modifier l’emplacement d’écriture d’une configuration (son catalogue, son schéma ou son préfixe de table) n’affecte pas les tableaux de bord existants et crée un nouveau tableau de bord pointant vers la nouvelle destination. Le tableau de bord précédent demeure votre contenu autonome.

Comme il s'agit de tableaux de bord Lakeview et de tables Delta standard dans votre propre Unity Catalog, ils se comportent comme tout autre contenu que vous possédez, plutôt que d'être verrouillés dans un produit d'observabilité distinct. Voir Où résident vos données.

Étapes suivantes