Ver informações sobre MIGs e instâncias gerenciadas

Use os métodos nesta página para receber informações sobre os grupos de instâncias gerenciadas (MIGs, na sigla em inglês) e sobre as instâncias de máquina virtual (VM) em cada MIG.

Antes de começar

• Analise as limitações e crie um grupo.
• Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine da seguinte maneira.
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

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

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Consultar informações sobre MIGs

É possível recuperar informações sobre os próprios grupos, por exemplo, para inspecionar as políticas anexadas ao grupo e verificar se o grupo é estável ou está passando por alterações. Para ver informações sobre as instâncias de VM em um MIG, consulte Como receber informações sobre instâncias gerenciadas.

Listar MIGs

Para ver uma lista dos grupos gerenciados de instâncias, use o console, a gcloud CLI ou a REST.

gcloud compute instance-groups managed list

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers

Consultar as propriedades de um MIG

Para ver informações sobre um MIG específico, incluindo as políticas dele (por exemplo, as políticas de recuperação automática e atualização do grupo), use o console, o gcloud CLI ou a REST.

Para conseguir o valor id do grupo, use a CLI gcloud ou a API do Compute Engine.

gcloud compute instance-groups managed describe instance-group \
    [--zone zone | --region region]

gcloud compute instance-groups managed describe instance-group --format="(autoscaler)"

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/regionAutoscalers/mig_name

Verificar se um MIG está estável

Vários comandos e solicitações criam, excluem e modificam instâncias em um grupo de instâncias gerenciadas. Essas operações serão retornadas como DONE depois que o grupo programar ações para criar, excluir ou atualizar essas instâncias. No entanto, isso não significa que as instâncias no grupo tenham sido criadas, excluídas ou atualizadas antes da conclusão das ações subjacentes. Você precisa verificar o status do grupo ou, como alternativa, verificar o status dessas instâncias.

Um grupo de instâncias gerenciadas está estável quando nenhuma instância no grupo está sofrendo alterações, nenhuma alteração futura está programada para as instâncias e o grupo não está sendo modificado.

Você precisa saber se o grupo está estável quando tem dependências que dependem da integridade e da disponibilização de todas as instâncias do grupo. Por exemplo, comece a programar jobs, enviar tráfego ou atribuir intervalos de chaves depois de confirmar que todas as VMs estão funcionando e íntegras.

Verifique se todas as instâncias em um grupo de instâncias gerenciadas estão em execução e íntegras verificando o valor do campo status.isStable do grupo.

gcloud compute instance-groups managed describe instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed wait-until instance-group-name \
    --stable \
    [--zone zone | --region region]
Waiting for group to become stable, current operations: deleting: 4
Waiting for group to become stable, current operations: deleting: 4
...
Group is stable

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/get

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group-name/get

status.isStable definido como false indica que as alterações estão ativas, pendentes ou que o próprio MIG está sendo modificado.

status.isStable definido como true indica o seguinte:

• Nenhuma das instâncias no MIG está passando por qualquer tipo de alteração, e o currentAction de todas as instâncias é NONE.
• Nenhuma alteração pendente para instâncias no MIG.
• O MIG não está sendo modificado.

A estabilidade de um MIG depende de vários fatores porque ele pode ser modificado de várias maneiras. Exemplo:

• Você faz uma solicitação para lançar um novo modelo de instância.
• Você faz uma solicitação para criar, excluir, redimensionar ou atualizar instâncias no MIG.
• Um escalonador automático solicita o redimensionamento do MIG.
• Um recurso de recuperação automática está substituindo uma ou mais instâncias não íntegras do MIG.
• Em um MIG regional, algumas das instâncias estão sendo redistribuídas.

Assim que todas as ações forem concluídas, status.isStable será definido como true novamente para esse MIG.

Para instâncias de VM individuais, consulte Como verificar o status de instâncias gerenciadas.

Verificar se os reparos de VM estão desativados em um MIG

Para verificar se os reparos de VM estão desativados em um MIG, use o console, a gcloud CLI ou a API.

gcloud beta compute instance-groups managed describe instance-group \
    --format="(instanceLifecyclePolicy)"

instanceLifecyclePolicy:
  defaultActionOnFailure: REPAIR
  forceUpdateOnRepair: NO

GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP

"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "NO",
  "defaultActionOnFailure": "REPAIR"
}

Se você não quiser que um MIG repare uma VM com falha ou não íntegra no grupo, desative os reparos no MIG.

Consultar o histórico de operações de recuperação automática

Se você configurou a recuperação automática, é possível visualizar eventos anteriores de recuperação automática.

Monitorar atualizações graduais

