Comece a usar o Genie ZeroOps

info

Visualização

Esse recurso está em Prévia privada. Para experimentar, fale com o seu contato no Databricks.

Para começar a usar o Genie ZeroOps, escolha os jobs, pipelines e tabelas que ele monitora na página Jobs & Pipelines . Em seguida, o Genie ZeroOps preenche retroativamente as percepções das 24 horas anteriores e continua relatando novos problemas para que você os analise e resolva. Para obter uma visão geral, consulte Genie ZeroOps.

Requisitos

• Um workspace do Databricks que está inscrito na Prévia privada do Genie ZeroOps.
• Permissão OWNER (Proprietário), CAN MANAGE (Pode gerenciar) ou CAN VIEW (Pode exibir) nos jobs, pipelines ou tabelas que você deseja monitorar.
• Para detectar problemas de qualidade de dados, o Genie ZeroOps ativa o monitoramento da qualidade de dados nos esquemas e tabelas que você escolher monitorar. Monitoramento de jobs não ativa esse recurso. Embora o Genie ZeroOps Private Preview seja gratuito, o monitoramento da qualidade dos dados é cobrado separadamente pelo preço padrão.
• Opcional: Para jobs que executam código de um Git repository, uma credencial Git com acesso de leitura ao repository. Para criar solicitações pull de correções, a credencial também precisa de acesso de gravação. Consulte Adicionar credenciais Git.

Configurar o Genie ZeroOps

1. Na barra lateral, clique em Jobs e pipelines para abrir a página Jobs e pipelines .

2. Clique no botão Open ZeroOps .

3. Se você ainda não configurou o Genie ZeroOps, será solicitado que o faça. Clique no botão Configurar para abrir o chat do Genie Code.

4. Quando o Genie Code solicitar quais recursos monitorar, selecione um escopo sugerido ou descreva o seu próprio em linguagem natural:

prompt

Diga ao Genie Code o que monitorar, por exemplo:

all owned jobs

Após definir o escopo, o Genie ZeroOps analisa os ativos selecionados, preenchendo retroativamente as percepções das últimas 24 horas para jobs que já falharam e para tabelas que estão desatualizadas ou incompletas. Em seguida, ele exibe todas as percepções encontradas para problemas dentro desse escopo.

Você pode selecionar o botão Configurar a qualquer momento para ajustar o que o Genie ZeroOps monitora. Consulte Atualizar configuração do Genie ZeroOps.

Revisar uma percepção e sua causa raiz

Além de abrir a caixa de entrada do Genie ZeroOps na página Jobs e pipelines , você também pode acessá-la pelo Genie Code em página inteira, onde ela aparece na lista de tópicos como ZeroOps Inbox .

1. Na caixa de entrada, clique em uma percepção aberta para abrir sua thread.
2. Revise a análise da causa raiz e a correção proposta.
3. No mesmo thread de percepção, peça ao Genie Code para aplicar a correção proposta. Como alternativa, siga o link para a fonte e aplique a correção você mesmo.
4. O Genie Code aplica a correção diretamente ao código armazenado no workspace. Para ativos armazenados no Git, ele ajuda você a abrir um pull request. Consulte Criar um pull request a partir de uma correção.
5. Para marcar a percepção como resolvida, clique em Resolver na caixa de entrada. Caso contrário, o Genie ZeroOps marca automaticamente uma percepção como resolvida após a próxima execução de job bem-sucedida. O status geralmente é atualizado em 15 minutos.

Criar uma solicitação pull de uma correção

Se um Job faz a execução de código de um repositório Git e a correção é uma alteração de código, você pode fazer com que o Genie ZeroOps envie a correção para uma nova Branch e, em seguida, abra um pull request. O Genie ZeroOps prepara a alteração durante sua investigação e mostra uma opção Criar PR na percepção. Ele não envia nada para seu repository até que você instrua explicitamente a fazê-lo.

1. Na caixa de entrada, clique na percepção para abrir sua thread.
2. Revise a correção proposta. Para alterá-la, descreva a alteração desejada no tópico.
3. Clique em Criar PR e confirme o push quando solicitado. O Genie ZeroOps faz o commit da correção em um novo branch e faz o push.
4. Para abrir uma solicitação pull, clique no link na resposta do Genie ZeroOps ou crie a solicitação pull da nova branch se a resposta não tiver um link. Em seguida, solicite a revisão e o merge da pull request pelo seu processo padrão.

Atualizar configuração do Genie ZeroOps

Para alterar o que o Genie ZeroOps monitora após a configuração, clique em Configure no canto superior direito da caixa de entrada. Um chat do Genie Code é aberto, onde você descreve os jobs, pipelines e tabelas que deseja incluir ou excluir.

Compartilhe sua configuração do Genie ZeroOps

Compartilhe sua configuração com outros usuários em seu workspace para que eles possam trabalhar nas percepções que ela gera. A caixa de entrada deles lista as percepções da sua configuração com Shared with me (Compartilhado comigo) na coluna Source Config (Configuração de origem), ao lado das próprias percepções deles.

