Configurar recomendaciones de VM inactivas

Esta página describe cómo ver y modificar la configuración de sus recomendaciones de VM inactivas. Es posible que desee modificar la configuración para aumentar la cantidad de recomendaciones que recibe o para evitar clasificar erróneamente las máquinas virtuales con cargas de trabajo intencionalmente pequeñas como máquinas virtuales inactivas.

Antes de comenzar

  • Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:

    Select the tab for how you plan to use the samples on this page:

    gcloud

    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.

      3. REST

      Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.

        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.

      Para obtener más información, consulta Autentica para usar REST en la documentación de autenticación de Google Cloud .

Precios

Las recomendaciones configurables están disponibles de forma gratuita. El uso de recomendaciones para reducir el uso de recursos puede generar ahorros de costos.

Configura tus recomendaciones

Para configurar sus recomendaciones de VM inactivas, realice los siguientes pasos:

  1. Obtenga la configuración actual para obtener el archivo JSON de la configuración.
  2. Edite el archivo de configuración en formato JSON.
  3. Cargue el nuevo archivo de configuración para aplicar los cambios.

Obtener la configuración actual

Puede obtener la configuración actual para las recomendaciones de VM inactivas para su proyecto mediante la CLI o REST de Google Cloud.

nube de gcloud

Para obtener los parámetros de configuración actuales, use el comando gcloud recommender recommender-config describe y use google.compute.instance.IdleResourceRecommender como ID del recomendador:

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

Reemplace lo siguiente:

  • PROJECT_ID : el ID de tu proyecto
  • ZONE : la zona para la cual desea obtener la configuración actual

Por ejemplo:

gcloud recommender recommender-config describe google.compute.instance.IdleResourceRecommender \
  --project=my-project \
  --location=us-central1-c

El comando devuelve la configuración del recomendador, incluido el subcampo modificable params.observation_period .

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "1209600s"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2021-02-03T04:41:15.330351Z"
}

DESCANSAR

Para recuperar la configuración actual, utilice el método recommenders.getConfig y especifique google.compute.instance.IdleResourceRecommender como ID del recomendador:

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

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto para el que desea recuperar la configuración del recomendador.
  • ZONE : la zona que contiene su proyecto.

Desde la línea de comando, ejecute el siguiente comando para obtener la configuración del recomendador para un proyecto:

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.instance.IdleResourceRecommender/config

El comando devuelve la configuración del recomendador, incluido el subcampo que puede modificar: params.observation_period .

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "1209600s"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\"",
  "updateTime": "2021-02-03T04:41:15.330351Z"
}

Actualizar la configuración de un proyecto.

Para actualizar la configuración de sus recomendaciones de VM inactivas, modifique el valor de observation_period y cargue la nueva configuración para su proyecto.

Puede establecer el período de observación en un valor entre 1 día y 14 días, usando una cadena con el número total de segundos, seguido de la letra s .

  • Para un período de observación de 1 día, utilice "86400s" .
  • Para un período de observación de 14 días, utilice "1209600s" .

Después de cargar la nueva configuración, tarda aproximadamente 48 horas en surtir efecto. Hasta ese momento, todas las recomendaciones generadas utilizan la configuración anterior.

nube de gcloud

Para actualizar los parámetros de configuración, use el comando gcloud recommender recommender-config update y use google.compute.instance.IdleResourceRecommender como ID del recomendador:

gcloud recommender recommender-config update google.compute.instance.IdleResourceRecommender\
  --project=PROJECT_ID \
  --location=ZONE \
  --config-file=CONFIG_FILE_PATH \
  --etag=ETAG

Reemplace lo siguiente:

  • PROJECT_ID : el ID de tu proyecto
  • ZONE : la zona para la cual desea obtener la configuración actual
  • CONFIG_FILE_PATH : la ruta al archivo JSON con la configuración actual
  • ETAG : el valor de etag de la configuración actual

En su archivo de configuración, especifique solo el objeto recommenderGenerationConfig con los parámetros de configuración actualizados. Por ejemplo, para especificar un período de observación de cinco días, utilice el siguiente archivo de configuración:

{
  "params": {
    "observation_period": "432000s"
  }
}

Si el comando tiene éxito, devuelve un cuerpo de respuesta similar al siguiente, que muestra la nueva configuración con los parámetros que acaba de modificar.

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "432000s"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2021-02-03T05:00:05Z"
}

DESCANSAR

Para actualizar la configuración, utilice el método recommenders.updateConfig y especifique google.compute.instance.IdleResourceRecommender como ID del recomendador: 

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

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "1209600s"
    }
  },
  "etag": "\"2f3c9b65cda6a4ba\""
}

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto para el que desea modificar la configuración del recomendador.
  • ZONE : la zona que contiene su proyecto.

Guarde el cuerpo de la solicitud en un archivo, por ejemplo config.json . Luego puede hacer referencia al archivo cuando actualice la configuración del recomendador para su proyecto, usando un comando similar al siguiente: 

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.instance.IdleResourceRecommender/config

El comando POST devuelve un cuerpo de respuesta similar al siguiente, que muestra la nueva configuración con los parámetros que acaba de modificar. 

{
  "name": "projects/PROJECT_ID/locations/ZONE/recommenders/google.compute.instance.IdleResourceRecommender/config",
  "recommenderGenerationConfig": {
    "params": {
      "observation_period": "432000s"
    }
  },
  "etag": "\"1245f9435cd01ea8\"",
  "updateTime": "2021-02-03T05:00:05Z"
}

¿Qué sigue?