Pular para o conteúdo principal

Comece a usar o Genie ZeroOps

info

Beta

Esse recurso está em Beta. Para usá-lo, um administrador do workspace deve ativar o Genie ZeroOps na página Pré-visualizações . Consulte Gerenciar prévias do 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 com o preview do Genie ZeroOps ativado. Um administrador do workspace deve ativá-lo na página Pré-visualizações . Consulte Gerenciar prévias do Databricks.
  • Permissão OWNER (Proprietário), CAN MANAGE (Pode gerenciar) ou CAN VIEW (Pode exibir) nos jobs, pipelines ou tabelas que você deseja monitorar.
  • 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​

A caixa de entrada inicial do ZeroOps, solicitando que você configure os ativos a serem monitorados.

  1. Na barra lateral, clique em Ícone de fluxos de trabalho. 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 Ícone de código Sparkle Genie. 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 Ícone de código Sparkle Genie. Configurar a qualquer momento para ajustar o que o Genie ZeroOps monitora. Consulte Atualizar configuração do Genie ZeroOps.

Configurar notificações​

O Genie ZeroOps pode enviar uma notificação quando uma percepção aparece pela primeira vez em sua caixa de entrada. Ele é compatível com destinos Slack, Microsoft Teams, PagerDuty e webhook genérico. O Genie ZeroOps não oferece suporte a destinos de email no momento.

Antes de configurar notificações no Genie ZeroOps, um admin do workspace deve criar os destinos em seu workspace. Consulte Gerenciar destinos de notificação.

  1. No canto superior direito da caixa de entrada do Genie ZeroOps, clique em Ícone de código Sparkle Genie. Configurar .

  2. Peça ao Genie Code para configurar as notificações. Por exemplo:

prompt
Text
Send new ZeroOps insights to <destination-name>.

Se você não souber o nome de destino, pergunte a What notification destinations are available for ZeroOps insights? e, em seguida, escolha um destino na resposta. 3. No cartão Sua configuração ZeroOps , clique em view e revise as Notificações para confirmar os destinos salvos.

Exemplo: Criar itens de trabalho do Jira com um webhook​

Use um destino de webhook genérico e um fluxo de automação do Jira Cloud para criar um item de trabalho para cada nova percepção:

  1. No Jira Cloud, crie um fluxo de automação com um trigger de Webhook de entrada . Consulte Configurar o trigger do webhook de entrada na documentação do Atlassian.

  2. Adicione uma ação Criar item de trabalho . Use valores inteligentes do Jira para mapear os campos de webhook do Genie ZeroOps, por exemplo:

    Text
    Summary: {{webhookData.title}}

    Description:

    {{webhookData.insight_summary}}

    Asset type: {{webhookData.assets.first.asset_type}}
    Asset: {{webhookData.assets.first.asset_name}}
    View insight: {{webhookData.insight_link}}
  3. Peça a um administrador do workspace para criar um destino de notificação de Webhook com a URL do webhook de entrada do Jira. O Jira requer um segredo para webhooks de entrada. Como os destinos de notificação não suportam cabeçalhos personalizados, use o formato de URL que inclui o segredo, conforme descrito na documentação da Atlassian.

  4. No chat de configuração do Genie ZeroOps, selecione o novo destino de webhook.

  5. Quando uma nova percepção aparecer em sua caixa de entrada, verifique o Jira para ver o item de trabalho correspondente.

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.

Uma conversa de percepções do ZeroOps aberta, mostrando o que falhou, a análise de causa raiz e as evidências de suporte.

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

Se um Job faz uma 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 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 o 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 para enviar a correção para uma nova branch. Para fazer push para uma branch que você escolher, peça isso no thread:

prompt

Diga ao Genie ZeroOps para qual branch fazer push, por exemplo:

Text
Create a PR on the fix/daily-revenue branch
  1. Confirme o push quando solicitado. A confirmação mostra a branch para a qual o Genie ZeroOps faz push. O Genie ZeroOps então faz commit da correção para essa branch e faz push dela.

  2. Para abrir uma pull request, clique no link na resposta do Genie ZeroOps ou crie a pull request a partir da branch se a resposta não tiver um link. Em seguida, solicite a revisão e o merge da pull request por meio do seu processo normal.

A branch que você nomear pode ser nova ou existente. Você também pode nomear uma branch em suas instruções personalizadas, para que Criar PR faça push para essa branch.

Quando o Genie ZeroOps faz push para uma branch existente, ele adiciona a correção como um novo commit e não faz force-push, portanto, não sobrescreve a história da branch. Se um pull request já estiver aberto a partir da branch, o novo commit aparecerá nele.

Atualizar configuração do Genie ZeroOps​

Para alterar o que o Genie ZeroOps monitora após a configuração, clique em Ícone de código Sparkle Genie. 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.

A caixa de entrada do ZeroOps após a configuração, com uma percepção aberta e o botão Configurar no canto superior direito.

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 Ícone de código Sparkle Genie. 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 .

A caixa de diálogo Share your ZeroOps configuration (Compartilhar sua configuração de ZeroOps) abre sobre o chat do Genie Code, listando o proprietário com permissão CAN MANAGE (Pode gerenciar) e um usuário compartilhado com permissão CAN MANAGE INSIGHTS (Pode gerenciar percepções).

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 Ícone de código Sparkle Genie. 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.
  • O Genie ZeroOps não pode fazer push para a branch que você nomeou : verifique se seu provedor de Git permite pushes para essa branch. As regras de proteção de branch podem bloquear pushes diretos, por exemplo, para a branch default do seu repository. Como o Genie ZeroOps não força o push, ele não pode enviar uma correção que substituiria commit já presentes na branch.