nota

Os usuários com quem você compartilha veem os trechos de código, correções sugeridas e linhas de dados de amostra incluídas nas percepções, mesmo que não tenham acesso aos ativos subjacentes. O compartilhamento não lhes dá acesso aos ativos propriamente ditos.

1. No canto superior direito da caixa de entrada, clique em Configure para abrir o chat do Genie Code.
2. No cartão Configuração do ZeroOps , clique em Compartilhar .
3. Clique em Select user... (Selecionar usuário...), escolha um usuário do workspace e clique em Add (Adicionar). Repita para cada usuário com quem deseja compartilhar.
4. Clique em Salvar .

Para parar o compartilhamento com um usuário, abra a caixa de diálogo Compartilhar , clique no ícone de remover ao lado do usuário e clique em Salvar .

O que os usuários compartilhados podem fazer

Os usuários com os quais você compartilha possuem a permissão CAN MANAGE INSIGHTS (Pode gerenciar percepções) em sua configuração. Eles podem fazer o seguinte:

• Abra as percepções da sua configuração e revise a causa raiz e a correção proposta.
• Acompanhe uma percepção em seu próprio thread, onde eles podem perguntar sobre a causa raiz ou refinar a correção proposta.
• Marque uma percepção como Não é um problema . O status muda para todos que podem ver a percepção.

Os usuários com os quais você compartilha não podem alterar sua configuração, incluindo o que ela monitora, com quem é compartilhada e suas configurações de notificação.

Personalizar instruções de investigação

As instruções personalizadas dizem ao Genie ZeroOps o que ele deve e não deve fazer ao investigar seus problemas. Por exemplo, você pode dizer para ele verificar a atualização dos dados upstream antes de recomendar uma nova tentativa, ou seguir o passo específico quando vir um erro específico.

Suas instruções personalizadas se aplicam apenas a investigações para sua configuração do Genie ZeroOps e são armazenadas em um arquivo Markdown na sua pasta home:

Text

/Workspace/Users/<your-username>/.assistant/zeroops/instructions.md

Access to this file follows the same workspace permissions as any other workspace file.

Editar instruções

Usando a interface de chat

1. No canto superior direito da caixa de entrada, clique em Configure para abrir o chat do Genie Code.

2. Descreva sua orientação em linguagem natural:

prompt

Tell Genie Code what Genie ZeroOps should do, for example:

Text

When a job fails, check upstream data freshness before recommending a retry.

O Genie Code adiciona suas orientações às instruções, e investigações futuras levam isso em consideração.

Edições diretas

1. In the Genie Code configuration chat, find the Your ZeroOps configuration card and click View .
2. Em Custom instructions , clique em this file .
3. Edite o arquivo. Você também pode descrever suas alterações no chat aberto ao lado dele.

Quando o arquivo de instruções tiver conteúdo, a seção Instruções personalizadas exibirá Configurado .

Limitações

• Novas investigações sobre problemas em sua configuração carregam suas instruções. Salvar instruções não altera uma investigação que já está em andamento.
• O Genie ZeroOps lê apenas os primeiros 20.000 caracteres do arquivo. Mantenha suas instruções concisas e específicas, pois orientações irrelevantes ou conflitantes podem reduzir a qualidade da investigação.
• Cada relatório de investigação indica se utilizou suas instruções.
• As instruções não podem substituir as restrições de segurança ou as permissões de ferramentas do Genie ZeroOps. Se o Genie ZeroOps não aplicar uma instrução, ele explicará brevemente o motivo no relatório de investigação.

Filtrar percepções

1. Clique em Filter .
2. Selecione um status, como Resolvido .
3. Aplique o filtro para atualizar a caixa de entrada.

Solução de problemas

• Nenhuma percepção aparece depois de configurar o Genie ZeroOps : Verifique se você tem permissão OWNER (Proprietário), CAN MANAGE (Pode gerenciar) ou CAN VIEW (Pode visualizar) nos jobs, pipelines ou tabelas que você espera ver. O Genie ZeroOps monitora apenas os ativos para os quais você tem permissão.
• O Genie ZeroOps não pode acessar um repository : sua credencial Git está faltando, expirou ou não pode acessar o repository. Clique no seu nome de usuário, selecione Configurações > account vinculadas e adicione ou atualize a credencial. Consulte Adicionar credenciais Git.
• Um entendimento não mostra o Create PR : Verifique se o Job executa código de um repositório Git e se sua credencial Git pode acessar o repositório. O Genie ZeroOps oferece o Create PR somente quando a correção é uma alteração de código.
• O Genie ZeroOps não pode fazer push da correção : sua credencial Git precisa de acesso de escrita ao repository. Clique no seu nome de usuário, selecione Configurações > account vinculadas e atualize a credencial para que ela tenha acesso de escrita. Em seguida, peça ao Genie ZeroOps para fazer push da correção novamente.