Configurar recomendações de tipo de máquina

Esta página descreve como exibir e modificar a configuração de recomendações de tipo de máquina. É possível modificar quais tipos de máquina são recomendados, para que as recomendações geradas incluam apenas a série de máquina preferida. 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. 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 selecionando uma das seguintes opções:

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

      gcloud init
    2. Set a default region and zone.

Funções exigidas

Para receber as permissões necessárias a fim de modificar as recomendações de tipo de máquina, peça ao administrador para conceder a você o papel do IAM de Administrador do Compute Recommender (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 as recomendações de tipo de máquina. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

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

  • Confira a configuração da recomendação de tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.get no projeto
  • Modifique 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 conferir o arquivo JSON dela.
  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 CLI do Google Cloud.

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 com a configuração atual que você quer receber.

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 editá-la e fazer o upload 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 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áquina

É possível especificar quais recomendações de tipos 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 entre os tipos de máquina padrão e personalizados.
  • STANDARD_ONLY: recomenda a melhor correspondência apenas entre os tipos de máquina 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 as 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 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áquina 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 com a configuração atual que você quer receber.
  • 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. Esse valor está 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áquina 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