Configurar a observabilidade

Importante

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a esse recurso na página Visualizações . Ver Gerir as pré-visualizações de Azure Databricks.

Uma configuração de observabilidade capta a telemetria profunda do Lakebase Postgres como tabelas Delta no Unity Catalog. Insights, Genie e os dashboards funcionam todos com estes dados; um projeto não tem nenhuma delas até que uma configuração seja anexada.

Uma configuração é um único objeto que pode abranger um ou vários projetos. Existem duas formas de lhe atribuir uma identidade, e coexistem por design:

  • Um administrador de espaço de trabalho define uma configuração de principal de serviço como padrão do espaço de trabalho, de modo que cada novo projeto recebe observabilidade automaticamente.
  • Um proprietário de projeto individual configura o seu próprio projeto com credenciais de identidade de utilizador.

Um espaço de trabalho normalmente acaba com uma mistura: a maioria dos projetos está no padrão partilhado, alguns com as suas próprias configurações. Esta página cobre toda a configuração para ambos os caminhos. Para configurar um único projeto que possui, consulte o quickstart.

Pré-requisitos

  • A pré-visualização do Lakebase Advanced Postgres Telemetry foi ativada para o seu espaço de trabalho. Um administrador do espaço de trabalho ativa-o a partir da página de Pré-visualizações.
  • Um projeto Lakebase de dimensionamento automático na AWS ou no Azure. Veja Obter uma base de dados Postgres.
  • Um catálogo e esquema do Unity Catalog para receber telemetria. O esquema já deve existir, e o catálogo não pode usar armazenamento predefinido.

Configurar a configuração

Escolhe uma identidade. A configuração escreve telemetria no Unity Catalog como uma identidade que selecionas no assistente. Essa escolha determina até onde a configuração chega e quanto tempo dura:

  • Escolha um principal de serviço para uma configuração duradoura que não esteja ligada à conta de uma única pessoa. Este é o encaixe certo para padronizar a observabilidade: defina-o como o padrão do espaço de trabalho e atribua-o a projetos existentes. Selecionar um principal de serviço é apenas para administrador de espaço de trabalho, e deve provisioná-lo primeiro (passo 1 abaixo).
  • Escolha credenciais ao nível do utilizador para configurar um projeto sob o seu próprio acesso, sem nada para provisionar. Isto adequa-se a um projeto individual que possui. Está ligado às tuas permissões, por isso salta a etapa de provisionamento do principal de serviço e começa pelo Abrir o assistente de configuração.

Provisão do principal do serviço

Se estiveres a usar credenciais a nível de utilizador, salta para o assistente de Abertura de configuração.

Conceda ao principal do serviço as quatro permissões abaixo antes de criar a configuração, para que esteja pronto para selecionar no assistente. São independentes, e cada um é concedido num local diferente. Se algum estiver em falta, a configuração ainda guarda, mas a telemetria nunca aterra silenciosamente e não são gerados insights específicos, sem erro que o aponte para a causa. Se uma configuração não produzir telemetria, verifique estas primeiro.

Grant Onde o colocar Por que é necessário
Acesso ao espaço de trabalho O separador Configurações do diretor, em Direitos Permite que o principal do serviço atue no espaço de trabalho. Sem isso, o Lakebase escreve a telemetria como uma identidade que não pode fazer nada, por isso todas as tabelas de telemetria ficam vazias.
Administrador de área de trabalho Configurações > Grupos de Identidade e Acesso>: abram o grupo de administradores e adicionem o principal O agente em segundo plano atualmente requer acesso de administrador para escrever telemetria e gerar insights.
PODE USAR Separador de Permissões do diretor Permite-te selecionar o principal no feiticeiro. Criar um principal de serviço concede PODER GERIR, que não inclui PODER USAR, por isso concede explicitamente. Ver Funções para gestão de principais de serviços.
Privilégios do Catálogo Unity O catálogo de destino e o esquema (ver o SQL abaixo) Permite ao principal criar e escrever as tabelas de telemetria: USE CATALOG no catálogo USE SCHEMA e CREATE TABLE no esquema.

