Denunciar um host com falha

Se você notar problemas em uma VM H4D reservada que não pode ser resolvida de outra forma, como erros persistentes com o dispositivo RDMA, recomendamos que você informe o host como com falha. Quando você informa que um host está com falha, o Compute Engine faz o mesmo e corrige automaticamente a VM executando a manutenção do host. Para VMs H4D, o Compute Engine tenta migrar a VM para um host diferente quando a manutenção começa, o que pode ajudar a minimizar o tempo de inatividade da carga de trabalho.

Neste documento, explicamos como informar e corrigir hosts com falha para instâncias de máquina virtual (VM) que fazem parte de clusters baseados em VM. Para clusters do Google Kubernetes Engine (GKE), consulte Informar hosts com falha pelo GKE.

Limitações

Quando você denuncia um host com falha, as seguintes limitações se aplicam:

• Só é possível denunciar um host com falha se a VM que é executada nele atender a todas as seguintes condições:

  • A VM está em execução.

  • A VM usa um tipo de máquina H4D.

  • A VM usa o modelo de provisionamento vinculado à reserva.

• OCloud de Confiance by S3NS faz o possível para atender a todas as suas solicitações de relatório de host com falha. No entanto, devido a restrições de capacidade ou limites de taxa, uma solicitação nem sempre pode ser atendida.

Antes de começar

• Selecione a guia para como planeja usar as amostras nesta página:

  Console

  Quando você usa o console Cloud de Confiance para acessar serviços Cloud de Confiance by S3NS e APIs, não é necessário configurar a autenticação.

  gcloud

  Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:

  gcloud init

  REST

  Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para CLI gcloud.

  Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada.

  Saiba mais em Autenticar para usar REST na documentação de autenticação do Cloud de Confiance .

Funções exigidas

Para receber as permissões necessárias para denunciar um host com falha, peça ao administrador que conceda a você os seguintes papéis do IAM:

• Administrador da instância do Compute (v1) (roles/compute.instanceAdmin.v1) na VM ou no projeto
• Para conferir o estado de uma operação de relatório de host com falha usando o Cloud Logging: Visualizador de registros (roles/logging.viewer) no projeto

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para informar um host com falha. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Entender o processo de denúncia de hosts com falha

Depois de informar um host com falha para uma VM H4D, o tempo em que a VM H4D é reiniciada varia de acordo com o modo operacional da reserva usada para criar a VM. Para verificar o modo operacional de uma reserva, consulte o campo reservationOperationalMode na reserva.

Reportar um host com falha

Para informar um host com falha, siga estas etapas:

1. Revise o host em que a VM é executada.

   Para instruções, consulte Ver a topologia do cluster H4D.

2. Opcional: faça backup dos dados do SSD local. Quando a VM é interrompida, o Compute Engine descarta automaticamente os dados de todos os discos SSD locais anexados a ela. Não é possível recuperar dados do SSD local depois que o Compute Engine os descarta.

   Para instruções sobre como preservar os dados do SSD local, consulte Backup de dados do SSD local.

