Configure recomendações de reserva subutilizada

Esta página descreve como exibir e modificar a configuração de servidores subutilizados, as recomendações de reserva imediata. Talvez você queira modificar de configuração para aumentar o número de recomendações recebidas ou para receber menos recomendações e excluir as reservas que você planeja usar.

Para mais informações sobre os parâmetros que podem ser usados para personalizar as recomendações, consulte Escolher os parâmetros de configuração corretos.
Para mais informações sobre como agir quando receber recomendações sobre reservas inativas ou subutilizadas, consulte Visualizar e aplicar recomendações de reserva inativa ou Visualizar e aplicar recomendações de reserva subutilizada.

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 da seguinte maneira.

Select the tab for how you plan to use the samples on this page:
gcloud
1. Install the Google Cloud CLI, then initialize it by running the following command:
  gcloud init
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Configurar suas recomendações

Para configurar as recomendações de reserva subutilizada, faça o seguinte:

Obtenha a configuração atual para conferir o arquivo JSON dela.
Edite o arquivo de configuração no formato JSON.
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 reserva subutilizadas para seu projeto usando a CLI do Google Cloud ou REST.

Permissões exigidas para a tarefa

Para executar esta tarefa, é necessário ter permissões:

recommender.computeRightSizeResourceRecommender.get no projeto.

Conclua esta tarefa usando um dos métodos a seguir.

gcloud

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

gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \
  --location=ZONE --billing-account=BILLING_ACCOUNT_ID

Substitua:

ZONE com a zona que contém reservas para listar as recomendações.
BILLING_ACCOUNT_ID: o código da sua conta de faturamento.

Exemplo:

gcloud recommender recommender-config describe google.compute.RightSizeResourceRecommender \
  --location=us-central1-c --billing-account=my-billing-account-id

O comando retorna a configuração do recomendador, incluindo os subcampos modificáveis params.under_utilized_reservation_lookback_period e params.under_utilized_reservation_utilization_threshold.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P7D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

REST

Para recuperar a configuração atual, use o método recommenders.getConfig e especifique google.compute.RightSizeResourceRecommender como o ID do recomendador:

GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config

Substitua:

PROJECT_ID: o ID do projeto que tem a configuração do recomendador que você quer modificar.
ZONE: a zona que contém o projeto.

Na linha de comando, execute o seguinte comando para consultar a configuração do recomendador de um projeto:

PROJECT_ID=PROJECT_ID
ZONE=ZONE
curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "x-goog-user-project: ${PROJECT_ID}" \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.RightSizeResourceRecommender/config

O comando retorna a configuração do recomendador, incluindo os subcampos que você pode modificar: params.under_utilized_reservation_lookback_period e params.under_utilized_reservation_utilization_threshold.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P7D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2024-06-03T04:41:15.330351Z"
}

Atualizar a configuração de um projeto

Para atualizar a configuração das recomendações de reserva subutilizadas, modifique o valor de under_utilized_reservation_lookback_period e faça o upload da nova configuração do projeto.

Você pode definir o período de observação com um valor de 7 a 30 dias, usando uma string que começa com P, depois um número inteiro para o número de dias (7 mínimo e 30 máximo), seguido por D, por exemplo:

Para um período de observação de 7 dias, use "P7D".
Para um período de observação de 30 dias, use "P30D".

Da mesma forma, defina o limite de uso que aciona uma recomendação de reserva subutilizada modificando o valor de under_utilized_reservation_utilization_threshold e faça o upload da nova configuração do projeto, por exemplo:

Para um limite de 80%, "0.8".

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.

Permissões exigidas para a tarefa

Para executar esta tarefa, é necessário ter permissões:

recommender.computeRightSizeResourceRecommender.get no projeto para conferir a configuração.
recommender.computeRightSizeResourceRecommender.update no projeto para modificar a configuração.

Conclua esta tarefa usando um dos métodos a seguir.

gcloud

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

gcloud recommender recommender-config update google.compute.RightSizeResourceRecommender\
  --location=ZONE \
  --config-file=CONFIG_FILE_PATH \
  --etag=ETAG \
  --billing-account=BILLING_ACCOUNT_ID

Substitua:

ZONE: a zona com a configuração atual que você quer obter
CONFIG_FILE_PATH: o caminho para o arquivo JSON com a configuração atual
ETAG: o valor de etag da configuração atual
BILLING_ACCOUNT_ID: o ID da conta de faturamento

No arquivo de configuração, especifique apenas o objeto recommenderGenerationConfig com os parâmetros de configuração atualizados. Por exemplo, para especificar um período de observação de 21 dias e o limite de reserva subutilizada em 80%, use o seguinte arquivo de configuração:

{
  "params": {
    "under_utilized_reservation_lookback_period": "P21D",
    "under_utilized_reservation_utilization_threshold": "0.8"
  }
}

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.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

REST

Para atualizar a configuração, faça uma solicitação PATCH para o recommenders.updateConfig e especifique google.compute.RightSizeResourceRecommender como o ID do recomendador:

PATCH https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\""
}

Substitua:

PROJECT_ID: o ID do projeto que tem a configuração do recomendador que você quer modificar.
ZONE: a zona que contém o projeto.

Salve o corpo da solicitação em um arquivo, por exemplo, config.json. Em seguida, você pode referenciar o arquivo ao atualizar a configuração do recomendador para o projeto, usando um comando semelhante ao seguinte:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "x-goog-user-project: ${PROJECT_ID}" \
-d @config.json \
https://recommender.googleapis.com/v1/projects/$PROJECT_ID/locations/$ZONE/recommenders/google.compute.RightSizeResourceRecommender/config

O comando POST retorna 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.RightSizeResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "under_utilized_reservation_lookback_period": "P21D",
      "under_utilized_reservation_utilization_threshold": "0.8"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2024-06-03T05:00:05Z"
}

A seguir

Saiba como visualizar e aplicar recomendações de reservas inativas.
Saiba como visualizar e aplicar recomendações de reservas subutilizadas.