Visualizza la flessibilità dell'istanza

Questo documento descrive come visualizzare la configurazione della flessibilità delle istanze in un gruppo di istanze gestite (MIG) e i tipi di macchine utilizzati da ogni VM nel gruppo.

Dopo aver aggiunto o modificato la flessibilità delle istanze in un MIG, puoi:

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 in base a come prevedi di utilizzare gli esempi in questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud , non devi configurare l'autenticazione.

    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 documentazione sull'autenticazione di Google Cloud .

Visualizza la configurazione della flessibilità delle istanze

Console

  1. Nella console Google Cloud , vai alla pagina Gruppi di istanze.

    Vai a Gruppi di istanze

  2. Nella colonna Nome, fai clic sul nome del MIG di cui vuoi visualizzare la configurazione della flessibilità delle istanze.

    Si apre la pagina di riepilogo del gruppo di istanze gestite.

  3. Fai clic sulla scheda Dettagli.

    Nella sezione Flessibilità delle istanze, la tabella Selezioni di istanze mostra il nome, il ranking e i tipi di macchine di una selezione. Se nel MIG non è configurata la flessibilità delle istanze, la sezione Flessibilità delle istanze non viene visualizzata.

gcloud

Per visualizzare la configurazione della flessibilità delle istanze, utilizza il comando instance-groups managed describe. Includi il flag --format per filtrare le proprietà instanceFlexibilityPolicy.instanceSelections.

  gcloud compute instance-groups managed describe INSTANCE_GROUP_NAME \
      --region REGION \
      --format="json(instanceFlexibilityPolicy.instanceSelections)"

Di seguito è riportato un output di esempio:

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

Se per un MIG non è configurata la flessibilità delle istanze, l'output restituisce null.

Sostituisci quanto segue:

  • INSTANCE_GROUP_NAME: il nome del MIG di cui vuoi visualizzare la configurazione della flessibilità delle istanze.
  • REGION: la regione in cui si trova il MIG.

REST

Per visualizzare la configurazione della flessibilità delle istanze, utilizza il metodo regionInstanceGroupManagers.get. Includi il parametro fields nell'URL della richiesta per filtrare le proprietà instanceFlexibilityPolicy.instanceSelections.

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME?fields=instanceFlexibilityPolicy.instanceSelections

Di seguito è riportato un output di esempio:

{
  "instanceFlexibilityPolicy": {
    "instanceSelections": {
      "instance-selection-1": {
        "machineTypes": [
          "n1-standard-16",
          "n2-standard-16",
          "e2-standard-16"
        ],
        "rank": 1
      }
    }
  }
}

Se per un MIG non è configurata la flessibilità delle istanze, l'output restituisce null.

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • REGION: la regione in cui si trova il MIG.
  • INSTANCE_GROUP_NAME: il nome del MIG di cui vuoi visualizzare la configurazione della flessibilità delle istanze.

Visualizza i tipi di macchina utilizzati da ogni VM

Console

  1. Nella console Google Cloud , vai alla pagina Gruppi di istanze.

    Vai a Gruppi di istanze

  2. Nella colonna Nome, fai clic sul nome del MIG in cui vuoi visualizzare i tipi di macchine utilizzati da ogni VM.

    Viene visualizzata la pagina Panoramica del MIG, che elenca tutte le VM del gruppo, i relativi tipi di macchina e altri dettagli.

gcloud

Per visualizzare i tipi di macchine utilizzati da ogni VM in un MIG, elenca le VM utilizzando il comando instance-groups managed list-instances e includi il flag --format per filtrare il campo propertiesFromFlexibilityPolicy.machineType. Puoi anche filtrare altri campi in base alle tue esigenze.

  gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
      --region REGION \
      --format='(name,instanceStatus,currentAction,propertiesFromFlexibilityPolicy.machineType,lastAttempt.errors.errors)'

Di seguito è riportato un output di esempio:

NAME: example-mig-0md2
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

NAME: example-mig-vbgg
STATUS: RUNNING
ACTION: NONE
MACHINE_TYPE: n1-standard-16
LAST_ERROR:

Sostituisci quanto segue:

  • REGION: la regione in cui si trova il MIG.
  • INSTANCE_GROUP_NAME: il nome del MIG di cui vuoi visualizzare la configurazione della flessibilità delle istanze.

REST

Per visualizzare i tipi di macchine utilizzati da ogni VM in un MIG, elenca le VM utilizzando il metodo listManagedInstances e controlla il campo propertiesFromFlexibilityPolicy.machineType nella risposta.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

Di seguito è riportato un output di esempio. Cerca il campo propertiesFromFlexibilityPolicy in cui è impostato il campo machineType di una VM.

{
  "managedInstances": [
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-0md2",
      "instanceStatus": "RUNNING",
      "id": "2656095434923471959",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-0md2",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    },
    {
      "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-b/instances/example-mig-vbgg",
      "instanceStatus": "RUNNING",
      "currentAction": "NONE",
      "id": "9171259522409694366",
      "version": {
        "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-instance-template"
      },
      "targetStatus": "RUNNING",
      "name": "example-mig-vbgg",
      "propertiesFromFlexibilityPolicy": {
        "machineType": "n1-standard-16"
      }
    }
  ]
}

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto.
  • REGION: la regione in cui si trova il MIG.
  • INSTANCE_GROUP_NAME: il nome del MIG di cui vuoi visualizzare la configurazione della flessibilità delle istanze.

Monitora la distribuzione delle istanze

Il controllo della policy di flessibilità delle istanze statiche e l'elenco dei singoli tipi di macchine delle VM forniscono un'istantanea della configurazione attuale, ma l'osservazione del modo in cui il MIG alloca la capacità nel tempo richiede un monitoraggio in tempo reale.

Per verificare che le VM siano distribuite tra i rank e le località previsti quando la domanda o la capacità cambiano, puoi visualizzare la distribuzione delle istanze di runtime per un MIG specifico o i dati aggregati di più MIG. Per istruzioni su come visualizzare la distribuzione delle istanze, consulta Monitora la distribuzione delle istanze nei MIG.

Passaggi successivi