Habilite la PMU en las máquinas virtuales

Este documento explica cómo habilitar la unidad de monitoreo del rendimiento (PMU) en instancias de máquina virtual (VM) nuevas o existentes. Para obtener más información sobre la PMU, consulte Descripción general de la PMU .

Después de habilitar la PMU en una máquina virtual C4A o C4 y conectarse a ella, puede ejecutar e instalar software de monitoreo del rendimiento en la máquina virtual para analizar y optimizar el rendimiento del software que se ejecuta en la máquina virtual. Este enfoque es útil cuando se ejecutan cargas de trabajo sensibles al rendimiento, como cargas de trabajo de computación de alto rendimiento (HPC) o aprendizaje automático (ML).

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 .

Roles requeridos

Para obtener los permisos que necesita para habilitar la PMU en una máquina virtual nueva o existente, solicite a su administrador que le otorgue la función de IAM Compute Instance Admin (v1) ( roles/compute.instanceAdmin.v1 ) en su proyecto. Para obtener más información sobre cómo otorgar roles, consulte Administrar el acceso a proyectos, carpetas y organizaciones .

Esta función predefinida contiene los permisos necesarios para habilitar la PMU en una máquina virtual nueva o existente. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

Permisos requeridos

Se requieren los siguientes permisos para habilitar la PMU en una máquina virtual nueva o existente:

  • Para crear máquinas virtuales:
    • compute.instances.create en el proyecto.
    • Para usar una imagen personalizada para crear la VM: compute.images.useReadOnly en la imagen
    • Para usar una instantánea para crear la VM: compute.snapshots.useReadOnly en la instantánea
    • Para usar una plantilla de instancia para crear la VM: compute.instanceTemplates.useReadOnly en la plantilla de instancia
    • Para asignar una red heredada a la VM: compute.networks.use en el proyecto
    • Para especificar una dirección IP estática para la VM: compute.addresses.use en el proyecto
    • Para asignar una dirección IP externa a la VM cuando se usa una red heredada: compute.networks.useExternalIp en el proyecto
    • Para especificar una subred para la VM: compute.subnetworks.use en el proyecto o en la subred elegida
    • Para asignar una dirección IP externa a la VM cuando se usa una red VPC: compute.subnetworks.useExternalIp en el proyecto o en la subred elegida
    • Para configurar metadatos de instancia de VM para la VM: compute.instances.setMetadata en el proyecto
    • Para configurar etiquetas para la VM: compute.instances.setTags en la VM
    • Para configurar etiquetas para la VM: compute.instances.setLabels en la VM
    • Para configurar una cuenta de servicio para que la use la VM: compute.instances.setServiceAccount en la VM
    • Para crear un nuevo disco para la VM: compute.disks.create en el proyecto
    • Para conectar un disco existente en modo de solo lectura o lectura-escritura: compute.disks.use en el disco
    • Para conectar un disco existente en modo de solo lectura: compute.disks.useReadOnly en el disco
  • Para crear una plantilla de instancia: compute.instanceTemplates.create en el proyecto
  • Para actualizar una VM: compute.instances.update en la VM

Es posible que también pueda obtener estos permisos con roles personalizados u otros roles predefinidos .

Habilite la PMU en las máquinas virtuales

Para habilitar la PMU en una o más máquinas virtuales C4A o C4, utilice uno de los siguientes métodos:

Una vez que haya habilitado la PMU en una o más máquinas virtuales, puede instalar y utilizar software de supervisión del rendimiento en las máquinas virtuales.

Habilite la PMU en una VM existente

Antes de habilitar la PMU en una máquina virtual existente, asegúrese de que la máquina virtual utilice un tipo de máquina y una plataforma de CPU compatibles haciendo lo siguiente:

  1. Para verificar el tipo de máquina y la plataforma de CPU de la VM, vea los detalles de la VM .

  2. Si necesita cambiar el tipo de máquina de la VM, haga lo siguiente:

    1. Para verificar que una plataforma de CPU compatible esté disponible en la zona donde se encuentra la máquina virtual, consulte Regiones y zonas disponibles .

    2. Cambie el tipo de máquina de la siguiente manera:

      • Para habilitar el tipo de PMU mejorada, debe especificar un tipo de máquina C4 con 96 o 192 vCPU.

      • De lo contrario, para habilitar el tipo de PMU Arquitectónico o Estándar, especifique cualquier tipo de máquina C4A o C4.

