Pular para o conteúdo principal
Última atualização em

Configurar observabilidade

info

Beta

Esse recurso está em Beta. Administradores do Workspace podem controlar o acesso a este recurso na página **Pré-visualizações**. Consulte Gerenciar prévias do Databricks.

Uma configuração de observabilidade captura telemetria profunda do Postgres do Lakebase como tabelas Delta no Unity Catalog. Percepções, Genie e os painéis são executados com base nestes dados; um projeto não possui nenhum deles até que uma configuração seja anexada.

Uma configuração é um único objeto que pode abranger um ou muitos projetos. Existem duas maneiras de anexar uma identidade a ele, e elas coexistem por design:

  • Um administrador do workspace define uma configuração de service principal como o default do workspace, para que todo novo projeto obtenha observabilidade automaticamente.
  • Um proprietário de projeto individual configura seu próprio projeto com credenciais de identidade de usuário.

Um workspace normalmente acaba com uma mistura: a maioria dos projetos no default compartilhado, alguns com suas próprias configurações. Esta página cobre a configuração completa para ambos os caminhos. Para configurar um único projeto de sua propriedade, consulte o início rápido.

Pré-requisitos​

  • A prévia da Telemetria avançada do Lakebase Postgres está ativada para seu workspace. Um administrador do workspace a ativa na página de visualizações.
  • Um projeto de Lakebase Autoscaling na AWS ou no Azure. Consulte Obter um banco de dados Postgres.
  • Um catálogo e um esquema do Unity Catalog para receber telemetria. O esquema já deve existir, e o catálogo não pode usar Default storage .

Configurar a definição​

Escolha uma identidade. A configuração grava a telemetria no Unity Catalog como uma identidade que você seleciona no assistente. Essa escolha determina o alcance da configuração e por quanto tempo ela dura:

  • Escolha um service principal para uma configuração durável que não esteja vinculada à conta de nenhuma pessoa. Esta é a opção ideal para padronizar a observabilidade: defina-a como default do workspace e atribua-a a projetos existentes. A seleção de um service principal é restrita ao administrador do workspace, e você deve provisioná-lo primeiro (passo 1 abaixo).
  • Escolha credenciais de nível de usuário para configurar um projeto sob seu próprio acesso, sem nada para provisionar. Isso é adequado para um projeto individual de sua propriedade. Isso está delimitado às suas permissões, portanto, ignore o passo de provisionamento de service-principal e comece em Abrir o assistente de configuração.

Provisionar o Service Principal​

Se você estiver usando credenciais de nível de usuário, pule para Abrir o assistente de configuração.

Conceda ao service principal as quatro permissões abaixo antes de criar a configuração, para que ele esteja pronto para ser selecionado no assistente. Eles são independentes e cada um é concedido em um local diferente. Se algo estiver faltando, a configuração ainda será salva, mas a telemetria não será gravada silenciosamente e nenhuma percepção será gerada, sem nenhum erro para indicar a causa. Se uma configuração não produzir telemetria, verifique estes itens primeiro.

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: USE CATALOG on the catalog, USE SCHEMA and CREATE TABLE on the schema.

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: USE CATALOG on the catalog, USE SCHEMA and CREATE TABLE on the schema.

Conceda acesso ao Workspace e CAN USE em Settings > Identity and access > Service Principal . Conceda os privilégios do Unity Catalog no Catalog Explorer ou com SQL:

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>`;
nota

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.

Abrir o assistente de configuração​

Abra o assistente a partir de qualquer um dos locais. Ambos abrem o mesmo assistente:

  • Em **Lakebase** > **Percepções** > **Gerenciar configurações** > **Adicionar nova configuração**
  • Nas próprias Settings do projeto > Observability config > Create new config

Conclua os três passos do assistente a seguir em ordem, clicando em Próxima entre eles.

Configurar​

Nomeie a configuração e selecione onde sua telemetria será direcionada. Duas opções aqui merecem uma pausa:

  • Tornar esta uma configuração default para novos projetos torna esta a configuração default do workspace: todo novo projeto criado no workspace recebe esta configuração automaticamente, sem nenhuma ação do seu criador. Ative isso para padronizar a observabilidade em todo o workspace. Um Workspace tem no máximo um default, e o default se aplica apenas a projetos criados posteriormente, portanto, você também o atribui a projetos existentes no Atribuir a projetos o passo. Deixe desativado se você quiser que esta configuração se aplique a projetos específicos em vez de todo o workspace.
  • Identidade (em Autorizar o Lakebase a gravar seus dados ) é a account como a qual o Lakebase grava a telemetria, seguindo a escolha que você fez em Escolher uma identidade. Selecione Usar service principal e escolha o principal que você provisionou, ou selecione Usar credenciais de nível de usuário para executar como você mesmo. Somente os administradores do workspace podem selecionar um Service Principal.

Em Send telemetry to Unity Catalog , escolha o Catalog e o Schema onde as tabelas serão armazenadas e, opcionalmente, um prefixo de tabela. Você está escolhendo um destino, não projetando um: o Lakebase cria as tabelas listadas em What gets captured na primeira vez que grava telemetria. O esquema já deve existir e o catálogo não pode usar Default storage . Como Use default storage é selecionado por default ao criar um catálogo no Explorador de Catálogos, certifique-se de desmarcá-lo para o catálogo que você usa aqui.

Ativar percepções​

Certifique-se de que **Habilitar percepções** esteja ativado. É o que faz a execução do agente de percepções em segundo plano. Sem isso, uma configuração grava a telemetria no Unity Catalog, mas não exibe nada proativamente. Dois campos relacionados aparecem:

  • Instruções é um texto livre que o agente lê antes de cada passagem de análise, por exemplo, "Não gere percepções sobre o tamanho da tabela." Trate-o como orientação, não como um filtro garantido: como qualquer instrução dada a um LLM, geralmente é seguida, não estritamente aplicada.
  • A frequência de análise controla com que frequência o Percepções avalia sua telemetria (por exemplo, a cada hora). Isso é separado da rapidez com que a telemetria bruta chega ao Unity Catalog, o que acontece continuamente de qualquer maneira.

Os entendimentos salvam seus achados em um **local do Workspace**, distinto do destino do Unity Catalog acima: a telemetria bruta é gravada como tabelas Delta, mas os entendimentos em si são arquivos em seu próprio Databricks Workspace.

Atribuir a projetos​

Selecione os projetos Lakebase existentes aos quais esta configuração se aplica e, em seguida, salve. Defini-lo como o default do workspace na etapa anterior abrange os projetos criados a partir de agora; atribuí-lo aqui coloca seus projetos existentes sob a mesma configuração.

Após salvar:

  • Confirme se o compute está em execução.
  • Se você ativou a observabilidade em uma instância que já estava em execução, reinicie a instância para que a alteração entre em vigor. Durante a versão Beta, a telemetria não começa a fluir em uma instância já em execução até que ela seja reiniciada.

Próximos passos​

Nesta página