Configura las recomendaciones de tipo de máquina


En esta página, se describe cómo ver y cambiar la configuración de las recomendaciones de tipo de máquina. Puedes modificar los tipos de máquinas que se recomiendan para que las recomendaciones generadas solo incluyan las series de máquinas que prefieras. También puedes cambiar las métricas que se usan para generar recomendaciones de memoria para mejorar la exactitud de las recomendaciones. Los cambios en la configuración se aplican a nivel del proyecto.

Para obtener más información sobre las recomendaciones de tipo de máquina, consulta Aplica recomendaciones de tipo de máquina para VMs.

Antes de comenzar

  • Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las APIs de Google Cloud . Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
    1. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    2. Set a default region and zone.

Roles obligatorios

Para obtener los permisos que necesitas para modificar las recomendaciones de tipo de máquina, pídele a tu administrador que te otorgue el rol de IAM de administrador de Recommender de Compute (roles/recommender.computeAdmin) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para modificar las recomendaciones de tipo de máquina. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para modificar las recomendaciones de tipo de máquina:

  • Consulta la configuración de la recomendación de tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.get en el proyecto
  • Modifica la configuración de la recomendación de tipo de máquina: recommender.computeInstanceMachineTypeRecommenderConfig.update en el proyecto.

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Configura tus recomendaciones

Para configurar las recomendaciones de tipo de máquina, sigue estos pasos:

  1. Obtén la configuración actual para obtener el archivo JSON de la configuración.
  2. Cambia el archivo de configuración en formato JSON.
  3. Sube el archivo de configuración nuevo para aplicar los cambios.

Obtén la configuración actual

Puedes obtener la configuración actual para las recomendaciones de tipo de máquina de tu proyecto con Google Cloud CLI.

gcloud

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

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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID de tu proyecto.
  • ZONE: Es la zona para la que deseas obtener la configuración actual.

El comando muestra la configuración del recomendador, incluidos los subcampos preferred_machine_types y memory_metrics modificables.

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

Si deseas guardar la configuración en un archivo local para poder editarla y subirla más adelante, ejecuta el siguiente comando:

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

Edita la configuración de las recomendaciones

La configuración te permite personalizar los siguientes parámetros:

  • preferred_machine_types: Las recomendaciones de tipos de máquinas que recibes.
  • memory_metrics: Cómo se usan las métricas de memoria para generar recomendaciones

Opciones para las recomendaciones de tipos de máquinas

Para especificar qué recomendaciones de tipos de máquinas obtienes, cambia la configuración de preferred_machine_types a uno de los siguientes valores:

  • DEFAULT: El valor predeterminado es STANDARD_AND_CUSTOM.
  • STANDARD_AND_CUSTOM: Recomienda la mejor coincidencia entre los tipos de máquinas estándar y personalizados.
  • STANDARD_ONLY: Recomienda la mejor coincidencia solo de los tipos de máquinas estándar.

Opciones para las recomendaciones de memoria

Para las métricas de memoria que se usan para generar las recomendaciones, puedes establecer los siguientes valores:

  • MEMORY_METRICS_DEFAULT: Usa las métricas predeterminadas para generar recomendaciones.
  • MEMORY_METRICS_ALL: Usa todas las métricas disponibles para generar recomendaciones.
  • MONITORING_AGENT_ONLY: Usa solo las métricas recopiladas por el agente de operaciones de Cloud Monitoring.
  • Si no usas el agente de operaciones y prefieres no recibir recomendaciones de memoria, usa el valor MEMORY_AGENT_ONLY para inhabilitarlas.

Para obtener recomendaciones más precisas sobre el uso de la memoria, usa el agente de operaciones.

Actualiza la configuración de un proyecto

Para actualizar la configuración de las recomendaciones de tipo de máquina, modifica los valores de configuración y sube la configuración nueva del proyecto. Puedes cambiar los tipos de máquinas preferidos, las métricas de memoria que se usan para las recomendaciones o ambos valores en la misma solicitud.

Después de subir la configuración nueva, lleva alrededor de 48 horas para que se aplique. Hasta ese momento, las recomendaciones generadas usan la configuración anterior.

gcloud

Para actualizar los parámetros de configuración, usa el comando gcloud beta recommender recommender-config update y usa google.compute.instance.MachineTypeRecommender como el ID del 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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID de tu proyecto.
  • ZONE: Es la zona para la que deseas obtener la configuración actual.
  • LOCAL_FILE_PATH_AND_NAME: Es la ruta de acceso al archivo JSON con la configuración actual.
  • ETAG: El valor de etag de la configuración actual. Puedes encontrar este valor en el resultado del comando anterior.

En el archivo de configuración, especifica solo el objeto recommenderGenerationConfig con los parámetros de configuración actualizados. Si guardaste la configuración en un archivo local, asegúrate de copiar el valor etag y, luego, quita todos los campos excepto el valor recommenderGenerationConfig.

Por ejemplo, para obtener recomendaciones solo con tipos de máquinas estándar, usa el siguiente archivo de configuración:

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

Si el comando se ejecuta de forma correcta, muestra un cuerpo de respuesta similar al siguiente, que muestra la configuración nueva con los parámetros que acabas de cambiar.

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

¿Qué sigue?