Este documento descreve como visualizar a configuração de flexibilidade de instância em um grupo gerenciado de instâncias (MIG) e os tipos de máquina usados por cada VM no grupo.
Depois de adicionar ou fazer mudanças na flexibilidade de instância em um MIG, você pode fazer o seguinte:
Visualizar a configuração de flexibilidade de instância para verificar se uma configuração foi aplicada ou se um MIG já tem flexibilidade de instância.
Visualizar os tipos de máquina usados por cada VM para garantir que o tipo de máquina que você quer remover de uma seleção de instância não seja usado por nenhuma VM ou para verificar os diferentes tipos de máquina usados no MIG.
Monitorar as distribuições de VM de ambiente de execução em tempo real em tipos de máquina e zonas para observar e identificar possíveis melhorias para as classificações e tipos de máquina selecionados.
Antes de começar
-
Configure a autenticação, caso ainda não tenha feito isso.
Com isso, você confirma sua identidade para acesso a Google Cloud serviços e APIs do. Para executar
código ou exemplos em um ambiente de desenvolvimento local, faça a autenticação no
Compute Engine com uma destas opções:
Selecione a guia para como planeja usar as amostras nesta página:
Console
Quando você usa o Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.
gcloud
-
Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud initAo usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.
-
- Defina uma região e uma zona padrão.
REST
Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.
Instale a Google Cloud CLI.
Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.
Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .
Visualizar a configuração de flexibilidade de instância
Console
No console, do Google Cloud , acesse a página Grupos de instâncias.
Na coluna Nome, clique no nome do MIG do qual você quer visualizar a configuração de flexibilidade de instância.
A página de visão geral do MIG será aberta.
Clique na guia Detalhes.
Na seção Flexibilidade de instância , a tabela Seleções de instância mostra o nome, a classificação e os tipos de máquina em uma seleção. Se o MIG não tiver a flexibilidade de instância configurada, a seção Flexibilidade de instância não será mostrada.
gcloud
Para visualizar a configuração de flexibilidade de instância, use o
instance-groups managed describe comando.
Inclua a flag --format para filtrar as propriedades instanceFlexibilityPolicy.instanceSelections.
gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
--region REGION \
--format="json(instanceFlexibilityPolicy.instanceSelections)"
Veja um exemplo de saída:
{
"instanceFlexibilityPolicy": {
"instanceSelections": {
"instance-selection-1": {
"machineTypes": [
"n1-standard-16",
"n2-standard-16",
"e2-standard-16"
],
"rank": 1
}
}
}
}
Se um MIG não tiver a flexibilidade de instância configurada, a saída retornará null.
Substitua:
INSTANCE_GROUP_NAME: o nome do MIG do qual você quer visualizar a configuração de flexibilidade de instância.REGION: a região em que o MIG está localizado.
REST
Para visualizar a configuração de flexibilidade de instância, use o
regionInstanceGroupManagers.get método.
Inclua o parâmetro fields no URL da solicitação para filtrar as propriedades instanceFlexibilityPolicy.instanceSelections.
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME?fields=instanceFlexibilityPolicy.instanceSelections
Veja um exemplo de saída:
{
"instanceFlexibilityPolicy": {
"instanceSelections": {
"instance-selection-1": {
"machineTypes": [
"n1-standard-16",
"n2-standard-16",
"e2-standard-16"
],
"rank": 1
}
}
}
}
Se um MIG não tiver a flexibilidade de instância configurada, a saída retornará null.
Substitua:
PROJECT_ID: o ID do projeto.REGION: a região em que o MIG está localizado.INSTANCE_GROUP_NAME: o nome do MIG do qual você quer visualizar a configuração de flexibilidade de instância.
Visualizar os tipos de máquina usados por cada VM
Console
No console, do Google Cloud , acesse a página Grupos de instâncias.
Na coluna Nome, clique no nome do MIG em que você quer visualizar os tipos de máquina usados por cada VM.
A página Visão geral do MIG é aberta, listando todas as VMs no grupo, os tipos de máquina e outros detalhes.
gcloud
Para visualizar os tipos de máquina usados por cada VM em um MIG, liste as VMs usando o
instance-groups managed list-instances comando e inclua a --format flag para filtrar o
propertiesFromFlexibilityPolicy.machineType campo. Também é possível filtrar outros campos conforme necessário.
gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
--region REGION \
--format='(name,instanceStatus,currentAction,propertiesFromFlexibilityPolicy.machineType,lastAttempt.errors.errors)'
Veja um exemplo de saída:
NAME: example-mig-0md2 STATUS: RUNNING ACTION: NONE MACHINE_TYPE: n1-standard-16 LAST_ERROR: NAME: example-mig-vbgg STATUS: RUNNING ACTION: NONE MACHINE_TYPE: n1-standard-16 LAST_ERROR:
Substitua:
REGION: a região em que o MIG está localizado.INSTANCE_GROUP_NAME: o nome do MIG do qual você quer visualizar a configuração de flexibilidade de instância.
REST
Para visualizar os tipos de máquina usados por cada VM em um MIG, liste as VMs usando o
listManagedInstances método
e verifique o propertiesFromFlexibilityPolicy.machineType campo na
resposta.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances
A seguir, um exemplo de saída. Procure o campo propertiesFromFlexibilityPolicy em que o campo machineType de uma VM está definido.
{
"managedInstances": [
{
"instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-0md2",
"instanceStatus": "RUNNING",
"id": "2656095434923471959",
"version": {
"instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
},
"targetStatus": "RUNNING",
"name": "example-mig-0md2",
"propertiesFromFlexibilityPolicy": {
"machineType": "n1-standard-16"
}
},
{
"instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-vbgg",
"instanceStatus": "RUNNING",
"currentAction": "NONE",
"id": "9171259522409694366",
"version": {
"instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
},
"targetStatus": "RUNNING",
"name": "example-mig-vbgg",
"propertiesFromFlexibilityPolicy": {
"machineType": "n1-standard-16"
}
}
]
}
Substitua:
PROJECT_ID: o ID do projeto.REGION: a região em que o MIG está localizado.INSTANCE_GROUP_NAME: o nome do MIG do qual você quer visualizar a configuração de flexibilidade de instância.
Monitorar a distribuição de instâncias
Embora a verificação da política de flexibilidade de instância estática e a listagem de tipos de máquina de VM individuais forneçam um snapshot da configuração atual, a observação de como o MIG aloca capacidade ao longo do tempo exige monitoramento em tempo real.
É possível usar o painel Monitoramento de distribuição de instâncias do GCE MIG no Cloud Monitoring para observar as distribuições de instâncias de ambiente de execução em zonas e tipos de máquina em tempo real. Essa visibilidade ajuda a verificar se as VMs estão distribuídas nas classificações e locais pretendidos quando a demanda ou a capacidade muda.
Para instruções sobre como acessar o painel de monitoramento, consulte Monitorar a distribuição de instâncias em MIGs.
A seguir
Alterar ou remover a configuração de flexibilidade de instância.
Se o MIG não tiver flexibilidade de instância, adicione-a.