Configurer l’observabilité

Important

Cette fonctionnalité est en version bêta. Les administrateurs d’espace de travail peuvent contrôler l’accès à cette fonctionnalité à partir de la page Aperçus . Consultez Gérer les préversions d’Azure Databricks.

Une configuration d’observabilité capture la télémétrie profonde de Lakebase Postgres sous forme de tables Delta dans le catalogue Unity. Insights, Genie et les tableaux de bord fonctionnent tous sur ces données ; Un projet n’en possède aucune tant qu’une configuration n’est pas jointe.

Une configuration est un objet unique qui peut couvrir un ou plusieurs projets. Il existe deux façons d’y attacher une identité, et elles coexistent par conception :

  • Un administrateur d’espace de travail définit une configuration principale de service comme valeur par défaut de l’espace de travail, de sorte que chaque nouveau projet obtient automatiquement de l’observabilité.
  • Un propriétaire de projet individuel configure son propre projet avec les identifiants d’identité utilisateur.

Un espace de travail finit généralement avec un mélange : la plupart des projets sont sur le partage par défaut, certains avec leurs propres configurations. Cette page couvre toute la configuration pour chaque chemin. Pour créer un seul projet que vous possédez, consultez le démarrage rapide.

Prerequisites

  • La version préliminaire de la télémétrie Postgres avancée de Lakebase est activée pour votre espace de travail. Un administrateur d’espace de travail l’active à partir de la page Aperçus.
  • Un projet Lakebase sur AWS ou Azure. Consultez Obtenir une base de données Postgres.
  • Catalogue Unity et schéma pour recevoir des données de télémétrie. Le schéma doit déjà exister et le catalogue ne peut pas utiliser le stockage par défaut.

Configurez la configuration

Choisissez une identité. La configuration enregistre les données de télémétrie dans Unity Catalog sous l’identité que vous sélectionnez dans l’assistant. Ce choix détermine jusqu’où la configuration s’étend et combien de temps elle dure :

  • Choisissez un principal de service pour une configuration durable qui n’est pas liée au compte d’une seule personne. C’est la bonne adéquation pour standardiser l’observabilité : définissez-la comme espace de travail par défaut, et assignez-la à des projets existants. La sélection d’un principal de service est réservée à l’administration de l’espace de travail, et vous le provisionnez d’abord (étape 1 ci-dessous).
  • Choisissez des identifiants au niveau utilisateur pour configurer un projet sous votre propre accès, sans rien à provisionner. Cela convient à un projet individuel que vous possédez. Il est limité à vos permissions, donc sautez l’étape de provisionnement du principal de service et commencez par Ouvrir l’assistant de configuration.

Créer le principal de service

Si vous utilisez des identifiants utilisateur, passez à Ouvrir l’assistant de configuration.

Accordez au principal de service les quatre autorisations ci-dessous avant de créer la configuration, pour qu’il soit disponible à la sélection dans l’assistant. Ils sont indépendants, et chacun est accordé dans un endroit différent. S’il en manque un, la configuration est tout de même enregistrée, mais la télémétrie n’arrive jamais et aucune information exploitable n’est générée, sans aucun message d’erreur pour en indiquer la cause. Si une configuration ne produit aucune télémétrie, vérifiez d’abord ces points.

Grant Où le placer Pourquoi il est nécessaire
Accès à l’espace de travail L’onglet Configurations du directeur, sous Droits Permet au principal de service d’agir dans l’espace de travail, tout court. Sans cela, Lakebase écrit la télémétrie comme une identité qui ne peut rien faire, donc toutes les tables de télémétrie restent vides.
Administrateur de l’espace de service Paramètres > Identité et accès > Groupes : ouvrez le groupe admins et ajoutez le principal L’agent en arrière-plan nécessite actuellement un accès administrateur pour écrire des données de télémétrie et générer des insights.
PEUT L’UTILISER L’onglet Autorisations du principal Permet de sélectionner le principal dans le magicien. La création d’un principal de service octroie l’autorisation PEUT GÉRER, qui n’inclut pas PEUT UTILISER ; vous devez donc accorder explicitement cette dernière. Consultez Rôles pour la gestion des principaux de service.
Privilèges du catalogue Unity Le catalogue de destination et le schéma (voir le SQL ci-dessous) Permet au principal de créer et d’écrire les tables de télémétrie : USE CATALOG sur le catalogue USE SCHEMA et CREATE TABLE sur le schéma.

