Faça a gestão da PMU em VMs

Este documento explica como alterar o tipo de unidade de monitorização do desempenho (PMU) ativado numa instância de máquina virtual (VM) ou desativá-lo. Para saber mais sobre a PMU, consulte a vista geral da PMU.

Depois de ativar a PMU numa MV e executar software de monitorização do desempenho na MV, pode fazer o seguinte:

  • Altere o tipo de PMU ativado na VM. Esta alteração é útil quando quer acompanhar diferentes tipos de eventos de CPU de baixo nível.

  • Desative a PMU na VM. Esta ação é útil quando já não precisa de aceder aos contadores de desempenho na PMU.

Antes de começar

  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se no Compute Engine selecionando uma das seguintes opções:

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

    gcloud

    1. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    Para mais informações, consulte o artigo Autenticar para usar REST na Google Cloud documentação de autenticação.

Funções necessárias

Para receber as autorizações de que precisa para alterar o tipo de PMU ativado numa VM ou desativá-lo, peça ao seu administrador para lhe conceder a função de IAM Administrador de instâncias do Compute (v1) (roles/compute.instanceAdmin.v1) no seu projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para alterar o tipo de PMU ativado numa VM ou desativá-lo. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

As seguintes autorizações são necessárias para alterar o tipo de PMU ativado numa VM ou desativá-lo:

  • Para atualizar uma VM: compute.instances.update na VM

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Altere o tipo de PMU numa VM

Antes de alterar o tipo de PMU ativado numa VM C4A ou C4 existente, veja os detalhes da VM através da CLI Google Cloud ou da API REST. Na saída do comando ou do pedido da API, verifique o seguinte:

  1. Para verificar o tipo de PMU ativado na VM, verifique o valor do campo performanceMonitoringUnit. Se o campo estiver em falta, a PMU está desativada.

  2. Se quiser ativar o tipo de PMU melhorado, certifique-se de que a VM está a usar um tipo de máquina C4 com 96 ou 192 vCPUs verificando o valor do campo machineType. Caso contrário, altere o tipo de máquina da VM.

Não tem de parar a VM para alterar o tipo de PMU ativado na mesma. No entanto, para tornar a alteração efetiva, tem de reiniciar a VM conforme descrito nesta secção.

Para alterar o tipo de PMU ativado numa VM existente, selecione uma das seguintes opções:

gcloud

  1. Crie um ficheiro YAML vazio.

  2. Para exportar as propriedades de uma VM para o ficheiro YAML que acabou de criar, use o comando gcloud compute instances export:

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

    Substitua o seguinte:

    • VM_NAME: o nome da VM.

    • YAML_FILE: o caminho para o ficheiro YAML que criou no passo anterior.

    • ZONE: a zona onde a VM está localizada.

  3. No ficheiro de configuração YAML, localize o campo performanceMonitoringUnit e altere o respetivo valor para especificar um tipo de PMU diferente:

    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 melhorado: ENHANCED

  4. Para atualizar a VM e reiniciá-la, 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 VM_NAME \
    --most-disruptive-allowed-action=RESTART \
    --source=YAML_FILE \
    --zone=ZONE

    Substitua o seguinte:

    • VM_NAME: o nome da VM.

    • YAML_FILE: o caminho para o ficheiro YAML com os dados de configuração que modificou no passo anterior.

    • ZONE: a zona onde a VM está localizada.

REST

  1. Crie um ficheiro JSON vazio.

  2. Para ver as propriedades de uma VM existente, faça um pedido GET ao métodoinstances.get:

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

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto onde a VM está localizada.

    • ZONE: a zona onde a VM está localizada.

    • VM_NAME: o nome de uma VM existente.

  3. No ficheiro JSON vazio que criou nos passos anteriores, faça o seguinte:

    1. Introduza as propriedades da VM a partir do resultado do pedido GET.

    2. Localize o campo performanceMonitoringUnit e, em seguida, altere o respetivo valor para especificar um tipo de PMU diferente:

      "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 melhorado: ENHANCED

  4. Para atualizar a VM e reiniciá-la, faça um pedido PUT ao métodoinstances.update. Na solicitação, faça o seguinte:

    • No URL do pedido, inclua o parâmetro de consulta mostDisruptiveAllowedAction definido como RESTART.

    • Para o corpo do pedido, use as propriedades da VM do ficheiro JSON que criou e atualizou nos passos anteriores.

    O pedido é semelhante ao seguinte:

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

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

Para mais informações sobre a atualização das propriedades de uma MV, consulte o artigo Atualize as propriedades da MV.

Desative a PMU numa VM

Não tem de parar a VM para desativar a PMU. No entanto, para que a alteração entre em vigor, tem de reiniciar a VM, conforme descrito nesta secção.

Para desativar a PMU numa VM existente, selecione uma das seguintes opções:

gcloud

  1. Crie um ficheiro YAML vazio.

  2. Para exportar as propriedades de uma VM para o ficheiro YAML que acabou de criar, use o comando gcloud compute instances export:

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

    Substitua o seguinte:

    • VM_NAME: o nome da VM.

    • YAML_FILE: o caminho para o ficheiro YAML que criou no passo anterior.

    • ZONE: a zona onde a VM está localizada.

  3. No ficheiro de configuração YAML, localize o campo performanceMonitoringUnit e defina o respetivo valor como NONE:

    advancedMachineFeatures:
  performanceMonitoringUnit: NONE

  4. Para atualizar a VM e reiniciá-la, 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 VM_NAME \
    --most-disruptive-allowed-action=RESTART \
    --source=YAML_FILE \
    --zone=ZONE

    Substitua o seguinte:

    • VM_NAME: o nome da VM.

    • YAML_FILE: o caminho para o ficheiro YAML com os dados de configuração que modificou no passo anterior.

    • ZONE: a zona onde a VM está localizada.

REST

  1. Crie um ficheiro JSON vazio.

  2. Para ver as propriedades de uma VM existente, faça um pedido GET ao métodoinstances.get:

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

    Substitua o seguinte:

    • PROJECT_ID: o ID do projeto onde a VM está localizada.

    • ZONE: a zona onde a VM está localizada.

    • VM_NAME: o nome de uma VM existente.

  3. No ficheiro JSON vazio que criou nos passos anteriores, faça o seguinte:

    1. Introduza as propriedades da VM a partir do resultado do pedido GET.

    2. Localize o campo performanceMonitoringUnit e, em seguida, altere o respetivo valor para NONE:

      "advancedMachineFeatures": {
  "performanceMonitoringUnit": "NONE"
}

  4. Para atualizar a VM e reiniciá-la, faça um pedido PUT ao métodoinstances.update. Na solicitação, faça o seguinte:

    • No URL do pedido, inclua o parâmetro de consulta mostDisruptiveAllowedAction definido como RESTART.

    • Para o corpo do pedido, use as propriedades da VM do ficheiro JSON que criou e atualizou nos passos anteriores.

    O pedido é semelhante ao seguinte:

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

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

Para mais informações sobre a atualização das propriedades de uma MV, consulte o artigo Atualize as propriedades da MV.

O que se segue?