Configurar recomendações de tipo de máquina

Nesta página, descrevemos como visualizar e modificar a configuração das recomendações de tipo de máquina. É possível modificar os tipos de máquinas recomendados para que as recomendações geradas incluam apenas as séries de máquinas preferidas. Também é possível mudar as métricas usadas para gerar recomendações de memória e melhorar a precisão delas. As mudanças na configuração são aplicadas no nível do projeto.

Para 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

  • 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ódigos ou amostras de um ambiente de desenvolvimento local, faça a autenticação no Compute Engine selecionando uma das seguintes opções:

    1. Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando: 

      gcloud init

      Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    2. Defina uma região e uma zona padrão.

Funções exigidas

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

Esse papel predefinido contém as permissões necessárias para modificar recomendações de tipo de máquina. Para acessar as permissões exatas que são necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para modificar recomendações de tipo de máquina:

  • Visualizar a configuração de recomendação de tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.get no projeto
  • Modificar a configuração de recomendação de tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.update no projeto

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

Configurar suas recomendações

Para configurar as recomendações de tipo de máquina, siga estas 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. Faça o upload do novo arquivo de configuração para aplicar as alterações.

Obter a configuração atual

É possível acessar a configuração atual das recomendações de tipo de máquina para seu projeto usando a Google Cloud CLI.

gcloud

Para acessar os parâmetros de configuração atuais, use o comando gcloud beta recommender recommender-config describe e use google.compute.instance.MachineTypeRecommender como o ID do recomendador:

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

Substitua:

  • PROJECT_ID: ID do projeto.
  • ZONE: a zona para a qual você quer receber a configuração atual.

O comando retorna a configuração do recomendador, incluindo os subcampos modificáveis preferred_machine_types e memory_metrics.

{
  "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"
}

Se você quiser salvar a configuração em um arquivo local para poder editá-la e fazer upload dela mais tarde, execute o seguinte comando:

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

Editar a configuração de recomendação

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

  • preferred_machine_types: as recomendações de tipo 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

É possível especificar quais recomendações de tipo de máquina você recebe mudando 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 de tipos de máquinas padrão e personalizados.
  • STANDARD_ONLY: recomenda a melhor correspondência apenas de 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: usa as métricas padrão para gerar recomendações.
  • MEMORY_METRICS_ALL: usa todas as métricas disponíveis para gerar recomendações.
  • MONITORING_AGENT_ONLY: usa apenas métricas coletadas pelo Agente de operações do Cloud Monitoring.
  • Se você não usa o Agente de operações e prefere não receber recomendações de memória, use o valor MEMORY_AGENT_ONLY para desativar as recomendações.

Para receber recomendações mais precisas sobre o uso da memória, use o Agente de operações.

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 faça o upload da nova configuração do projeto. É possível mudar os tipos de máquinas preferidos, 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, leva aproximadamente 48 horas para que ela entre em vigor. Até lá, todas as recomendações geradas usarão a configuração anterior.

gcloud

Para atualizar os parâmetros de configuração, use o comando gcloud beta recommender recommender-config update e use google.compute.instance.MachineTypeRecommender como o ID do recomendador:

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

Substitua:

  • PROJECT_ID: ID do projeto.
  • ZONE: a zona para a qual você quer receber a configuração atual.
  • LOCAL_FILE_PATH_AND_NAME: o caminho para o arquivo JSON com a configuração atual.
  • ETAG: o valor de etag da configuração atual. É possível encontrar esse valor na saída do comando anterior.

No arquivo de configuração, especifique apenas o objeto recommenderGenerationConfig com os parâmetros de configuração atualizados. Se você salvou a configuração em um arquivo local, copie o valor etag e remova todos os campos, exceto o valor recommenderGenerationConfig.

Por exemplo, para receber recomendações apenas com tipos de máquinas padrão, use o seguinte arquivo de configuração:

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

Se o comando for bem-sucedido, ele retornará um corpo de resposta semelhante ao seguinte, mostrando a nova configuração com os parâmetros que você acabou de modificar.

{
  "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"
}

A seguir