Configurer l’observabilité
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.
Une configuration d'observabilité capture la télémétrie approfondie de Lakebase Postgres sous forme de tables Delta dans Unity Catalog. Insights, Genie et les tableaux de bord s'appuient tous sur ces données ; un projet n'en dispose d'aucun tant qu'une configuration n'est pas associée.
Une configuration est un objet unique qui peut couvrir un ou plusieurs projets. Il existe deux manières d’y associer une identité, et elles coexistent par conception :
- Un administrateur de workspace définit une configuration de Service Principal comme valeur par défaut du workspace, afin que chaque nouveau projet bénéficie automatiquement de l'observabilité.
- Un propriétaire de projet individuel configure son propre projet avec des identifiants d’utilisateur.
Un Workspace finit généralement par présenter un mélange : la plupart des projets utilisent la configuration par default partagée, certains disposent de leurs propres configurations. Cette page couvre la configuration complète pour l'un ou l'autre chemin. Pour configurer un projet unique dont vous êtes propriétaire, consultez le guide de démarrage rapide.
Prérequis
- La préversion Lakebase Advanced Postgres Telemetry est activée pour votre workspace. Un administrateur de workspace l'active depuis la page de préversions.
- Un projet d'autoscaling Lakebase sur AWS ou Azure. Consultez Obtenir une base de données Postgres.
- Un catalogue et un schéma Unity Catalog pour recevoir la télémétrie. Le schéma doit déjà exister, et le catalogue ne peut pas utiliser le stockage Default .
Configurer les paramètres
Choisissez une identité. La configuration écrit la télémétrie dans Unity Catalog en tant qu’identité que vous sélectionnez dans l’assistant. Ce choix détermine la portée de la configuration et sa durée de vie :
- Choisissez un service principal pour une configuration durable qui n'est liée au compte d'aucune personne en particulier. C'est la solution idéale pour standardiser l'observabilité : définissez-la comme valeur par default du workspace et assignez-la aux projets existants. La sélection d'un service principal est réservée aux administrateurs du workspace, et vous devez d'abord le provisionner (étape 1 ci-dessous).
- Choisissez user-level credentials pour configurer un projet sous votre propre accès, sans aucun provisionnement. Cela convient à un projet individuel dont vous êtes propriétaire. C'est limité à vos autorisations, donc ignorez l'étape de provisionnement du Service Principal et start à Ouvrir l'assistant de configuration.
Provisionner le Service Principal
Si vous utilisez des identifiants au niveau de l’utilisateur, passez à Ouvrir l’assistant de configuration.
Accordez au Service Principal les quatre autorisations ci-dessous avant de créer la configuration, afin qu'il soit prêt à être sélectionné dans l'assistant. Ils sont indépendants et chacun est accordé à un endroit différent. Si l'un d'eux est manquant, la configuration est tout de même enregistrée, mais la télémétrie n'est jamais enregistrée silencieusement et aucun insight n'est généré, sans erreur pour vous indiquer la cause. Si une configuration ne produit aucune télémétrie, vérifiez d'abord ces points.
Grant | Where to set it | Why it's needed |
|---|---|---|
Workspace access | The principal's Configurations tab, under Entitlements | Lets the service principal act in the workspace at all. Without it, Lakebase writes telemetry as an identity that can't do anything, so every telemetry table stays empty. |
Workspace admin | Settings > Identity and access > Groups: open the admins group and add the principal | The background agent currently requires admin access to write telemetry and generate insights. |
CAN USE | The principal's Permissions tab | Lets you select the principal in the wizard. Creating a service principal grants CAN MANAGE, which doesn't include CAN USE, so you grant it explicitly. See Roles for managing service principals. |
Unity Catalog privileges | The destination catalog and schema (see the SQL below) | Lets the principal create and write the telemetry tables: |
Accordez l'accès au Workspace et le droit CAN USE dans Settings > Identity and access > Service principals . Accordez les privilèges Unity Catalog dans l'explorateur de catalogue ou avec SQL :
GRANT USE CATALOG ON CATALOG <catalog> TO `<service-principal-id>`;
GRANT USE SCHEMA ON SCHEMA <catalog>.<schema> TO `<service-principal-id>`;
GRANT CREATE TABLE ON SCHEMA <catalog>.<schema> TO `<service-principal-id>`;
Requiring workspace admin is a current Beta constraint and may be narrowed in a later release. Grant it for now so that telemetry and insights work.
Ouvrir l'assistant de configuration
Ouvrez l'assistant depuis l'un ou l'autre emplacement. Les deux ouvrent le même assistant :
- De Lakebase > Insights > Gérer les configurations > Ajouter une nouvelle configuration
- Depuis les Paramètres de votre projet > Configuration d'observabilité > Créer une nouvelle configuration
Effectuez les trois étapes de l'assistant qui suivent dans l'ordre, en cliquant sur Next entre chacune d'elles.
Configurer
Nommez la configuration et sélectionnez où ses données de télémétrie sont stockées. Deux choix méritent que l'on s'y attarde :
- Définir comme configuration default pour les nouveaux projets fait de cette configuration la valeur default du Workspace : chaque nouveau projet créé dans le Workspace se voit attribuer cette configuration automatiquement, sans aucune action de la part de son créateur. Activez cette option pour standardiser l’observabilité à l’échelle du workspace. Un Workspace a au plus un default, et celui-ci ne s’applique qu’aux projets créés ultérieurement ; vous devez donc également l’attribuer aux projets existants lors de l’étape Attribuer aux projets. Laissez cette option désactivée si vous souhaitez que cette configuration s’applique à des projets spécifiques plutôt qu’à l’ensemble du workspace.
- Identité (sous Autoriser Lakebase à écrire vos données ) est le compte sous lequel Lakebase écrit la télémétrie, conformément au choix que vous avez effectué dans Choisir une identité. Sélectionnez Utiliser un service principal et choisissez le principal que vous avez provisionné, ou sélectionnez Utiliser des informations d'identification au niveau de l'utilisateur pour exécuter en tant que vous-même. Seuls les administrateurs de workspace peuvent sélectionner un Service Principal.
Sous Envoyer la télémétrie vers Unity Catalog , choisissez le catalogue et le schéma dans lesquels les tables seront enregistrées, ainsi qu’un préfixe de table facultatif. Vous choisissez une destination, vous ne la concevez pas : Lakebase crée les tables listées dans Ce qui est capturé la première fois qu’il écrit de la télémétrie. Le schéma doit déjà exister et le catalogue ne peut pas utiliser le stockage default . Comme Use default storage est sélectionné par default lorsque vous créez un catalogue dans l’explorateur de catalogues (Catalog Explorer), assurez-vous de le décocher pour le catalogue que vous utilisez ici.
Activer les insights
Assurez-vous que les **insights** sont activés. C'est ce qui exécute l'agent Insights en arrière-plan. Sans cela, une configuration écrit la télémétrie dans Unity Catalog mais ne fait rien remonter de manière proactive. Deux champs associés apparaissent :
- Les Instructions sont un texte libre que l'agent lit avant chaque passe d'analyse, par exemple « Ne générez pas d'insights sur la taille de la table. » Traitez-le comme des directives, pas comme un filtre garanti : comme toute instruction donnée à un LLM, elle est généralement suivie, non strictement appliquée.
- La fréquence d’analyse contrôle la fréquence à laquelle Insights évalue votre télémétrie (par exemple, toutes les heures). Ceci est distinct de la rapidité avec laquelle la télémétrie brute arrive dans Unity Catalog, ce qui se produit en continu quoi qu’il arrive.
Insights enregistre ses conclusions dans un emplacement de Workspace , distinct de la destination Unity Catalog ci-dessus : la télémétrie brute atterrit sous forme de tables Delta, mais les insights eux-mêmes sont des fichiers dans votre Databricks Workspace.
Attribuer aux projets
Sélectionnez les projets Lakebase existants auxquels cette configuration s’applique, puis enregistrez. Le définir comme default du Workspace à l’étape précédente couvre les projets créés à partir de maintenant ; l’attribuer ici permet d’appliquer la même configuration à vos projets existants.
Après l’enregistrement :
- Confirmez que le compute est en cours d’exécution.
- Si vous avez activé l’observabilité sur une instance déjà en cours d’exécution, redémarrez l’instance pour que la modification prenne effet. Pendant la version bêta, la télémétrie ne commence pas à circuler sur une instance déjà en cours d’exécution tant qu’elle n’a pas redémarré.
Étapes suivantes
- Trouver et résoudre les problèmes avec Insights: activez le monitoring proactif et apprenez à interpréter les résultats.
- Diagnostiquer et résoudre les problèmes avec Genie: enquêtez sur un problème de manière conversationnelle et suivez le processus de récupération de bout en bout.