Accordez l’accès à l’espace de travail et PEUT UTILISER dans Paramètres > Identité et accès > Principaux de service. Accordez des privilèges au catalogue Unity 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>`;

Note

L’exigence d’administration de l’espace de travail est une contrainte actuelle de la version Bêta et pourrait être réduite dans une version ultérieure. Autorisez-le pour l’instant afin que la télémétrie et les analyses fonctionnent.

Ouvre l’assistant de configuration

Ouvre le magicien à partir d’un endroit. Les deux ouvrent le même magicien :

  • À partir de Lakebase>Insights>Gérer les configurations>, ajoutez une nouvelle configuration
  • Depuis les Paramètres>Configuration d’observabilité>Créer une nouvelle configuration d’un projet

Terminez les trois étapes du sorcier qui suivent dans l’ordre, en cliquant sur Suivant entre elles.

Configurer

Donnez un nom à la configuration et sélectionnez où sa télémétrie est envoyée. Deux choix méritent qu’on s’y arrête :

  • Faites de cette configuration par défaut pour les nouveaux projets et en fait la configuration par défaut de l’espace de travail : chaque nouveau projet créé dans l’espace de travail se voit attribuer cette configuration automatiquement, sans aucune action de la part de son créateur. Activez cela pour standardiser l’observabilité à l’échelle de l’espace de travail. Un espace de travail a au maximum un par défaut, et ce par défaut ne s’applique qu’aux projets créés par la suite, donc vous l’assignez aussi aux projets existants dans l’étape Assigner aux projets . Laissez-le désactivé si vous voulez que cette configuration s’applique à des projets spécifiques plutôt qu’à tout l’espace de travail.
  • L’identité (sous Autoriser Lakebase à écrire vos données) est le compte sous lequel Lakebase écrit la télémétrie, suivant le choix que vous avez fait dans Choisir une identité. Sélectionnez Utiliser le principal de service et choisissez le principal que vous avez créé, ou sélectionnez Utiliser les identifiants utilisateur pour l’exécuter en votre nom. Seuls les administrateurs d’espace de travail peuvent sélectionner un principal de service.

Sous Envoyer des données de télémétrie au catalogue Unity, choisissez le catalogue et le schéma dans lesquels les tables se trouvent, et éventuellement un préfixe de table. Vous choisissez une destination, pas une : Lakebase crée les tables listées dans Ce qui est capturé la première fois qu’il écrit la télémétrie. Le schéma doit déjà exister et le catalogue ne peut pas utiliser le stockage par défaut. Étant donné que l’utilisation du stockage par défaut est sélectionnée par défaut lorsque vous créez un catalogue dans l’Explorateur de catalogues, veillez à l’effacer pour le catalogue que vous utilisez ici.

Activer les analyses

Vérifiez que l’activation des insights est activée. C’est ce qui exécute l’agent Insights en arrière-plan. Sans cela, une configuration écrit des données de télémétrie dans le catalogue Unity, mais n’affiche rien de manière proactive. Deux champs connexes s’affichent :

  • Les instructions sont du texte libre lu par l’agent avant chaque passe d’analyse, par exemple « Ne pas générer d’insights sur la taille de table ». Traitez-le comme des conseils, pas un filtre garanti : comme toute instruction donnée à un LLM, il est généralement suivi, pas strictement appliqué.
  • La fréquence d’analyse contrôle la fréquence à laquelle Insights évalue votre télémétrie (par exemple, toutes les heures). Cela est distinct de la rapidité avec laquelle les données de télémétrie brutes atterrissent dans le catalogue Unity, ce qui se produit en continu indépendamment.

Insights enregistre ses résultats dans un Workspace location, distinct de la destination Unity Catalog ci-dessus : les données de télémétrie brutes arrivent sous forme de tables Delta, mais les insights proprement dits sont des fichiers dans votre propre espace de travail Azure Databricks.

Affecter à des projets

Sélectionnez les projets Lakebase existants auxquels cette configuration s’applique, puis enregistrez. Le définir comme espace de travail par défaut à l’étape précédente couvre les projets créés à partir de maintenant ; L’assigner ici permet de remettre vos projets existants sous la même configuration.

Après avoir sauvegardé :

  • Confirmez que le calcul est en cours.
  • 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. Durant la phase bêta, les données de télémétrie ne commencent pas à être transmises pour une instance déjà en cours d’exécution qu’après son redémarrage.

Étapes suivantes

  • Last updated on