Diagnosticar e corrigir problemas com o Genie

Na interface do usuário do Lakebase, o Genie diagnostica e corrige seu banco de dados. Você pergunta sobre um problema específico com suas próprias palavras, e ele investiga usando a mesma telemetria que Insights: estado do Postgres em tempo real, planos de consulta, eventos de espera e histórico de DDL e de alterações de esquema. Este é o mesmo Genie que você usa no Lakehouse e nos Apps; aqui ele funciona no seu projeto Lakebase.

O Genie funciona como uma conversa passo a passo: ele mostra seu raciocínio e pede que você aprove cada ação, incluindo as consultas executadas durante a investigação. Qualquer correção, incluindo uma alteração de banco de dados, precisa de sua confirmação explícita antes de ser aplicada.

Esta página percorre um incidente comum em produção (um deploy que remove uma coluna que a aplicação ainda consulta) para mostrar, de ponta a ponta, como é pedir ajuda ao Genie.

Pré-requisitos

• Um projeto Lakebase na AWS ou Azure, com observabilidade configurada. Consulte Configurar observabilidade.

Cenário

Uma alteração de esquema executa ALTER TABLE users DROP COLUMN bio como parte de um deploy de rotina. O aplicativo ainda lê essa coluna em sua página de perfil. Em poucos minutos, as solicitações de página de perfil começam a falhar column "bio" does not existe a taxa de erros do aplicativo sobe.

Como se desenrola uma investigação do Genie

O que o Genie encontra e recomenda depende dos seus dados e do problema subjacente, portanto, considere isto um exemplo ilustrativo, não um roteiro que você verá exatamente assim. Abra o Genie a partir do seu projeto (ele detecta automaticamente o projeto, a ramificação e o contexto do endpoint) e descreva o sintoma. A partir daí, uma investigação típica passa por quatro estágios:

Você descreve o sintoma

Pergunte em linguagem simples, a maneira como você diria a um colega: "Por que a taxa de erros está alta?" Você não precisa saber a causa, a consulta com falha ou qual tabela está envolvida.

Genie correlaciona e lê o histórico

Ele vincula o erro à consulta que falhou e, em seguida, verifica o histórico de DDL para ver o que mudou. O histórico de DDL não registra todas as alterações (uma mudança feita exatamente no momento em que a computação é retomada após um escalonamento para zero pode passar despercebida); portanto, quando um registro está ausente, o Genie informa isso e recorre à comparação entre as colunas atuais da tabela e o que a consulta espera. De qualquer forma, ele identifica bio como a coluna descartada. Esse é o mesmo histórico que o Insights lê, permitindo que o Genie continue de onde um insight de segundo plano parou.

Gênio propõe uma recuperação, baseada no que encontrou

Normalmente, tudo começa com um branch pontual criado logo antes da alteração: um clone instantâneo do tipo copy-on-write que compartilha o armazenamento com o ambiente de produção, sendo, portanto, econômico o suficiente para ser criado para qualquer correção. A partir desse ponto, a recuperação passa a ser uma conversa: o Genie pode copiar os dados ausentes de volta para a tabela atual ou mudar seu aplicativo para a ramificação restaurada. Alguns caminhos exigem alguma informação sua durante o processo, como uma cadeia de conexão que o Genie não consegue descobrir por conta própria.

Você confirma antes de aplicar qualquer coisa

O Genie nunca restaura, modifica ou aplica uma correção por conta própria. Ele relata as ações executadas, mas verifica as conseqüenciais (um ponto de restauração, um branch excluído) na interface do usuário do Lakebase antes que você confie nelas.

Limitações a serem observadas

• Alguns elementos genéricos da interface do usuário do Genie (como Personalizações, Automações, Espaços e Adicionar contexto) atualmente aparecem no Genie, mas ainda não estão funcionais.
• Uma conversa do Genie continuada fora da interface do Lakebase (por exemplo, em um notebook) mantém o histórico da conversa, mas perde as ferramentas e o contexto da página original. Inicie novas investigações de dentro do projeto Lakebase para obter os resultados mais confiáveis.
• Branches e os endpoints aparecem pelo ID interno, e não por um nome de exibição como "production". Se a resposta do Genie for ambígua quanto a qual branch ou endpoint está sendo referido, verifique o ID na interface do Lakebase. Para mais informações, veja as limitações de telemetria.

Próximas Etapas 

• Encontre e resolva problemas com o Insight: ative o monitoramento proativo para que questões como essa surjam antes mesmo de você perguntar.
• Referência da tabela de telemetria: as tabelas que o Genie lê e as limitações atuais.
• Restaurar um projeto: saiba mais sobre a recuperação em um ponto específico no tempo fora do Genie. Confira Recuperação pontual.