Esta página se ha traducido con Cloud Translation API.

Administrar la PMU en VM,Administrar la PMU en VM
Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Este documento explica cómo cambiar el tipo de unidad de monitoreo de rendimiento (PMU) habilitado en una instancia de máquina virtual (VM), o deshabilitarlo. Para obtener más información sobre la PMU, consulte Descripción general de la PMU .

Después de habilitar la PMU en una VM y ejecutar el software de monitoreo del rendimiento en la VM, puede hacer lo siguiente:

Cambie el tipo de PMU habilitado en la VM . Este cambio es útil cuando desea realizar un seguimiento de diferentes tipos de eventos de CPU de bajo nivel.
Deshabilite la PMU en la VM . Esta acción es útil cuando ya no necesita acceder a los contadores de rendimiento en la PMU.

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.
  
  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.

Roles requeridos

Para obtener los permisos que necesita para cambiar el tipo de PMU habilitado en una VM o deshabilitarlo, solicite a su administrador que le otorgue el rol 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 cambiar el tipo de PMU habilitado en una VM o deshabilitarlo. Para ver los permisos exactos que se requieren, expanda la sección Permisos requeridos :

Permisos requeridos

Se requieren los siguientes permisos para cambiar el tipo de PMU habilitado en una VM o deshabilitarlo:

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 .

Cambiar el tipo de PMU en una VM

Antes de cambiar el tipo de PMU habilitado en una máquina virtual C4A o C4 existente, vea los detalles de la máquina virtual mediante la CLI de Google Cloud o la API REST. En el resultado del comando o solicitud de API, verifique lo siguiente:

Para verificar el tipo de PMU habilitado en la VM, verifique el valor del campo performanceMonitoringUnit . Si falta el campo, entonces la PMU está deshabilitada.
Si desea habilitar el tipo de PMU mejorada, asegúrese de que la VM esté usando un tipo de máquina C4 con 96 o 192 vCPU verificando el valor del campo machineType . De lo contrario, cambie el tipo de máquina de la VM .

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

Para cambiar el tipo de PMU habilitado en una VM existente, seleccione una de las siguientes opciones:

nube de gcloud

Cree un archivo YAML vacío.
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.
En el archivo de configuración YAML, ubique el campo performanceMonitoringUnit y cambie su valor para especificar un tipo de PMU diferente:
```
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
Consejo: Para evitar recibir un error como "ERROR: (gcloud.compute.instances.update-from-file) Cannot parse YAML: [Expected type for field value, found True (type )]" , agregue comillas ( ' ' ) alrededor de cualquier valor de etiqueta de yes o no en el archivo de configuración de instancia exportado. Esto indica que los valores son cadenas, no valores booleanos.
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

Cree un archivo JSON vacío.
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.
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. Localice el campo performanceMonitoringUnit y luego cambie su valor para especificar un tipo de PMU diferente:
```
"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
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 máquina virtual, consulte Actualizar las propiedades de la máquina virtual .

Deshabilitar la PMU en una VM

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

Para deshabilitar la PMU en una VM existente, seleccione una de las siguientes opciones:

nube de gcloud

Cree un archivo YAML vacío.
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.
En el archivo de configuración YAML, ubique el campo performanceMonitoringUnit y establezca su valor en NONE :
```
advancedMachineFeatures:
  performanceMonitoringUnit: NONE
```
Consejo: Para evitar recibir un error como "ERROR: (gcloud.compute.instances.update-from-file) Cannot parse YAML: [Expected type for field value, found True (type )]" , agregue comillas ( ' ' ) alrededor de cualquier valor de etiqueta de yes o no en el archivo de configuración de instancia exportado. Esto indica que los valores son cadenas, no valores booleanos.
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

