Encontre e resolva problemas com percepções

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.

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.

nota

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 ).

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 **Habilitar percepções** esteja ativado. Sem ele, uma configuração pode gravar telemetria no Unity Catalog sem apresentar nada proativamente. Você também pode definir uma **frequência de análise** para a frequência com que as percepções analisam 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).

Como 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 apoiam o diagnóstico, em uma tabela.
• Recomendações — próximos passos concretos, com o raciocínio 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.

Exemplo: "Sessão inativa bloqueou 4 atualizações"

O subtítulo desta percepção, "Bloqueios mantidos por sessões ociosas; esperas de UPDATE totalizaram 749 s," já indica onde procurar:

O Resumo explica o que aconteceu: uma sessão abriu uma transação, ficou parada enquanto ainda mantinha um bloqueio de linha e permaneceu assim por aproximadamente 9,5 minutos até que o próprio tempo limite de transação inativa do banco de dados a encerrasse à força. A tabela de Evidências corrobora 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 UPDATES que normalmente seriam concluídos em milissegundos.

Recomendações:

1. Ajuste idle_in_transaction_session_timeout para 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.
2. 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.

nota

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

• Diagnostique e corrija problemas com o Genie — continue uma investigação de forma conversacional ou comece uma nova do zero.
• Visão geral da solução de problemas assistida por AI — como as Percepções e o Genie se encaixam e as limitações atuais.
• Observe projetos Lakebase: Veja o restante das ferramentas de observabilidade. Consulte Observabilidade.