No es necesario detener la VM para habilitar la PMU. Sin embargo, para que el cambio sea efectivo, debe reiniciar la máquina virtual como se describe en esta sección.

Para habilitar la PMU en una máquina virtual existente, seleccione una de las siguientes opciones:

nube de gcloud

  1. Cree un archivo YAML vacío.

  2. Para exportar las propiedades de una VM al archivo YAML que acaba de crear, use el comando gcloud compute instances export :

    gcloud compute instances export VM_NAME \
    --destination=YAML_FILE \
    --zone=ZONE

    Reemplace lo siguiente:

    • VM_NAME : el nombre de la VM.

    • YAML_FILE : la ruta al archivo YAML que creó en el paso anterior.

    • ZONE : la zona donde se encuentra la VM.

  3. En el archivo de configuración YAML, agregue el campo performanceMonitoringUnit . Si el campo advancedMachineFeatures no existe, agréguelo también:

    advancedMachineFeatures:
  performanceMonitoringUnit: PMU_TYPE

    Reemplace PMU_TYPE con uno de los siguientes valores:

    • Tipo de PMU arquitectónico: ARCHITECTURAL

    • Tipo de PMU estándar: STANDARD

    • Tipo de PMU mejorado: ENHANCED

  4. Para actualizar la máquina virtual y reiniciarla, usa el comando gcloud compute instances update-from-file con el indicador --most-disruptive-allowed-action configurado en RESTART :

    gcloud compute instances update-from-file VM_NAME \
    --most-disruptive-allowed-action=RESTART \
    --source=YAML_FILE \
    --zone=ZONE

    Reemplace lo siguiente:

    • VM_NAME : el nombre de la VM.

    • YAML_FILE : la ruta al archivo YAML con los datos de configuración que modificaste en el paso anterior.

    • ZONE : la zona donde se encuentra la VM.

DESCANSAR

  1. Cree un archivo JSON vacío.

  2. Para ver las propiedades de una VM existente, realice una solicitud GET al método instances.get :

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

    Reemplace lo siguiente:

    • PROJECT_ID : el ID del proyecto donde se encuentra la VM.

    • ZONE : la zona donde se encuentra la VM.

    • VM_NAME : el nombre de una VM existente.

  3. En el archivo JSON vacío que creó en los pasos anteriores, haga lo siguiente:

    1. Ingrese las propiedades de la VM desde el resultado de la solicitud GET .

    2. En el campo advancedMachineFeatures , agregue el campo performanceMonitoringUnit . Si el campo advancedMachineFeatures no existe, agréguelo también:

      {
  "advancedMachineFeatures": {
    "performanceMonitoringUnit": "PMU_TYPE"
  },
  ...
}

      Reemplace PMU_TYPE con uno de los siguientes valores:

      • Tipo de PMU arquitectónico: ARCHITECTURAL

      • Tipo de PMU estándar: STANDARD

      • Tipo de PMU mejorado: ENHANCED

  4. Para actualizar la VM y reiniciarla, realice una solicitud PUT al método instances.update . En la solicitud, haga lo siguiente:

    • En la URL de solicitud, incluya el parámetro de consulta mostDisruptiveAllowedAction establecido en RESTART .

    • Para el cuerpo de la solicitud, use las propiedades de VM del archivo JSON que creó y actualizó en los pasos anteriores.

    La solicitud es similar a la siguiente:

    PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME?mostDisruptiveAllowedAction=RESTART

{
  "advancedMachineFeatures": {
    "performanceMonitoringUnit": "PMU_TYPE"
  },
  ...
}

Para obtener más información sobre cómo actualizar las propiedades de una VM, consulte Actualizar propiedades de instancia .

Habilite la PMU mientras crea una VM