Se você iniciou uma atualização gradual e quer saber quando ela for concluída, consulte Atualizações de monitoramento.

Consultar a configuração com estado

Se você configurou um MIG com estado e quer revisar sua configuração, consulte Como visualizar a configuração com estado.

Consultar informações sobre as instâncias de VM gerenciadas em um MIG

Listar as instâncias gerenciadas de um MIG

Para ver uma lista das instâncias gerenciadas em um grupo, incluindo os respectivos estados e modelos, use o console, a gcloud CLI ou a REST.

gcloud compute instance-groups managed list-instances instance-group \
    [--zone zone | --region region]

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

Verificar o status das instâncias gerenciadas

Vários comandos e solicitações criam, excluem e modificam instâncias em um grupo de instâncias gerenciadas. Essas operações serão retornadas como DONE depois que o grupo programar ações para criar, excluir ou atualizar essas instâncias. No entanto, isso não significa que as instâncias no grupo tenham sido criadas, excluídas ou atualizadas antes da conclusão das ações subjacentes. Você precisa verificar o status dessas instâncias ou, como alternativa, verificar o status do próprio grupo.

Use a CLI do Google Cloud ou a REST para ver detalhes sobre as instâncias em um grupo gerenciado de instâncias. Isso inclui o status da instância e as ações atuais que o grupo está executando nas instâncias.

gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
    [--zone=ZONE | --region=REGION]

NAME               ZONE           STATUS   HEALTH_STATE  ACTION  INSTANCE_TEMPLATE  VERSION_NAME  LAST_ERROR
vm-instances-9pk4  us-central1-f                          CREATING  my-new-template
vm-instances-h2r1  us-central1-f  STOPPING                DELETING  my-old-template
vm-instances-j1h8  us-central1-f  RUNNING                 NONE      my-old-template
vm-instances-ngod  us-central1-f  RUNNING                 NONE      my-old-template

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--zone=ZONE | --region=REGION]

currentAction: NONE
id: '6789072894767812345'
instance: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-hz41
instanceStatus: RUNNING
name: example-mig-hz41
preservedStateFromConfig:
  metadata:
    example-key: example-value
preservedStateFromPolicy:
  disks:
    persistent-disk-0:
      autoDelete: NEVER
      mode: READ_WRITE
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-mig-hz41
version:
  instanceTemplate: https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

{
 "managedInstances": [
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-prvp",
   "id": "5317605642920955957",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-pz5j",
   "currentAction": "DELETING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5",
   "id": "2800161036826218547",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  }
 ]
}

Para ver uma lista de valores válidos do campo instanceStatus, consulte Ciclo de vida da instância da VM.

Se uma instância estiver passando por algum tipo de alteração, o grupo gerenciado de instâncias definirá o campo currentAction da instância como uma das ações a seguir para ajudar você a acompanhar o andamento da alteração. Caso contrário, o campo currentAction será definido como NONE.

Os valores possíveis de currentAction são:

• ABANDONING. A instância está sendo removida do MIG.
• CREATING: a instância está em processo de criação;
• CREATING_WITHOUT_RETRIES. A instância está sendo criada sem novas tentativas. Se a instância não for criada na primeira tentativa, o MIG não tentará substituí-la novamente.
• DELETING: a instância está em processo de exclusão;
• RECREATING: a instância está sendo substituída;
• REFRESHING: a instância está sendo removida e adicionada novamente à lista de pools de destino atuais (essa lista pode corresponder ou não aos pools de destino atuais);
• RESTARTING: a instância está em processo de reinicialização por meio dos métodos stop e start;
• RESUMING: A instância está em processo de ser retomada após ser suspensa.
• STARTING: A instância está em processo de inicialização após ser interrompida.
• STOPPING: a instância está sendo interrompida.
• SUSPENDING: a instância está sendo suspensa.
• VERIFYING: a instância foi criada e está em processo de verificação;
• NONE: nenhuma ação está sendo executada na instância.

Para verificar se o grupo como um todo é estável ou está passando por alterações, consulte Como verificar o status do grupo.

Verificar os estados de integridade

Se você configurou a recuperação automática no grupo de instâncias gerenciadas, é possível avaliar o estado de integridade de cada VM. Consulte Como verificar o status de integridade.

Listar erros de instância

Se as instâncias gerenciadas encontrarem erros, será possível visualizá-los para diagnosticar e reduzir a causa.

Use o console do Google Cloud, a gcloud CLI ou a REST para listar erros.

gcloud compute instance-groups managed list-errors instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed list-errors example-group \
    --region us-west1

INSTANCE_URL                                                                                        ACTION    ERROR_CODE      ERROR_MESSAGE                                                                                     TIMESTAMP                      INSTANCE_TEMPLATE                                                                                                            VERSION_NAME

