Configurar recomendações de tipo de máquina

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esta página descreve como visualizar e modificar a configuração das recomendações de tipo de máquina. Você pode modificar quais tipos de máquinas são recomendados, para que as recomendações geradas incluam apenas a série de máquinas de sua preferência. Também é possível alterar as métricas usadas para gerar recomendações de memória para melhorar a precisão das recomendações. As alterações na configuração são aplicadas no nível do projeto.

Para obter mais informações sobre recomendações de tipo de máquina, consulte Aplicar recomendações de tipo de máquina para VMs .

Antes de começar

• Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:
  

  1. After installing the Google Cloud CLI, initialize it by running the following command:

     gcloud init

     If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

  2. Set a default region and zone.

Funções obrigatórias

Para obter as permissões necessárias para modificar recomendações de tipo de máquina, peça ao administrador para conceder a você a função do IAM Compute Recommender Admin ( roles/recommender.computeAdmin ) em seu projeto. Para obter mais informações sobre a concessão de funções, consulte Gerenciar acesso a projetos, pastas e organizações .

Esta função predefinida contém as permissões necessárias para modificar recomendações de tipo de máquina. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias :

Você também poderá obter essas permissões com funções personalizadas ou outras funções predefinidas .

Configure suas recomendações

Para configurar as recomendações de tipo de máquina, execute as seguintes etapas:

1. Obtenha a configuração atual para obter o arquivo JSON da configuração.
2. Edite o arquivo de configuração no formato JSON.
3. Carregue o novo arquivo de configuração para aplicar as alterações.

Obtenha a configuração atual

Você pode obter a configuração atual para recomendações de tipo de máquina para seu projeto usando a CLI do Google Cloud.

gcloud beta recommender recommender-config describe google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_AND_CUSTOM",
      "memory_metrics": "MONITORING_AGENT_ONLY"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-08-20T04:41:15.330351Z"
}

gcloud beta recommender recommender-config describe \
  google.compute.instance.MachineTypeRecommender \
  --project=PROJECT_ID \
  --location=ZONE > LOCAL_FILE_PATH_AND_NAME

Editar a configuração da recomendação

A configuração permite personalizar os seguintes parâmetros:

• preferred_machine_types : as recomendações de tipos de máquina que você recebe.
• memory_metrics : como as métricas de memória são usadas para gerar recomendações.

Opções para recomendações de tipos de máquinas

Você pode especificar quais recomendações de tipos de máquinas serão obtidas alterando a configuração preferred_machine_types para um dos seguintes valores:

• DEFAULT : O valor padrão é STANDARD_AND_CUSTOM .
• STANDARD_AND_CUSTOM : recomenda a melhor correspondência entre tipos de máquina padrão e personalizados.
• STANDARD_ONLY : recomenda a melhor correspondência somente entre tipos de máquinas padrão.

Opções para recomendações de memória

Para as métricas de memória usadas para gerar as recomendações, é possível definir os seguintes valores:

• MEMORY_METRICS_DEFAULT : Use as métricas padrão para gerar recomendações.
• MEMORY_METRICS_ALL : Use todas as métricas disponíveis para gerar recomendações.
• MONITORING_AGENT_ONLY : use apenas métricas coletadas pelo agente de operações do Cloud Monitoring.
• Se você não usa o Ops Agent e prefere não receber recomendações de memória, use o valor MEMORY_AGENT_ONLY para desabilitar as recomendações.

Para obter recomendações mais precisas sobre o uso de memória, use o Ops Agent .

Atualizar a configuração de um projeto

Para atualizar a configuração das recomendações de tipo de máquina, modifique os valores de configuração e carregue a nova configuração para o seu projeto. Você pode alterar os tipos de máquinas preferenciais, as métricas de memória usadas para recomendações ou ambos os valores na mesma solicitação.

Depois de fazer upload da nova configuração, levará aproximadamente 48 horas para que ela entre em vigor. Até esse momento, todas as recomendações geradas utilizam a configuração anterior.

gcloud beta recommender recommender-config update google.compute.instance.MachineTypeRecommender\
  --project=PROJECT_ID \
  --location=ZONE \
  --config-file=LOCAL_FILE_PATH_AND_NAME \
  --etag=ETAG

{
  "params": {
    "preferred_machine_types": "STANDARD_ONLY"
  }
}

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.MachineTypeRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "preferred_machine_types": "STANDARD_ONLY"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-08-20T05:00:05Z"
}

O que vem a seguir

• Saiba como aplicar recomendações de tipo de máquina a instâncias .
• Saiba como aplicar recomendações de tipo de máquina a grupos de instâncias gerenciadas .