Solo puede crear una máquina virtual que tenga la PMU habilitada en una zona que contenga una plataforma de CPU compatible . Para obtener una lista de CPU disponibles por zona, consulte Regiones y zonas disponibles .

Para crear una máquina virtual que tenga la PMU habilitada, seleccione una de las siguientes opciones:

nube de gcloud

Para crear una VM que tenga la PMU habilitada, usa el comando gcloud compute instances create con la marca --performance-monitoring-unit :

gcloud compute instances create VM_NAME \
    --machine-type=MACHINE_TYPE \
    --performance-monitoring-unit=PMU_TYPE \
    --zone=ZONE

Reemplace lo siguiente:

  • VM_NAME : el nombre de la VM.

  • MACHINE_TYPE : un tipo de máquina C4A o C4 . Si desea habilitar el tipo de PMU mejorada, debe especificar un tipo de máquina C4 con 96 o 192 vCPU. De lo contrario, se producirá un error al crear la máquina virtual.

  • PMU_TYPE : el tipo de PMU a habilitar en la VM. Especifique uno de los siguientes valores:

    • Tipo de PMU arquitectónico: architectural

    • Tipo de PMU estándar: standard

    • Tipo de PMU mejorado: enhanced

  • ZONE : la zona en la que crear la VM.

DESCANSAR

Para crear una máquina virtual que tenga la PMU habilitada, realice una solicitud POST al método instances.insert . En el cuerpo de la solicitud, incluya el campo performanceMonitoringUnit :

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ],
  "advancedMachineFeatures": {
    "performanceMonitoringUnit": "PMU_TYPE"
  }
}

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto en el que crear la VM.

  • ZONE : la zona en la que crear la VM.

  • VM_NAME : el nombre de la VM.

  • MACHINE_TYPE : un tipo de máquina C4A o C4 . Si desea habilitar el tipo de PMU mejorada, debe especificar un tipo de máquina C4 con 96 o 192 vCPU. De lo contrario, se producirá un error al crear la máquina virtual.

  • IMAGE_PROJECT : el proyecto de imagen que contiene la imagen, por ejemplo, debian-cloud . Para obtener más información sobre los proyectos de imágenes admitidos, consulte Imágenes públicas .

  • IMAGE : especifique uno de los siguientes:

    • Una versión específica de la imagen del sistema operativo, por ejemplo, debian-12-bookworm-v20240617 .

    • Una familia de imágenes , que debe tener el formato family/ IMAGE_FAMILY . Esto especifica la imagen del sistema operativo más reciente y no obsoleta. Por ejemplo, si especifica family/debian-12 , se utiliza la última versión de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de familias de imágenes, consulte Mejores prácticas de familias de imágenes .

  • PMU_TYPE : el tipo de PMU a habilitar en la VM. Especifique uno de los siguientes valores:

    • Tipo de PMU arquitectónico: ARCHITECTURAL

    • Tipo de PMU estándar: STANDARD

    • Tipo de PMU mejorado: ENHANCED

Para obtener más información sobre la creación de una VM, consulte Crear e iniciar una instancia de Compute Engine .

Habilite la PMU mientras crea máquinas virtuales de forma masiva

Solo puede crear máquinas virtuales de forma masiva que tengan la PMU habilitada en zonas que contengan una plataforma de CPU compatible . Para obtener una lista de CPU disponibles por zona, consulte Regiones y zonas disponibles .

Para crear máquinas virtuales de forma masiva que tengan la PMU habilitada, seleccione una de las siguientes opciones:

nube de gcloud

Para crear máquinas virtuales de forma masiva que tengan la PMU habilitada, use el comando gcloud compute instances bulk create con la marca --performance-monitoring-unit .

Por ejemplo, para crear máquinas virtuales de forma masiva en una sola zona y especificar un patrón de nombre, ejecute el siguiente comando:

gcloud compute instances bulk create \
    --count=COUNT \
    --machine-type=MACHINE_TYPE \
    --name-pattern="NAME_PATTERN" \
    --performance-monitoring-unit=PMU_TYPE \
    --zone=ZONE

