Gestisci la PMU nelle istanze di Compute Engine

Dopo aver attivato la PMU in un'istanza di computing ed eseguito il software di monitoraggio delle prestazioni sull'istanza di computing, puoi seguire questi passaggi:

  • Modifica il tipo di PMU attivata nell'istanza di computing. Questa modifica è utile quando vuoi monitorare diversi tipi di eventi della CPU a basso livello.

  • Disattiva la PMU nell'istanza di computing. Questa azione è utile quando non hai più bisogno di accedere ai contatori delle prestazioni nella PMU.

Questo documento spiega come modificare il tipo o disattivare l'unità di monitoraggio delle prestazioni (PMU) attivata in un'istanza Compute Engine. Per saperne di più sulla PMU, consulta la panoramica della PMU.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Seleziona la scheda relativa alla modalità di utilizzo degli esempi in questa pagina:

    gcloud

    1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  • Imposta una regione e una zona predefinite.

    • REST

    Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

      Installa Google Cloud CLI.

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticati per usare REST nella Google Cloud documentazione sull'autenticazione di.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per modificare il tipo o disattivare la PMU attivata in un'istanza di computing, chiedi all'amministratore di concederti il ruolo IAM Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per modificare il tipo o disattivare la PMU attivata in un'istanza di computing. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per modificare il tipo o disattivare la PMU attivata in un'istanza di computing sono necessarie le seguenti autorizzazioni:

  • Per aggiornare un'istanza di computing: compute.instances.update sull'istanza di computing

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Modifica il tipo di PMU in un'istanza di computing

Prima di modificare il tipo di PMU per un'istanza A4X, C4A, C4 o M4 esistente, visualizza i dettagli dell'istanza di computing utilizzando Google Cloud CLI o l'API REST. Nell'output del comando o della richiesta API, verifica quanto segue:

  1. Per verificare che il tipo di PMU sia attivato nell'istanza di computing, controlla il valore del campo performanceMonitoringUnit. Se il campo non è presente, la PMU è disattivata.

  2. Se vuoi attivare il tipo di PMU avanzata, devi verificare che l'istanza di computing utilizzi uno dei seguenti tipi di macchine controllando il valore del campo machineType:

    • Un tipo di macchina C4 con 144 o 288 vCPU

    • Uno dei seguenti tipi di macchine M4:

      • m4-megamem-112

      • m4-megamem-224

      • m4-ultramem-56

      • m4-ultramem-112

      • m4-ultramem-224

    Se l'istanza di computing utilizza un tipo di macchina diverso, devi modificarlo prima di poter monitorare i tipi di PMU avanzati.

Non è necessario arrestare l'istanza di computing per modificare il tipo di PMU. Tuttavia, per applicare la modifica, devi riavviare l'istanza di computing come descritto in questa sezione.

Per modificare il tipo di PMU attivata in un'istanza di computing esistente, seleziona una delle seguenti opzioni:

gcloud

  1. Crea un file YAML vuoto.

  2. Per esportare le proprietà di un'istanza di computing nel file YAML che hai appena creato, utilizza il gcloud compute instances export comando:

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

    Sostituisci quanto segue:

    • INSTANCE_NAME: il nome dell'istanza di computing.

    • YAML_FILE: il percorso del file YAML creato nel passaggio precedente.

    • ZONE: la zona in cui esiste l'istanza di computing.

  3. Nel file di configurazione YAML, individua il campo performanceMonitoringUnit e modifica il relativo valore per specificare un tipo di PMU diverso:

    advancedMachineFeatures:
  performanceMonitoringUnit: PMU_TYPE

    Sostituisci PMU_TYPE con uno dei seguenti valori:

    • Tipo di PMU Architettura: ARCHITECTURAL

    • Tipo di PMU Standard: STANDARD

    • Tipo di PMU Avanzata: ENHANCED

  4. Per aggiornare l'istanza di computing e riavviarla, utilizza il gcloud compute instances update-from-file comando con il --most-disruptive-allowed-action flag impostato su RESTART:

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

    Sostituisci quanto segue:

    • INSTANCE_NAME: il nome dell'istanza di computing.

    • YAML_FILE: il percorso del file YAML con i dati di configurazione modificati nel passaggio precedente.

    • ZONE: la zona in cui esiste l'istanza di computing.

