Référence de la table de télémétrie
Bêta
Cette fonctionnalité est en Bêta. Les administrateurs du Workspace peuvent contrôler l'accès à cette fonctionnalité à partir de la page Previews . Consultez Gérer les aperçus Databricks.
Cette page documente les tables que Lakebase écrit dans votre schéma Unity Catalog une fois que vous avez configuré l'observabilité pour un projet. Ce sont les tables décrites dans Fonctionnement. Insights et Genie lisent ces mêmes données, et parce que cela arrive dans votre propre Unity Catalog, vous pouvez l'interroger directement avec n'importe quel outil Databricks.
Il s'agit d'une fonctionnalité Bêta. Les noms de table et de colonne pourraient changer avant la disponibilité générale.
Colonnes communes à toutes les tables
Chaque tableau ci-dessous inclut ces colonnes, qui identifient l'origine d'une ligne :
Colonne | Type | Description |
|---|---|---|
| CHAÎNE | Le projet Lakebase dont la ligne est issue. |
| CHAÎNE | La Branch dont la ligne est issue. |
| CHAÎNE | L'endpoint de compute d'où la ligne provient. |
| CHAÎNE | L'instance de compute spécifique. Cela change lorsqu'une instance de compute se met à l'échelle zéro et reprend. |
| Horodatage | Lorsque la ligne a été enregistrée. |
| CHAÎNE | Le mode du compute à ce moment-là, par exemple lecture-écriture ou lecture seule. |
Les tables dont le nom se termine par _counters comprennent également une colonne previous_ts, indiquant le start de l'intervalle sur lequel les valeurs d'une ligne se sont accumulées. Ce sont des valeurs cumulées pour cet intervalle, et non des lectures instantanées. Les tables dont le nom se termine par _gauges sont plutôt des lectures instantanées, et n'ont pas de previous_ts.
Les tables ci-dessous listent uniquement les colonnes s'ajoutant à celles qui sont communes.
Activité de session
Un instantané de chaque back-end actif, échantillonné en continu. Il s'agit du même modèle que AWS Performance Insights ou l'historique de session active (ASH) d'Oracle : si une session effectue une action, y compris l'attente, elle apparaît ici.
active_session_history
Colonne | Type | Description |
|---|---|---|
| LONG | Position ordinale de cet échantillon au sein de son batch. |
| LONG | L'ID du processus du backend. |
| LONG | L'ID d'objet de la base de données. |
| LONG | L'ID de l'objet du rôle de connexion. |
| LONG | Identifie la query en cours. Correspond à |
| LONG | Encodage interne de l'événement d'attente. |
| CHAÎNE | Catégorie de l'événement d'attente, par exemple |
| CHAÎNE | L'événement d'attente spécifique, par exemple |
| LONG | L'état du backend, par exemple actif ou inactif. |
| LONG | Le type de processus back-end. |
| LONG | Depuis combien de temps la transaction actuelle est ouverte. |
| LONG | Durée d'exécution de la query actuelle. |
| LONG | Le PID d'une session bloquant celle-ci, le cas échéant. |
| LONG | Le PID du responsable de la query parallèle, si ce backend est un worker parallèle. |
| LONG | Indicateurs d'état internes. |
| LONG | Link vers une forme de plan spécifique dans |
| LONG | Un hachage du nom de l'application de connexion. |
Événements d'attente
Comptes et temps d'événements d'attente agrégés, complétant la vue par échantillon dans active_session_history.
wait_event_counters
Colonne | Type | Description |
|---|---|---|
| LONG | Encodage interne de l'événement d'attente. |
| CHAÎNE | La catégorie de l’événement d’attente. |
| CHAÎNE | L'événement d'attente spécifique. |
| LONG | Nombre de fois où cet événement d'attente s'est produit dans l'intervalle. |
| Double | Temps total passé dans cet événement d'attente pendant l'intervalle. |
Plans de query
Un enregistrement par exécution des plans de query, incluant le plan complet et les statistiques de stockage spécifiques à Neon. C'est la table la plus détaillée, et généralement là où une enquête sur les requêtes lentes aboutit.
plan_history
Colonne | Type | Description |
|---|---|---|
| LONG | Position ordinale de cette ligne au sein de son batch. |
| Booléen | Indique si le plan inclut des statistiques d’exécution réelles ( |
| Booléen | Si le plan inclut les statistiques d'utilisation du tampon. |
| CHAÎNE | Hachage identifiant le texte de la query. |
| LONG | Identifie la query. Correspondances de |
| Double | Combien de temps la query a mis pour s'exécuter. |
| Double | Le coût estimé du planificateur pour la query. |
| LONG | Le nombre estimé de lignes du planificateur. |
| LONG | Le nombre réel de lignes renvoyées. |
| LONG | Identifie cette forme de plan spécifique. Correspond à |
| Double | Temps passé à attendre sur les verrous. |
| Double | Temps passé à planifier la query, distinct de l'exécution. |
| LONG | Activité du cache tampon partagé pour cette exécution. |
| LONG | Activité du tampon local, pour les tables temporaires. |
| LONG | Activité de fichier temporaire, par exemple à partir d'un tri ou d'un hachage volumineux. |
| LONG | Nombre de requêtes de page envoyées au serveur de pages. |
| LONG | Nombre de pages servies à partir du cache de fichiers local au lieu du pageserver. |
| LONG | Temps passé à attendre les requêtes de pages du pageserver, en microsecondes. |
| LONG | L’ID de processus backend qui a exécuté cette query. |
| LONG | Nombre de fois où cette exécution a attendu un verrou. |
| LONG | Les ID d'objet du rôle de connexion et de la base de données. |
| CHAÎNE | Le texte de la query. |
| CHAÎNE | Le plan de query complet, au format JSON. |
| CHAÎNE | Les noms du rôle de connexion et de la base de données. |
| CHAÎNE | Le nom de l'application de connexion et l'adresse du client. |
| CHAÎNE | Événements d'attente observés pendant cette exécution. |
| CHAÎNE | Lie les parameters utilisés dans la query, le cas échéant. |
| CHAÎNE | PIDs des sessions qui ont bloqué cette exécution, le cas échéant. |
| CHAÎNE | Identifiants Neon internes pour la Branch, l'Endpoint et la chronologie. |
| Double | Temps CPU consommé par cette exécution, divisé en temps utilisateur et temps système. |
| LONG | Changements de contexte pendant cette exécution. |
| CHAÎNE / CHAÎNE / LONG / CHAÎNE | Identifiants de traçage de style OpenTelemetry, si la query faisait partie d'une requête tracée. |
| LONG | Identifiant de chronologie interne. |
| Booléen | Si les données de cette ligne (par exemple, un plan volumineux) ont été tronquées avant d’être écrites. |
Query statistics
Statistiques agrégées par query, issues de l'extension pg_stat_statements standard.
pg_stat_statements_counters
Colonne | Type | Description |
|---|---|---|
| LONG | Les ID d'objet du rôle de connexion et de la base de données. |
| LONG | Identifie la query. Correspondances de |
| Booléen | Indique si cette ligne concerne une instruction de niveau supérieur, par opposition à une instruction imbriquée dans une fonction ou une procédure PL/pgSQL. Consultez la limitation PL/pgSQL. |
| CHAÎNE | Le texte de la query. |
| LONG | Nombre de fois que cette query a été exécutée dans l'intervalle. |
| LONG | Nombre de fois que cette query a été planifiée dans l'intervalle. |
| LONG | Nombre total de lignes renvoyées ou affectées. |
| Double | Temps total passé à exécuter et à planifier cette query dans l'intervalle. |
| LONG | Activité du cache tampon partagé. |
| LONG | Activité du tampon local, pour les tables temporaires. |
| LONG | Activité des fichiers temporaires. |
| LONG | Volume de logs de progression généré par cette query. |
| Mixte | Statistiques de compilation JIT (just-in-time), si JIT a été utilisé pour cette query. |
Changements de schéma
Modifications du schéma : ce qui a changé, quand et par qui. C'est ce que Genie lit pour retracer un incident jusqu'à une modification du schéma, qu'elle provienne d'un déploiement ou d'une édition manuelle.
ddl_history
Colonne | Type | Description |
|---|---|---|
| LONG | Position ordinale de cette ligne au sein de son batch. |
| CHAÎNE | Le type de commande DDL, par exemple |
| CHAÎNE | Le type et le nom de l'objet qui a changé. |
| CHAÎNE | Le schéma Postgres auquel l'objet appartient. |
| CHAÎNE | L'instruction DDL complète. |
| Double | La durée d’exécution de l’instruction DDL. |
| LONG / CHAÎNE | L'ID et le nom de l'objet du rôle de connexion. |
| CHAÎNE | Le nom de l'application de connexion. |
| LONG | L’ID de processus backend qui a exécuté l’instruction. |
| LONG | L'ID d'objet de la base de données. |
| CHAÎNE | Le chemin de recherche de la session à ce moment-là. |
| CHAÎNE | Une représentation structurée et analysée de l’instruction DDL. |
La capture DDL présente une véritable lacune : un changement effectué au moment où un compute reprend après une mise à l’échelle à zéro peut être manqué. Si un changement de schéma n’apparaît pas ici, même si vous savez qu’il s’est produit, c’est la raison la plus probable. Consultez les Limitations.
Logs Postgres
Messages de logs Postgres bruts, y compris l'erreur spécifique à l'origine d'un échec.
postgres_logs
Colonne | Type | Description |
|---|---|---|
| LONG | Position ordinale de cette ligne au sein de son batch. |
| LONG | Encodage interne du niveau de log. |
| CHAÎNE | La gravité du log, par exemple |
| CHAÎNE | Le code d’erreur SQLSTATE de Postgres, par exemple |
| LONG | L'ID du processus back-end, et le PID de son leader de query parallèle, le cas échéant. |
| LONG / CHAÎNE | L'ID et le nom de l'objet du rôle de connexion. |
| LONG / CHAÎNE | L'ID et le nom de l'objet de la base de données. |
| CHAÎNE | Le nom de l'application de connexion et l'adresse du client. |
| CHAÎNE | Le schéma, la table, la colonne, la contrainte ou le type de données référencés par l'erreur, lorsque Postgres en possède un. |
| CHAÎNE | La fonction où l'erreur s'est produite, le cas échéant. |
| CHAÎNE / LONG | Le fichier source et la ligne Postgres d'où l'erreur provient. |
| CHAÎNE | Le texte du message de log. |
| CHAÎNE | Détails supplémentaires, une correction suggérée et le contexte de l'erreur, lorsque Postgres les fournit. |
| CHAÎNE | Une query générée en interne et liée à l'erreur, le cas échéant. |
| CHAÎNE | L'instruction qui a Trigger cette entrée de Logs. |
| LONG | Indique quels champs, le cas échéant, ont été tronqués avant d'être écrits. |
Les champs structurés schema_name, table_name et column_name ne sont pas remplis pour chaque type d'erreur. Une simple erreur d'analyse « la colonne n'existe pas » (SQLSTATE 42703), par exemple, les laisse vides même si message nomme directement la colonne. Ne vous fiez pas à ces champs remplis. Vérifiez message en premier.
Indicateurs de compute
Utilisation des ressources au niveau du compute : CPU, mémoire, E/S disque et réseau, et le cache de fichiers local (LFC), le cache côté compute de Lakebase devant le pageserver.
compute_counters
Colonne | Type | Description |
|---|---|---|
| Double | Temps passé par la couche de stockage à limiter les écritures pendant cet intervalle. Une valeur non nulle signifie que le volume d'écriture a dépassé la capacité d'absorption du stockage. |
| Double | Temps CPU consommé, pour le cœur le plus sollicité et au total. |
| Double | Volume d'E/S disque. |
| Double | Volume d'E/S réseau. |
| LONG | Activité du cache de fichiers local pour cet intervalle. |
| LONG | Expulsions du cache de fichiers local causées par la reprise du réplica, si ce compute est un réplica en lecture. |
compute_gauges
Colonne | Type | Description |
|---|---|---|
| LONG | La position actuelle du log d'écriture anticipée. |
| LONG | Positions de relecture et de réception WAL, si ce compute est un réplica en lecture. |
| LONG | La limite de connexion configurée. |
| LONG | Taille estimée de l'ensemble de travail sur les 5, 15 et 60 dernières minutes. |
| LONG | Capacité et utilisation actuelle du cache de fichiers local. |
| LONG | Capacité de stockage globale et utilisation actuelle. |
| LONG/DOUBLE | Retard de réplication, si ce compute est un réplica en lecture. |
| Double | Le CPU et la mémoire provisionnés du compute. |
Mesures de base de données
Activité par base de données : lignes modifiées, transactions, sessions et état du vacuum. C'est là que se trouvent la fragmentation des tables et les signaux d'autovacuum.
compteurs_de_base_de_données
Colonne | Type | Description |
|---|---|---|
| LONG / CHAÎNE | L'ID et le nom de l'objet de la base de données. |
| Double | Temps passé actif, inactif dans une transaction ouverte et connecté globalement. |
| LONG | Nombre de blocages détectés. |
| LONG | Activité au niveau des lignes pour l'intervalle. |
| LONG | Comptes du cycle de vie des sessions. |
| LONG | Activité du cache tampon partagé. |
| LONG | Transactions validées et annulées. |
database_gauges
Colonne | Type | Description |
|---|---|---|
| LONG / CHAÎNE | L'ID et le nom de l'objet de la base de données. |
| LONG | Nombre actuel de connexions à cette base de données. |
| LONG | La taille sur disque de la base de données. |
| LONG | Âge de l'ID de transaction et de l'ID de multixact de la ligne non gelée la plus ancienne. L'augmentation des valeurs est le premier signe que le processus de vacuum prend du retard, bien avant que le bloat ne devienne visible dans la taille de la table. |
Étapes suivantes
- Vue d'ensemble du dépannage assisté par l'IA — comment cette télémétrie alimente les Insights et Genie.
- Trouver et résoudre les problèmes avec les insights — consultez ces données affichées comme un diagnostic, pas comme des lignes brutes.
- Diagnostiquer et corriger les problèmes avec Genie — enquêtez sur un problème de manière conversationnelle.