Reemplace lo siguiente:

  • COUNT : el número de máquinas virtuales que se van a crear.

  • MACHINE_TYPE : un tipo de máquina C4A o C4 . Si desea habilitar el tipo de PMU mejorada, debe especificar un tipo de máquina C4 con 96 o 192 vCPU. De lo contrario, se producirá un error al crear la máquina virtual.

  • NAME_PATTERN : el patrón de nombre para las máquinas virtuales. Para reemplazar una secuencia de números en un nombre de VM, use una secuencia de caracteres almohadilla ( # ). Por ejemplo, el uso de vm-# para el patrón de nombre genera máquinas virtuales con nombres que comienzan con vm-1 , vm-2 y continúan hasta la cantidad de máquinas virtuales especificadas por COUNT .

  • PMU_TYPE : el tipo de PMU a habilitar en las VM. Especifique uno de los siguientes valores:

    • Tipo de PMU arquitectónico: architectural

    • Tipo de PMU estándar: standard

    • Tipo de PMU mejorado: enhanced

  • ZONE : la zona en la que crear máquinas virtuales de forma masiva.

DESCANSAR

Para crear máquinas virtuales de forma masiva que tengan la PMU habilitada, realice una solicitud POST al método instances.bulkInsert . En el cuerpo de la solicitud, incluya el campo performanceMonitoringUnit .

Por ejemplo, para crear máquinas virtuales de forma masiva en una sola zona y especificar un patrón de nombre, realice una solicitud POST de la siguiente manera: 

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/bulkInsert

{
  "count": COUNT,
  "namePattern": "NAME_PATTERN",
  "instanceProperties": {
    "machineType": "MACHINE_TYPE",
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "advancedMachineFeatures": {
      "performanceMonitoringUnit": "PMU_TYPE"
    }
  }
}

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto en el que crear máquinas virtuales de forma masiva.

  • ZONE : la zona en la que crear máquinas virtuales de forma masiva.

  • COUNT : el número de máquinas virtuales que se van a crear.

  • NAME_PATTERN : el patrón de nombre para las máquinas virtuales. Para reemplazar una secuencia de números en un nombre de VM, use una secuencia de caracteres almohadilla ( # ). Por ejemplo, el uso de vm-# para el patrón de nombre genera máquinas virtuales con nombres que comienzan con vm-1 , vm-2 y continúan hasta la cantidad de máquinas virtuales especificadas por COUNT .

  • MACHINE_TYPE : un tipo de máquina C4A o C4 . Si desea habilitar el tipo de PMU mejorada, debe especificar un tipo de máquina C4 con 96 o 192 vCPU. De lo contrario, se producirá un error al crear la máquina virtual.

  • IMAGE_PROJECT : el proyecto de imagen que contiene la imagen, por ejemplo, debian-cloud . Para obtener más información sobre los proyectos de imágenes admitidos, consulte Imágenes públicas .

  • IMAGE : especifique uno de los siguientes:

    • Una versión específica de la imagen del sistema operativo, por ejemplo, debian-12-bookworm-v20240617 .

    • Una familia de imágenes , que debe tener el formato family/ IMAGE_FAMILY . Esto especifica la imagen del sistema operativo más reciente y no obsoleta. Por ejemplo, si especifica family/debian-12 , se utiliza la última versión de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de familias de imágenes, consulte Mejores prácticas de familias de imágenes .

  • PMU_TYPE : el tipo de PMU a habilitar en las VM. Especifique uno de los siguientes valores:

    • Tipo de PMU arquitectónico: ARCHITECTURAL

    • Tipo de PMU estándar: STANDARD

    • Tipo de PMU mejorado: ENHANCED

Para obtener más información sobre la creación de máquinas virtuales de forma masiva, consulte Crear máquinas virtuales de forma masiva .

Habilite la PMU mientras crea una plantilla de instancia

Si desea crear una plantilla de instancia regional que tenga la PMU habilitada, asegúrese de que al menos una zona dentro de la región seleccionada contenga una plataforma de CPU compatible . Para obtener una lista de CPU disponibles por zona, consulte Regiones y zonas disponibles .

Después de crear una plantilla de instancia que tenga la PMU habilitada, puede usar la plantilla para hacer lo siguiente:

Para crear una plantilla de instancia que tenga la PMU habilitada, seleccione una de las siguientes opciones:

nube de gcloud

Para crear una plantilla de instancia que tenga la PMU habilitada, use el comando gcloud compute instance-templates create con la marca --performance-monitoring-unit . Para crear una plantilla de instancia regional, también debe incluir la marca --instance-template-region .

Por ejemplo, para crear una plantilla de instancia regional que tenga la PMU habilitada, ejecute el siguiente comando: 

gcloud compute instance-templates create INSTANCE_TEMPLATE_NAME \
    --instance-template-region=REGION \
    --machine-type=MACHINE_TYPE \
    --performance-monitoring-unit=PMU_TYPE

Reemplace lo siguiente:

  • INSTANCE_TEMPLATE_NAME : el nombre de la plantilla de instancia.

  • REGION : la región en la que se creará la plantilla de instancia.

  • MACHINE_TYPE : un tipo de máquina C4A o C4 . Si desea habilitar el tipo de PMU mejorada, debe especificar un tipo de máquina C4 con 96 o 192 vCPU. De lo contrario, se producirá un error al crear la máquina virtual.

  • PMU_TYPE : el tipo de PMU que se incluirá en la plantilla de instancia. Especifique uno de los siguientes valores:

    • Tipo de PMU arquitectónico: architectural

    • Tipo de PMU estándar: standard

    • Tipo de PMU mejorado: enhanced

DESCANSAR

Para crear una plantilla de instancia que tenga la PMU habilitada, realice una solicitud POST a uno de los siguientes métodos:

En el cuerpo de la solicitud, incluya el campo performanceMonitoringUnit .

Por ejemplo, para crear una plantilla de instancia regional que tenga la PMU habilitada, realice una solicitud POST de la siguiente manera: 

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceTemplates

{
  "name": "INSTANCE_TEMPLATE_NAME",
  "properties": {
    "disks": [
      {
        "boot": true,
        "initializeParams": {
          "sourceImage": "projects/IMAGE_PROJECT/global/images/IMAGE"
        }
      }
    ],
    "machineType": "MACHINE_TYPE",
    "networkInterfaces": [
      {
        "network": "global/networks/default"
      }
    ],
    "advancedMachineFeatures": {
      "performanceMonitoringUnit": "PMU_TYPE"
    }
  }
}

Reemplace lo siguiente:

  • PROJECT_ID : el ID del proyecto en el que crear la plantilla de instancia.

  • REGION : la región en la que se creará la plantilla de instancia.

  • INSTANCE_TEMPLATE_NAME : el nombre de la plantilla de instancia.

  • IMAGE_PROJECT : el proyecto de imagen que contiene la imagen, por ejemplo, debian-cloud . Para obtener más información sobre los proyectos de imágenes admitidos, consulte Imágenes públicas .

  • IMAGE : especifique uno de los siguientes:

    • Una versión específica de la imagen del sistema operativo, por ejemplo, debian-12-bookworm-v20240617 .

    • Una familia de imágenes , que debe tener el formato family/ IMAGE_FAMILY . Esto especifica la imagen del sistema operativo más reciente y no obsoleta. Por ejemplo, si especifica family/debian-12 , se utiliza la última versión de la familia de imágenes de Debian 12. Para obtener más información sobre el uso de familias de imágenes, consulte Mejores prácticas de familias de imágenes .

  • MACHINE_TYPE : un tipo de máquina C4A o C4 . Si desea habilitar el tipo de PMU mejorada, debe especificar un tipo de máquina C4 con 96 o 192 vCPU. De lo contrario, se producirá un error al crear la máquina virtual.

  • PMU_TYPE : el tipo de PMU que se incluirá en la plantilla de instancia. Especifique uno de los siguientes valores:

    • Tipo de PMU arquitectónico: ARCHITECTURAL

    • Tipo de PMU estándar: STANDARD

    • Tipo de PMU mejorado: ENHANCED

Para obtener más información sobre la creación de una plantilla de instancia, consulte Crear plantillas de instancia .

¿Qué sigue?