Ativar a PMU em instâncias do Compute Engine

gcloud

1. Crie um arquivo YAML vazio.

2. Para exportar as propriedades de uma instância de computação para o arquivo YAML que você acabou de criar, use o comando gcloud compute instances export:

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

   Substitua:

   • INSTANCE_NAME: o nome da instância de computação.

   • YAML_FILE: o caminho para o arquivo YAML que você criou na etapa anterior.

   • ZONE: a zona em que a instância de computação está.

3. No arquivo de configuração YAML, no campo advancedMachineFeatures, adicione o campo performanceMonitoringUnit. Se o campo advancedMachineFeatures não existir, adicione-o também:

   advancedMachineFeatures:
     performanceMonitoringUnit: PMU_TYPE
   

   Substitua PMU_TYPE por um dos seguintes valores:

   • Tipo de PMU arquitetônica: ARCHITECTURAL

   • Tipo de PMU padrão: STANDARD

   • Tipo de PMU aprimorada: ENHANCED

4. Para atualizar e reiniciar a instância de computação, use o comando gcloud compute instances update-from-file com a flag --most-disruptive-allowed-action definida como RESTART:

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

   Substitua YAML_FILE pelo caminho para o arquivo YAML com os dados de configuração que você modificou na etapa anterior.

REST

1. Para conferir as propriedades de uma instância de computação atual, faça uma solicitação GET para o método instances.get:

   GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME
   

   Substitua:

   • PROJECT_ID: o ID do projeto em que você criou a instância de computação.

   • ZONE: a zona em que a instância de computação está.

   • INSTANCE_NAME: o nome da instância de computação.

2. Para atualizar e reiniciar a instância de computação, faça uma solicitação PUT ao método instances.update da seguinte maneira:

   • No URL da solicitação, inclua o parâmetro de consulta mostDisruptiveAllowedAction definido como RESTART.

   • Para o corpo da solicitação, use a saída da solicitação GET da etapa anterior. No entanto, no campo advancedMachineFeatures, é necessário adicionar o campo performanceMonitoringUnit para ativar a PMU. Se o campo advancedMachineFeatures não existir na saída da solicitação, adicione-o também:

   A solicitação PUT é semelhante a esta:

   PUT https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=RESTART
   
   {
     "advancedMachineFeatures": {
       "performanceMonitoringUnit": "PMU_TYPE"
     },
     ...
   }
   

   Substitua PMU_TYPE por um dos seguintes valores:

   • Tipo de PMU arquitetônica: ARCHITECTURAL

   • Tipo de PMU padrão: STANDARD

   • Tipo de PMU aprimorada: ENHANCED

gcloud

Para criar uma instância de computação com a PMU ativada, use o comando gcloud compute instances create com a flag --performance-monitoring-unit:

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

Substitua:

• INSTANCE_NAME: o nome da instância de computação.

• MACHINE_TYPE: o tipo de máquina da instância de computação. Se você quiser ativar o tipo de PMU aprimorado em uma instância de computação, só será possível fazer isso se a instância usar um tipo de máquina compatível.

• PMU_TYPE: o tipo de PMU a ser ativado na instância de computação. Especifique um dos seguintes valores:

  • Tipo de PMU arquitetônica: architectural

  • Tipo de PMU padrão: standard

  • Tipo de PMU aprimorada: enhanced

• ZONE: a zona em que a instância de computação será criada.

REST

Para criar uma instância de computação com a PMU ativada, faça uma solicitação POST ao método instances.insert. No corpo da solicitação, inclua o campo performanceMonitoringUnit:

POST https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "INSTANCE_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"
  }
}

Substitua:

• PROJECT_ID: o ID do projeto em que a instância de computação será criada.

• ZONE: a zona em que a instância de computação será criada.

• INSTANCE_NAME: o nome da instância de computação.

• MACHINE_TYPE: o tipo de máquina da instância de computação. Se você quiser ativar o tipo de PMU aprimorado em uma instância de computação, só será possível fazer isso se a instância usar um tipo de máquina compatível.