Cree un archivo JSON vacío.
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.
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. Localice el campo performanceMonitoringUnit y luego cambie su valor a NONE :
```
"advancedMachineFeatures": {
  "performanceMonitoringUnit": "NONE"
}
```
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": "NONE"
  },
  ...
}
```

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

¿Qué sigue?

Establecer el número de subprocesos por núcleo

Después de habilitar la PMU en una VM y ejecutar el software de monitoreo del rendimiento en la VM, puede hacer lo siguiente:

Cambie el tipo de PMU habilitado en la VM . Este cambio es útil cuando desea realizar un seguimiento de diferentes tipos de eventos de CPU de bajo nivel.
Deshabilite la PMU en la VM . Esta acción es útil cuando ya no necesita acceder a los contadores de rendimiento en la PMU.

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.
  
  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.

Roles requeridos

Permisos requeridos

Se requieren los siguientes permisos para cambiar el tipo de PMU habilitado en una VM o deshabilitarlo:

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 .

Cambiar el tipo de PMU en una VM

Para verificar el tipo de PMU habilitado en la VM, verifique el valor del campo performanceMonitoringUnit . Si falta el campo, entonces la PMU está deshabilitada.
Si desea habilitar el tipo de PMU mejorada, asegúrese de que la VM esté usando un tipo de máquina C4 con 96 o 192 vCPU verificando el valor del campo machineType . De lo contrario, cambie el tipo de máquina de la VM .

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

Para cambiar el tipo de PMU habilitado en una VM existente, seleccione una de las siguientes opciones:

nube de gcloud

Cree un archivo YAML vacío.
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.
En el archivo de configuración YAML, ubique el campo performanceMonitoringUnit y cambie su valor para especificar un tipo de PMU diferente:
```
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
Consejo: Para evitar recibir un error como "ERROR: (gcloud.compute.instances.update-from-file) Cannot parse YAML: [Expected type for field value, found True (type )]" , agregue comillas ( ' ' ) alrededor de cualquier valor de etiqueta de yes o no en el archivo de configuración de instancia exportado. Esto indica que los valores son cadenas, no valores booleanos.
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

Cree un archivo JSON vacío.
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.
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. Localice el campo performanceMonitoringUnit y luego cambie su valor para especificar un tipo de PMU diferente:
```
"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
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 las propiedades de la VM .

Deshabilitar la PMU en una VM

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

Para deshabilitar la PMU en una VM existente, seleccione una de las siguientes opciones:

nube de gcloud

Cree un archivo YAML vacío.
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.
En el archivo de configuración YAML, ubique el campo performanceMonitoringUnit y establezca su valor en NONE :
```
advancedMachineFeatures:
  performanceMonitoringUnit: NONE
```
Consejo: Para evitar recibir un error como "ERROR: (gcloud.compute.instances.update-from-file) Cannot parse YAML: [Expected type for field value, found True (type )]" , agregue comillas ( ' ' ) alrededor de cualquier valor de etiqueta de yes o no en el archivo de configuración de instancia exportado. Esto indica que los valores son cadenas, no valores booleanos.
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

Cree un archivo JSON vacío.
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.
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. Localice el campo performanceMonitoringUnit y luego cambie su valor a NONE :
```
"advancedMachineFeatures": {
  "performanceMonitoringUnit": "NONE"
}
```
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": "NONE"
  },
  ...
}
```

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

¿Qué sigue?

Establecer el número de subprocesos por núcleo

Administrar la PMU en VM,Administrar la PMU en VM Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Antes de comenzar

gcloud

REST

Roles requeridos

Permisos requeridos

Cambiar el tipo de PMU en una VM

nube de gcloud

DESCANSAR

Deshabilitar la PMU en una VM

nube de gcloud

DESCANSAR

¿Qué sigue?

Antes de comenzar

gcloud

REST

Roles requeridos

Permisos requeridos

Cambiar el tipo de PMU en una VM

nube de gcloud

DESCANSAR

Deshabilitar la PMU en una VM

nube de gcloud

DESCANSAR

¿Qué sigue?

Administrar la PMU en VM,Administrar la PMU en VM
Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.