REST

  1. Per visualizzare le proprietà di un'istanza di computing esistente, effettua una GET richiesta al instances.get metodo:

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

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto in cui si trova l'istanza di computing.

    • ZONE: la zona in cui esiste l'istanza di computing.

    • INSTANCE_NAME: il nome di un'istanza di computing esistente.

  2. Per aggiornare l'istanza di computing e riavviarla, effettua una PUT richiesta a il instances.update metodo come segue:

    • Nell'URL della richiesta, includi il parametro di query mostDisruptiveAllowedAction impostato su RESTART.

    • Per il corpo della richiesta, utilizza l'output della richiesta GET del passaggio precedente. Tuttavia, nel campo advancedMachineFeatures, devi modificare il valore del campo performanceMonitoringUnit con il tipo di PMU scelto.

    La richiesta PUT è simile alla seguente:

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

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

    Sostituisci PMU_TYPE con uno dei seguenti valori:

    • Tipo di PMU Architettura: ARCHITECTURAL

    • Tipo di PMU Standard: STANDARD

    • Tipo di PMU Avanzata: ENHANCED

Per ulteriori informazioni sull'aggiornamento delle proprietà di un'istanza di computing, consulta Aggiorna le proprietà delle istanze.

Disattiva la PMU in un'istanza di computing

Puoi disattivare la PMU in un'istanza di computing senza arrestarla. Tuttavia, per applicare la modifica, devi riavviare l'istanza di computing come descritto in questa sezione.

Per disattivare la PMU in un'istanza di computing esistente, seleziona una delle seguenti opzioni:

gcloud

  1. Crea un file YAML vuoto.

  2. Per esportare le proprietà di un'istanza di computing nel file YAML che hai appena creato, utilizza il gcloud compute instances export comando:

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

    Sostituisci quanto segue:

    • INSTANCE_NAME: il nome dell'istanza di computing.

    • YAML_FILE: il percorso del file YAML creato nel passaggio precedente.

    • ZONE: la zona in cui esiste l'istanza di computing.

  3. Nel file di configurazione YAML, rimuovi il campo performanceMonitoringUnit. Se il campo advancedMachineFeatures è vuoto, rimuovilo.

    advancedMachineFeatures:
  performanceMonitoringUnit: PMU_TYPE

  4. Per aggiornare l'istanza di computing e riavviarla, utilizza il gcloud compute instances update-from-file comando con il --most-disruptive-allowed-action flag impostato su RESTART:

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

    Sostituisci quanto segue:

    • INSTANCE_NAME: il nome dell'istanza di computing.

    • YAML_FILE: il percorso del file YAML con i dati di configurazione modificati nel passaggio precedente.

    • ZONE: la zona in cui esiste l'istanza di computing.

REST

  1. Per visualizzare le proprietà di un'istanza di computing esistente, effettua una GET richiesta al instances.get metodo:

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

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto in cui esiste l'istanza di computing.

    • ZONE: la zona in cui esiste l'istanza di computing.

    • INSTANCE_NAME: il nome di un'istanza di computing esistente.

  2. Per aggiornare l'istanza di computing e riavviarla, effettua una PUT richiesta a il instances.update metodo. Nella richiesta, segui questi passaggi:

    • Nell'URL della richiesta, includi il parametro di query mostDisruptiveAllowedAction impostato su RESTART.

    • Per il corpo della richiesta, utilizza l'output della richiesta GET del passaggio precedente. Tuttavia, devi rimuovere il campo performanceMonitoringUnit e, se non sono presenti altri campi nel campo advancedMachineFeatures, anche il campo advancedMachineFeatures.

    La richiesta PUT è simile alla seguente:

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

{
  ~"advancedMachineFeatures": {
    ...
  }~,
  ...
}

Per ulteriori informazioni sull'aggiornamento delle proprietà di un'istanza di computing, consulta Aggiorna le proprietà delle istanze.

Passaggi successivi