Conceder acesso ao Workspace e CAN USE nas Definições > Identidade e princípios de serviço de acesso>. Conceda privilégios ao Catálogo Unity no Explorador de Catálogos ou com 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

Exigir a administração do espaço de trabalho é uma restrição atual da Beta e pode ser restringida numa versão futura. Autorize-o por enquanto para que a telemetria e as análises funcionem.

Abra o assistente de configuração

Abre o feiticeiro de qualquer um dos sítios. Ambos abrem o mesmo mago:

  • Do Lakebase>Insights>Gerir configurações>Adicionar nova configuração
  • Nas Definições>do próprio projeto Configuração de observabilidade>Criar nova configuração

Complete os três passos do mago que se seguem por ordem, clicando em Seguinte entre eles.

Configurar

Dê um nome à configuração e selecione para onde a respetiva telemetria é enviada. Duas opções aqui valem a pena parar:

  • Se isto for uma configuração padrão para novos projetos , isto é o padrão do workspace: cada novo projeto criado no workspace recebe esta configuração automaticamente, sem qualquer ação do criador. Ative isto para padronizar a observabilidade em todo o espaço de trabalho. Um espaço de trabalho tem, no máximo, um padrão, e o padrão aplica-se apenas a projetos criados depois, por isso também o atribuis a projetos existentes na etapa Atribuir a projetos . Deixa-o fora se quiseres que esta configuração se aplique a projetos específicos e não a todo o espaço de trabalho.
  • Identidade (em Autorizar Lakebase para escrever os seus dados) é a conta que a Lakebase escreve telemetria, seguindo a escolha que fez em Escolher uma identidade. Selecione Usar principal de serviço e selecione o principal que provisionou, ou selecione Usar credenciais ao nível de utilizador para executar como si próprio. Só os administradores de espaço de trabalho podem selecionar um principal de serviço.

Em Enviar telemetria para o Unity Catalog, escolha o Catálogo e o Esquema em que as tabelas são colocadas e, opcionalmente, um prefixo de tabela. Estás a escolher um destino, não a desenhar um: a Lakebase cria as tabelas listadas em O que é capturado na primeira vez que escreve telemetria. O esquema já deve existir, e o catálogo não pode usar armazenamento predefinido. Como a opção Usar armazenamento predefinido está selecionada por predefinição quando cria um catálogo no Catalog Explorer, certifique-se de a desmarcar para o catálogo que utiliza aqui.

Ativar informações detalhadas

Certifique-se de que o Enable insights está ativado. É isto que executa o agente do Insights em segundo plano. Sem isso, uma configuração escreve telemetria no Unity Catalog mas não apresenta nada de forma proativa. Aparecem dois campos relacionados:

  • Instruções são texto livre que o agente lê antes de cada análise passada, por exemplo: "Não gerar insights sobre o tamanho da tabela." Trate-a como orientação, não como um filtro garantido: como qualquer instrução dada a um LLM, normalmente é seguida, não estritamente aplicada.
  • A frequência de análise controla com que frequência o Insights avalia a sua telemetria (por exemplo, a cada hora). Isto é independente da velocidade com que a telemetria bruta chega ao Unity Catalog, uma vez que essa chegada ocorre continuamente em qualquer caso.

Insights guarda os seus resultados numa localização no Workspace, distinta do destino do Unity Catalog acima: a telemetria bruta é armazenada como tabelas Delta, mas os resultados são ficheiros no seu próprio Workspace do Azure Databricks.

Atribuir a projetos

Seleciona os projetos Lakebase existentes a que esta configuração se aplica e depois guarda. Defini-lo como o padrão do espaço de trabalho no passo anterior abrange projetos criados a partir de agora; Atribui-lo aqui traz os seus projetos existentes sob a mesma configuração.

Depois de gravar:

  • Confirma que o cálculo está a correr.
  • Se ativaste a observabilidade numa instância que já estava a correr, reinicia a instância para que a alteração tenha efeito. Durante a Beta, a telemetria não começa a ser enviada numa instância já em execução até que esta seja reiniciada.

Passos seguintes

  • Last updated on