https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-v0hl  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-v0hl' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.156-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-qp3d  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-qp3d' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.081-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
...

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100

{
 "items": [
  {
   "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Instance 'example-mig-m1sz' creation failed: Quota 'CPUS' exceeded.  Limit: 50.0 in zone us-central1-c."
   },
   "timestamp": "2019-01-03T18:47:28.457-08:00",
   "instanceDetails" : {
    "instance": "zones/us-central1-c/instances/example-mig-m1sz",
    "action": "CREATING",
    "version": {
     "name": "example-version-name",
     "instanceTemplate": "global/instanceTemplates/example-template",
    }
   }
  }
 ],
 ...
 "nextPageToken": "Ch0yMDE5LTA3LTI5VDExOjA4OjA2LjYxMi0wNzowMBJ5aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vY29tcHV0ZS9zdGFnaW5nX2FscGhhL3Byb2plY3RzL215cnpha2VyZXltcy1zdGFnaW5nL3pvbmVzL3VzLWNlbnRyYWwxLWlyMS9pbnN0YW5jZXMvaWdtLTEtcXAzZA=="
}

A lista de possíveis erros inclui, entre outros, os seguintes exemplos:

• Uma nova instância não pode ser criada devido a:
  • Indisponibilidade da capacidade de preempção.
  • Falta de cota, por exemplo, para CPUs em uma determinada região.
  • O limite no número de instâncias de VM foi atingido para a rede associada ao grupo.
  • A imagem de disco especificada no campo properties.disks[].initializeParams.sourceImage do modelo da instância foi excluída ou suas permissões foram alteradas.
  • O cartão de crédito na conta de faturamento associada ao projeto recusou um pagamento.
• Uma instância existente não pode ser excluída porque:
  • A conta de serviço usada pelo grupo não tem a permissão compute.instances.delete.
  • Muitas exclusões simultâneas foram solicitadas, excedendo os limites de taxa.
• Não é possível adicionar uma instância a um pool de destino porque ele foi excluído.

Depois de inspecionar esses erros, você pode atenuá-los. Exemplo:

• Mova sua carga de trabalho para uma zona diferente que tenha capacidade de preempção.
• Solicite um aumento de cota em uma determinada região.
• Adicione a permissão compute.instances.delete à conta de serviço usada pelo grupo.

Se uma ação acionada por um grupo de instâncias gerenciado falhar (por exemplo, se um autoescalador encontrar um erro ao tentar aumentar o tamanho do grupo), o grupo poderá repetir imediatamente essa ação. Se a última tentativa imediata de repetição falhar, o MIG registrará o erro, e será possível vê-lo ao listar erros de instância. Depois de algum tempo de espera, o grupo tenta novamente a ação com falha. Se o erro persistir, ele poderá ser registrado várias vezes.

O Compute Engine mantém os 500 erros mais recentes dos últimos oito dias, mesmo que as instâncias subjacentes não existam mais ou não possam ser criadas.

Verificar se uma instância de VM faz parte de um MIG

Para verificar se uma VM específica faz parte de um grupo, use o console ou REST.

Outra opção para identificar se uma VM é ou foi membro de um grupo de instâncias gerenciadas é procurar estas duas chaves nos metadados da instância:

• instance-template indica o modelo usado como base para a criação da VM.
• created-by indica o grupo de instâncias gerenciadas que criou a VM.

Mesmo que você abandone a instância, a VM ainda terá essas entradas de metadados, a menos que você as remova manualmente.

Por exemplo, se houver uma VM chamada random-instance-biy e você quiser saber se ela foi criada por um grupo de instâncias gerenciadas, descreva a instância e procure as chaves de metadados. Exemplo:

gcloud compute instances describe random-instance-biy \
    --zone us-central1-f

A CLI gcloud retorna uma resposta semelhante a esta:

canIpForward: false
cpuPlatform: Intel Ivy Bridge
creationTimestamp: '2016-08-24T14:11:38.012-07:00'
...
metadata:
  items:
  - key: instance-template
    value: projects/123456789012/global/instanceTemplates/example-it
  - key: created-by
    value: projects/123456789012/zones/us-central1-f/instanceGroupManagers/igm-metadata

Consultar o estado preservado de uma instância gerenciada

Se você configurou um MIG com estado e quer visualizar o estado preservado de cada instância gerenciada, consulte Como visualizar a configuração com estado e o estado preservado.

A seguir

• Saiba mais sobre grupos de instâncias gerenciadas.
• Crie um modelo de instância que possa ser usado para criar um grupo de instâncias gerenciadas.