Criar uma investigação do Cloud Assist

Nesta página, mostramos como criar e analisar investigações do Gemini Cloud Assist usando o console Google Cloud .

Antes de começar

  1. Verifique se o projeto tem as seguintes APIs ativadas:

    • cloudaicompanion.googleapis.com
    • cloudasset.googleapis.com
    • cloudresourcemanager.googleapis.com
    • geminicloudassist.googleapis.com
    • (Recomendado) logging.googleapis.com
    • (Recomendado) monitoring.googelapis.com

    Consulte Como ativar e desativar serviços para instruções sobre como ativar APIs.

  2. Para receber as permissões necessárias para criar uma investigação, peça para o administrador conceder a você o papel do IAM de Criador de investigações (roles/geminicloudassist.investigationCreator) no projeto.

    Esse papel predefinido contém a permissão necessária para criar uma investigação no projeto. Ao criar uma investigação, você recebe o papel do IAM de Proprietário da investigação (roles/geminicloudassist.investigationOwner) nela, o que permite analisar os resultados.

  3. Ter acesso ao produto em investigação.

    Quando você faz uma investigação, o Gemini Cloud Assist usa suas credenciais para acessar APIs e informações. Isso significa que o acesso da investigação é limitado ao seu acesso.

  4. Se você planeja fazer uma investigação em um aplicativo, ele precisa estar no App Hub.

Criar uma investigação

  1. Para criar uma nova investigação, clique no botão Investigar associado ao seu ponto de entrada. Um ponto de entrada típico para criar uma investigação é a página Investigações do Cloud Assist.

    Acessar as investigações do Cloud Assist

  2. (Opcional) Insira um Nome para a investigação.

    O nome escolhido identifica essa investigação no histórico de investigações. Se você pular essa etapa, um nome será gerado automaticamente para a investigação.

  3. Selecione o Horário de início do problema que você está investigando.

  4. (Opcional) Selecione o Horário de término quando o problema que você está investigando terminar.

  5. Revise o projeto ou o aplicativo ao qual a investigação será limitada.

    • Se a investigação for criada em um projeto, ele será selecionado e não poderá ser editado.

    • Se a investigação for criada em uma pasta habilitada para apps, um aplicativo do App Hub poderá ser selecionado.

  6. Descreva o problema que você está enfrentando.

    Você pode copiar e colar a mensagem de erro exata que recebeu, usar linguagem natural para explicar o problema que está enfrentando ou incluir as duas opções.

  7. Na seção Recursos relevantes do projeto, selecione os recursos afetados pelo problema que você está enfrentando. Se você incluir informações no campo Mensagem de erro, adicionar recursos relevantes será opcional, mas ainda será recomendado.

    É possível adicionar recursos usando o seletor ou inserindo-os manualmente com a seguinte estrutura:

    //API_NAME/projects/PROJECT/locations/LOCATION/resource/RESOURCE

    A investigação vai falhar se você incluir qualquer um dos seguintes itens:

    • Recursos que estão em um projeto ou aplicativo fora do escopo da investigação.
    • Recursos que não são compatíveis.
    • Recursos que não são reconhecidos.

  8. Clique em Criar para iniciar a investigação.

A conclusão da investigação poderá levar vários minutos. Para verificar o status da investigação, clique no botão Notificações ().

Analisar uma investigação

Quando a investigação for concluída, você poderá conferir os detalhes dela ponto de entrada em que a iniciou ou no histórico de investigações do projeto.

Uma investigação contém as seguintes seções:

  1. O Problema

    Essa seção contém as informações de entrada usadas para gerar os resultados da investigação, como a descrição do problema, carimbos de data/hora e listas de recursos relevantes. Há três tipos de lista de recursos que podem ser associadas à investigação:

    • Recursos fornecidos pelo usuário: recursos fornecidos pelo usuário ou buscados no erro inicial.
    • Recursos descobertos: recursos adicionais considerados pelo Gemini durante a investigação.
    • Recursos relevantes: os recursos que o Gemini considera relevantes para a hipótese de causa raiz, que sempre inclui recursos fornecidos pelo usuário.

  2. As Observações

    Esta seção contém observações geradas pela investigação. As observações são baseadas em análises de runbooks de procedimentos, registros, mensagens de interrupção e alertas. Com base nessas observações, o Gemini gera hipóteses sobre a causa raiz do problema que você está investigando.

  3. As Hipóteses

    Esta seção contém uma ou mais hipóteses com base nos dados coletados e nas observações feitas pela investigação. Uma hipótese contém uma visão geral do que o problema pode ser e correções recomendadas, que são ações que ajudam a corrigir o problema ou fornecem etapas adicionais de solução de problemas para confirmar ou refutar a hipótese.

A seguir