• IMAGE_PROJECT: o projeto que contém a imagem, como debian-cloud. Para mais detalhes sobre os projetos de imagem disponíveis, consulte Imagens públicas.

• IMAGE: especifique uma destas opções:

  • Uma versão específica da imagem do SO, como debian-12-bookworm-v20240617.

  • Uma família de imagens, que precisa ter o formato family/IMAGE_FAMILY. Ela especifica a imagem do SO mais recente e não descontinuada. Por exemplo, se você especificar family/debian-12, a versão mais recente na família de imagens do Debian 12 será usada. Para saber como usar famílias de imagens, consulte Práticas recomendadas para famílias de imagens.

• PMU_TYPE: o tipo de PMU a ser ativado na instância de computação. Especifique um dos seguintes valores:

  • Tipo de PMU arquitetônica: ARCHITECTURAL

  • Tipo de PMU padrão: STANDARD

  • Tipo de PMU aprimorada: ENHANCED

gcloud

Para criar um modelo de instância que especifique a ativação da PMU, use o comando gcloud compute instance-templates create com a flag --performance-monitoring-unit.

Por exemplo, use o seguinte comando para criar um modelo de instância regional. Se você quiser criar um modelo de instância global, use o mesmo comando sem a flag --instance-template-region.

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

Substitua:

• INSTANCE_TEMPLATE_NAME: o nome do modelo de instância.

• REGION: a região em que o modelo de instância será criado.

• MACHINE_TYPE: o tipo de máquina das instâncias de computação. Se você quiser ativar o tipo de PMU aprimorado em uma instância de computação, só será possível fazer isso se a instância usar um tipo de máquina compatível.

• PMU_TYPE: o tipo de PMU a ser incluído no modelo de instância. Especifique um dos seguintes valores:

  • Tipo de PMU arquitetônica: architectural

  • Tipo de PMU padrão: standard

  • Tipo de PMU aprimorada: enhanced

REST

Para criar um modelo de instância que especifique a ativação da PMU, faça uma solicitação POST para um dos seguintes métodos:

• Para criar um modelo de instância global: método instanceTemplates.insert.

• Para criar um modelo de instância regional: método regionInstanceTemplates.insert.

No corpo da solicitação, inclua o campo performanceMonitoringUnit.

Por exemplo, para criar um modelo de instância regional que especifique a ativação da PMU, faça uma solicitação POST da seguinte maneira:

POST https://compute.s3nsapis.fr/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"
    }
  }
}

Substitua:

• PROJECT_ID: o ID do projeto em que o modelo de instância será criado.

• REGION: a região em que o modelo de instância será criado.

• INSTANCE_TEMPLATE_NAME: o nome do modelo de instância.

• IMAGE_PROJECT: o projeto que contém a imagem, como debian-cloud. Para mais detalhes sobre os projetos de imagem disponíveis, consulte Imagens públicas.

• IMAGE: especifique uma destas opções:

  • Uma versão específica da imagem do SO, como debian-12-bookworm-v20240617.

  • Uma família de imagens, que precisa ter o formato family/IMAGE_FAMILY. Ela especifica a imagem do SO mais recente e não descontinuada. Por exemplo, se você especificar family/debian-12, a versão mais recente na família de imagens do Debian 12 será usada. Para saber como usar famílias de imagens, consulte Práticas recomendadas para famílias de imagens.

• MACHINE_TYPE: o tipo de máquina das instâncias de computação. Se você quiser ativar o tipo de PMU aprimorado em uma instância de computação, só será possível fazer isso se a instância usar um tipo de máquina compatível.

• PMU_TYPE: o tipo de PMU a ser incluído no modelo de instância. Especifique um dos seguintes valores:

  • Tipo de PMU arquitetônica: ARCHITECTURAL

  • Tipo de PMU padrão: STANDARD

  • Tipo de PMU aprimorada: ENHANCED