3. Denuncie o host com falha. Para denunciar um host com falha, selecione uma das seguintes opções. A operação de correção do host começa imediatamente, em até um minuto após a conclusão da operação de denúncia de host com falha. Se a VM não responder depois que você iniciar a operação de relatório de host com falha, aguarde pelo menos 15 minutos e reinicie a VM.

   gcloud

   Para informar um host com falha, use o seguinte comando gcloud compute instances report-host-as-faulty:

   gcloud compute instances report-host-as-faulty VM_NAME \
       --async \
       --disruption-schedule=IMMEDIATE \
       --fault-reasons=behavior=FAULT_REASON,description=DESCRIPTION \
       --zone=ZONE
   

   Substitua:

   • VM_NAME: o nome da VM.

   • FAULT_REASON: uma lista de problemas de host que sua VM encontrou, separada por vírgulas. Por exemplo, ISSUE_1,ISSUE_2. É possível especificar os seguintes valores:

     • PERFORMANCE: você percebe uma degradação no desempenho da CPU ou da operação de rede do Cloud RDMA, falhas na interface de rede IRDMA ou que o dispositivo de rede IRDMA não está presente.

     • SILENT_DATA_CORRUPTION: você vê corrupção de dados na VM, mas ela continua em execução. A corrupção silenciosa de dados pode ser causada por problemas como defeitos de vCPU, bugs de software ou problemas de kernel.

     • BEHAVIOR_UNSPECIFIED: você não tem certeza de qual problema está afetando sua VM ou o problema não está coberto pelas outras opções.

   • DESCRIPTION: uma descrição do problema que está afetando sua VM, como informações de XID ou suspeitas de problemas de desempenho.

   • ZONE: a zona em que a VM está.

   REST

   Para denunciar um host com falha, faça a seguinte solicitação POST para o método instances.reportHostAsFaulty.

   Ao denunciar um host com falha, é possível especificar vários motivos de falha de uma só vez. Por exemplo, para especificar dois motivos de falha, faça uma solicitação da seguinte maneira:

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/reportHostAsFaulty
   
   {
     "disruptionSchedule": "IMMEDIATE",
     "faultReasons": [
       {
         "behavior": "FAULT_REASON_1",
         "description": "DESCRIPTION_1"
       },
       {
         "behavior": "FAULT_REASON_2",
         "description": "DESCRIPTION_2"
       }
     ]
   }
   

   Substitua:

   • PROJECT_ID: o ID do projeto em que a VM está.

   • ZONE: a zona em que a VM está.

   • VM_NAME: o nome da VM.

   • FAULT_REASON_1 e FAULT_REASON_2: cada problema do host encontrado pela VM. É possível especificar os seguintes valores:

     • PERFORMANCE: você percebe uma degradação no desempenho da CPU ou da operação de rede RDMA, falhas no dispositivo RDMA ou que o dispositivo RDMA não está presente.

     • SILENT_DATA_CORRUPTION: você vê corrupção de dados na VM, mas ela continua em execução. A corrupção silenciosa de dados pode ser causada por problemas como defeitos de vCPUs, bugs de software ou problemas de kernel.

     • BEHAVIOR_UNSPECIFIED: você não tem certeza de qual é o problema da VM.

   • DESCRIPTION_1 e DESCRIPTION_2: uma descrição para cada problema de host especificado, como informações de XID ou suspeitas de problemas de desempenho.

Analisar operações de host com falha

Depois que você informa um host com falha, o Compute Engine inicia uma série de operações para marcar o host como com falha e o prepara para o reparo. Especificamente, durante uma operação de relatório de host com falha, o seguinte processo acontece:

1. Marque o host como com falha. O Compute Engine cria o relatório de operação de host com falha. A operação "report faulty host" cria uma sequência de suboperações. Essas suboperações marcam o host subjacente como com falha.

2. Prepare o host para os consertos. Depois que todas as suboperações forem concluídas, a operação "report faulty host" será iniciada. O Compute Engine interrompe a VM e inicia a operação de reparo do host com falha. Com base no modo operacional da reserva especificado na reserva usada pela VM e se hosts íntegros estiverem disponíveis, o Compute Engine mantém a VM interrompida ou tenta migrar e reiniciar automaticamente a VM.

3. Conclua o relatório e faça o reparo do host. O Compute Engine conclui a operação de relatório de host com falha, e a operação de reparo do host é executada.

Para acompanhar o status das operações de relatório de host com falha (compute.instances.reportHostAsFaulty) no seu projeto, selecione uma das seguintes opções. Para mais informações sobre outras operações que você pode usar para rastrear reparos, migração e reinicialização automática, consulte Comportamentos de manutenção e reinicialização e Monitorar e planejar um evento de manutenção do host na documentação do Compute Engine.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/operations&filter=items.operationType:compute.instances.reportHostAsFaulty

A seguir

• Se você tiver problemas ao denunciar um host com falha, consulte Solução de problemas da API de host com falha.