Encontre e resolva problemas com percepções
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.
Percepções é um agente de background que periodicamente revisa a telemetria de um projeto do Lakebase e apresenta problemas e avisos antecipados sem que você precise perguntar. Esta página ativa as percepções para um projeto e, em seguida, detalha uma percepção real de ponta a ponta: o que ela encontrou, por que é importante e como responder.

Para uma alternativa conversacional e sob demanda, ou para continuar investigando uma percepção, consulte Diagnostique e corrija problemas com o Genie.
Não há cobrança separada para observabilidade. Seu custo está incluído nos produtos já utilizados: a exportação de telemetria conta para seu uso de ingestão, o armazenamento como tabelas Delta no Lakehouse conta para seu armazenamento gerenciado pelo Databricks, e o uso do Genie conta para seu uso do Genie.
Pré-requisitos
- Um projeto de autoscale do Lakebase na AWS ou Azure, com um compute em execução.
- Um catálogo e esquema do Unity Catalog para receber telemetria (não default storage ).
Ative as percepções e leia sua primeira descoberta
Ativar Percepções para um projeto
Execuções de percepções por projeto, controladas por uma configuração de observabilidade. Se você ainda não tem um, crie e atribua um primeiro.
No assistente de configuração, certifique-se de que Ativar percepções esteja ativado. Sem isso, uma configuração pode gravar telemetria no Unity Catalog sem exibir nada proativamente. Você também pode definir uma Frequência de análise para a frequência com que o Insights avalia sua telemetria.
Encontre uma percepção
As percepções são executadas em um programar recorrente, não continuamente, portanto, espere um atraso entre a ocorrência de um problema real e o aparecimento de uma percepção para ele. Aguarde um tempo após ativar o agente, especialmente logo após habilitá-lo em um novo projeto.
As percepções aparecem em dois lugares:
- A lista de todo o Workspace : na navegação esquerda, clique em Percepções . Ele agrega percepções em todos os projetos aos quais a configuração se aplica. Use Pesquisar ou Filtrar por para restringi-lo, por exemplo, por projeto ou gravidade.
- Uma view de um único projeto : abra o projeto, vá para Monitoramento e selecione a tab Percepções. Isso mostra apenas as percepções desse projeto.
Cada linha mostra uma Severidade (por exemplo, Menor ou Moderado), o título da Percepção , de qual Projeto ela é, a Janela de tempo que o problema abrange e um Status que você define (por exemplo, Aberto).
Ao contrário da telemetria bruta, que chega como tabelas Delta no Unity Catalog, as descobertas que o Insights gera são salvas como arquivos em uma pasta do Workspace, no Databricks Workspace da identidade com a qual sua configuração escreve.
Ler uma percepção
Clique em uma percepção para abrir sua página de detalhes. Cada percepção segue a mesma estrutura, que é lida de cima para baixo como um diagnóstico, não apenas uma notificação:
- Resumo : o que está acontecendo, em linguagem simples.
- Evidência : os sinais e valores específicos que sustentam o diagnóstico, em uma tabela.
- Recomendações : próximos passos concretos, com a justificativa por trás de cada um.
O que o Insights encontra e como ele formula o diagnóstico, depende inteiramente da sua própria telemetria, portanto, a percepção que você vê não corresponde àquela abaixo. A seguir está uma percepção real, incluída para mostrar o nível de detalhes que você pode esperar.

Neste exemplo, "Sessão parada bloqueou 4 atualizações", o subtítulo já indica onde procurar: "Sessão parada manteve bloqueios; esperas de UPDATE totalizaram 749 s". O resumo explica o que aconteceu: uma sessão abriu uma transação, ficou parada (idle) enquanto ainda mantinha um bloqueio de linha e permaneceu assim por aproximadamente 9,5 minutos até que o próprio tempo limite de idle-in-transaction do banco de dados a fechasse forçadamente. A tabela de evidências comprova isso com os números específicos, incluindo a entrada de log de encerramento e um total de 749 segundos de tempo de espera de UPDATE distribuídos em 4 chamadas, com média de 187 segundos cada para atualizações que normalmente seriam concluídas em milissegundos.
Recomendações:
- Ajuste
idle_in_transaction_session_timeoutpara um valor seguro, como 30-60 segundos, para que uma sessão ociosa libere seus bloqueios rapidamente em vez de bloquear outras queries por minutos.- Audite transações não fechadas e use o agrupamento de conexões com tempos limite de checkout curtos , para que um cliente que abre uma transação e fica parado não possa manter um bloqueio indefinidamente.
Observe o que a evidência quantifica: não apenas "as queries estavam lentas," mas exatamente qual sessão a causou, quanto tempo ela manteve o bloqueio e quanto tempo de espera isso custou a outras queries. A gravidade é inferida dos dados disponíveis, então leia as Evidências para confirmar a causa raiz antes de agir apenas com base na gravidade.
Responda a uma percepção
Depois de ter lido uma percepção, você tem três maneiras de fechar o ciclo:
- Aplique a recomendação por si mesmo , usando as evidências e recomendações como um guia.
- Clique em Corrigir com Genie na página de detalhes da percepção para encaminhá-la ao agente interativo e continuar a investigação de forma conversacional. Isso é útil quando a recomendação exige mais contexto antes de se tomar uma ação, ou quando a correção envolve uma alteração no lado do banco de dados. Consulte Diagnosticar e corrigir problemas com o Genie.
- Atualizar Status (por exemplo, para descartar ou marcar como resolvido) depois de tê-lo abordado ou determinado que nenhuma ação é necessária.
Um achado pode desaparecer por si só
Como as percepções reavaliam em sua própria programação, uma descoberta pode sair da lista mesmo que você nunca altere seu status: um evento transitório como um carregamento em massa único pode não se repetir em uma janela posterior, ou o compute por trás dele pode escalar para zero e reiniciar do zero com a sessão problemática encerrada. Uma descoberta que sai da lista ativa não significa que foi descartada ou que algo deu errado. Isso reflete que a condição não está mais presente na janela de avaliação mais recente.
A visualização de percepções requer acesso ao **Workspace** no workspace, separado de qualquer permissão necessária para criar a configuração. Um usuário sem acesso ao Workspace não consegue abrir as percepções mesmo que consiga visualizar o projeto.
Próximos passos
- Diagnosticar e corrigir problemas com o Genie : continue uma investigação de forma conversacional ou comece uma nova do zero.
- Referência da tabela de telemetria : as tabelas que o Insights lê e as limitações atuais.
- Observe projetos Lakebase: Veja o restante das ferramentas de observabilidade. Consulte Observabilidade.