Visualizza informazioni su MIG e istanze gestite

Utilizza i metodi descritti in questa pagina per visualizzare informazioni sul tuo gruppi di istanze gestite e visualizzare informazioni sulle istanze di macchine virtuali (VM) all'interno ogni gruppo di istanze gestite.

Prima di iniziare

• Esamina il limitazioni poi crea un gruppo.
• Se non l'hai ancora fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione Compute Engine come segue.
  

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

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Visualizza le informazioni sui gruppi di istanze gestite

Puoi recuperare le informazioni sui gruppi, ad esempio, per ispezionare i criteri associati al gruppo e per verificare se il gruppo stabili o in fase di modifica. Per informazioni sulle istanze VM all'interno di un gruppo di istanze gestite, consulta Visualizzare le informazioni sulle istanze gestite.

Elenca MIG

Per ottenere un elenco dei tuoi gruppi di istanze gestite, utilizza console, gcloud CLI o REST.

gcloud compute instance-groups managed list

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers

Visualizzare le proprietà di un gruppo di istanze gestite

Per visualizzare le informazioni su un gruppo MIG specifico, inclusi i relativi criteri (ad esempio i criteri di riparazione automatica e di aggiornamento del gruppo), utilizza la console, la CLI gcloud o REST.

Per visualizzare il valore id del gruppo, devi utilizzare gcloud CLI o l'API Compute Engine.

gcloud compute instance-groups managed describe instance-group \
    [--zone zone | --region region]

gcloud compute instance-groups managed describe instance-group --format="(autoscaler)"

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/regionAutoscalers/mig_name

Controllare se un gruppo MIG è stabile

Diversi comandi e richieste creano, eliminano e modificano le istanze in un ambiente gruppo di istanze gestite. Queste operazioni vengono restituite come DONE dopo che il gruppo ha pianificato azioni per creare, eliminare o aggiornare queste istanze. Tuttavia, questo non significa che le istanze nel gruppo siano state create, eliminate o aggiornate fino al completamento delle azioni sottostanti. Devi verificare lo stato del gruppo o, in alternativa, verifica lo stato di queste istanze.

Un gruppo di istanze gestite è stabile quando tutte le istanze del gruppo di istanze gestite non subiscono modifiche, non sono pianificate modifiche future per le istanze e il gruppo stesso non viene modificato.

Potresti dover sapere se il gruppo è stabile quando hai dipendenze che si basano sul fatto che tutte le istanze del gruppo siano attive e funzionanti. Ad esempio: potresti voler iniziare a pianificare job, inviare traffico o assegnare chiavi dopo aver confermato che tutte le VM sono in esecuzione e integre.

Verifica che tutte le istanze in un gruppo di istanze gestite siano in esecuzione e in stato integro controllando il valore del campo status.isStable del gruppo.

gcloud compute instance-groups managed describe instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed wait-until instance-group-name \
    --stable \
    [--zone zone | --region region]
Waiting for group to become stable, current operations: deleting: 4
Waiting for group to become stable, current operations: deleting: 4
...
Group is stable

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/get

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group-name/get

status.isStable impostato su false indica che le modifiche sono attive, in attesa o che il gruppo di istanze gestite viene modificato.

Il campo status.isStable impostato su true indica quanto segue:

• Nessuna delle istanze nel gruppo di istanze gestite sta subendo alcun tipo di modifica e currentAction per tutte le istanze è NONE.
• Non sono presenti modifiche in attesa per le istanze nel gruppo di istanze gestite.
• Il gruppo di istanze gestite stesso non viene modificato.

Ricorda che la stabilità di un gruppo di istanze gestite dipende da numerosi fattori, in quanto un gruppo di istanze gestite può essere modificato in diversi modi. Ad esempio:

• Effettua una richiesta di implementazione di un nuovo modello di istanza.
• Puoi effettuare una richiesta per creare, eliminare, ridimensionare o aggiornare le istanze nel gruppo di istanze gestite.
• Un gestore della scalabilità automatica richiede di ridimensionare il MIG.
• Una risorsa di riparazione automatica sta sostituendo una o più istanze non attive nel gruppo di istanze gestite.
• In un gruppo di istanze gestite a livello di regione, alcune istanze vengono ridistribuito.

Una volta completate tutte le azioni, status.isStable viene impostato di nuovo su true per quel MIG.

Per le singole istanze VM, consulta Verificare lo stato delle istanze gestite.

Controlla se le riparazioni delle VM sono disattivate in un MIG

Per verificare se le riparazioni delle VM sono disattivate in un gruppo di istanze gestite, utilizza la console, la CLI gcloud o la API.

gcloud compute instance-groups managed describe instance-group \
    --format="(instanceLifecyclePolicy)"

instanceLifecyclePolicy:
  defaultActionOnFailure: REPAIR
  forceUpdateOnRepair: NO

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP

"instanceLifecyclePolicy": {
  "forceUpdateOnRepair": "NO",
  "defaultActionOnFailure": "REPAIR"
}

Se non vuoi che un gruppo di istanze gestite ripari una VM non funzionante o non in stato ottimale nel gruppo, puoi disattivare le riparazioni nel gruppo di istanze gestite.

Visualizzare le operazioni di riparazione automatica storiche

Se hai configurato la riparazione automatica, puoi visualizzare gli eventi di riparazione automatica passati.

Monitorare gli aggiornamenti in sequenza

Se hai avviato un aggiornamento in sequenza e vuoi sapere quando è terminato, consulta Monitorare gli aggiornamenti.

Visualizza la configurazione stateful

Se hai configurato un MIG stateful e vuoi rivedere la tua configurazione, Visualizzazione della configurazione stateful.

Visualizza le informazioni sulle istanze VM gestite all'interno di un gruppo di istanze gestite

Elenca le istanze gestite di un gruppo di istanze gestite

Per ottenere un elenco delle istanze gestite in un gruppo, inclusi i relativi stati e , utilizza console, gcloud CLI o REST.

gcloud compute instance-groups managed list-instances instance-group \
    [--zone zone | --region region]

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group

GET https://compute.googleapis.com/compute/v1/projects/project-id/regions/region/instanceGroupManagers/instance-group

Controlla lo stato delle istanze gestite

Diversi comandi e richieste creano, eliminano e modificano le istanze in un ambiente gruppo di istanze gestite. Queste operazioni vengono restituite come DONE dopo che il gruppo e azioni pianificate per creare, eliminare o aggiornare queste istanze. Tuttavia, questo non significa che le istanze del gruppo siano state create, eliminate o aggiornate fino al completamento di queste azioni sottostanti. Devi verificare lo stato di queste istanze oppure lo stato del gruppo stesso.

Utilizza Google Cloud CLI o REST per visualizzare i dettagli sulle istanze in un gruppo di istanze gestite. I dettagli includono lo stato delle istanze e le azioni correnti svolte dal gruppo sulle sue istanze.

gcloud compute instance-groups managed list-instances INSTANCE_GROUP_NAME \
    [--zone=ZONE | --region=REGION]

NAME               ZONE           STATUS   HEALTH_STATE  ACTION  INSTANCE_TEMPLATE  VERSION_NAME  LAST_ERROR
vm-instances-9pk4  us-central1-f                          CREATING  my-new-template
vm-instances-h2r1  us-central1-f  STOPPING                DELETING  my-old-template
vm-instances-j1h8  us-central1-f  RUNNING                 NONE      my-old-template
vm-instances-ngod  us-central1-f  RUNNING                 NONE      my-old-template

gcloud compute instance-groups managed describe-instance INSTANCE_GROUP_NAME \
    --instance INSTANCE_NAME \
    [--zone=ZONE | --region=REGION]

currentAction: NONE
id: '6789072894767812345'
instance: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/instances/example-mig-hz41
instanceStatus: RUNNING
name: example-mig-hz41
preservedStateFromConfig:
  metadata:
    example-key: example-value
preservedStateFromPolicy:
  disks:
    persistent-disk-0:
      autoDelete: NEVER
      mode: READ_WRITE
      source: https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-a/disks/example-mig-hz41
version:
  instanceTemplate: https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/INSTANCE_GROUP_NAME/listManagedInstances

{
 "managedInstances": [
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-prvp",
   "id": "5317605642920955957",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-pz5j",
   "currentAction": "DELETING"
  },
  {
   "instance": "https://www.googleapis.com/compute/v1/projects/example-project/zones/us-central1-f/instances/vm-instances-w2t5",
   "id": "2800161036826218547",
   "instanceStatus": "RUNNING",
   "instanceTemplate": "https://www.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates/example-template",
   "currentAction": "REFRESHING"
  }
 ]
}

Per visualizzare un elenco di valori di campo instanceStatus validi, consulta Ciclo di vita di un'istanza VM.

Se un'istanza è in fase di modifica, il gruppo di istanze gestite imposta il campo currentAction dell'istanza su una delle seguenti azioni su per aiutarti a tenere traccia dell'avanzamento del cambiamento. In caso contrario, il campo currentAction è impostato su NONE.

I valori possibili di currentAction sono:

• ABANDONING. È in corso la rimozione dell'istanza dal gruppo di istanze gestite.
• CREATING. L'istanza è in fase di creazione.
• CREATING_WITHOUT_RETRIES. L'istanza viene creata senza tentativi di ripetizione. Se l'istanza non viene creata al primo tentativo, il gruppo di istanze gestite non tenta di sostituirla di nuovo.
• DELETING. L'istanza è in fase di eliminazione.
• RECREATING. L'istanza verrà sostituita.
• REFRESHING. L'istanza viene rimossa dai pool di destinazione attuali e aggiunta nuovamente all'elenco dei pool di destinazione attuali (questo elenco potrebbe essere uguale o diverso dai pool di destinazione esistenti).
• RESTARTING. L'istanza è in fase di riavvio utilizzando i metodi stop e start.
• RESUMING. L'istanza è in fase di ripresa dopo essere stata sospeso.
• STARTING. L'istanza è in fase di avvio dopo essere stata è stata interrotta.
• STOPPING. L'istanza è in fase di arresto.
• SUSPENDING. L'istanza è in fase di sospensione.
• VERIFYING. L'istanza è stata creata ed è in fase di verificati.
• NONE. Non vengono eseguite azioni sull'istanza.

Per verificare se il gruppo nel suo complesso è stabile o sta subendo modifiche, consulta Controllare lo stato del gruppo.

Controllare gli stati di integrità

Se hai configurato la riparazione automatica per il tuo gruppo di istanze gestite, puoi per rivedere lo stato di integrità di ogni VM. Consulta Controllare lo stato di integrità.

Elenca gli errori delle istanze

Se le istanze gestite hanno riscontrato errori, puoi visualizzarli per diagnosticare e mitigare la causa.

Utilizza la console Google Cloud, gcloud CLI o REST per dall'elenco degli errori.

gcloud compute instance-groups managed list-errors instance-group-name \
    [--zone zone | --region region]

gcloud compute instance-groups managed list-errors example-group \
    --region us-west1

INSTANCE_URL                                                                                        ACTION    ERROR_CODE      ERROR_MESSAGE                                                                                     TIMESTAMP                      INSTANCE_TEMPLATE                                                                                                            VERSION_NAME

https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-v0hl  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-v0hl' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.156-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
https://www.googleapis.com/compute/v1/projects/my-project/zones/us-central1-a/instances/igm-1-qp3d  CREATING  QUOTA_EXCEEDED  Instance 'igm-1-qp3d' creation failed: Quota 'CPUS' exceeded.  Limit: 1.0 in zone us-central1-a.  2019-07-11T07:44:40.081-07:00  https://www.googleapis.com/compute/v1/projects/my-project/global/instanceTemplates/instance-template-1
...

GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100

{
 "items": [
  {
   "error": {
    "code": "QUOTA_EXCEEDED",
    "message": "Instance 'example-mig-m1sz' creation failed: Quota 'CPUS' exceeded.  Limit: 50.0 in zone us-central1-c."
   },
   "timestamp": "2019-01-03T18:47:28.457-08:00",
   "instanceDetails" : {
    "instance": "zones/us-central1-c/instances/example-mig-m1sz",
    "action": "CREATING",
    "version": {
     "name": "example-version-name",
     "instanceTemplate": "global/instanceTemplates/example-template",
    }
   }
  }
 ],
 ...
 "nextPageToken": "Ch0yMDE5LTA3LTI5VDExOjA4OjA2LjYxMi0wNzowMBJ5aHR0cHM6Ly93d3cuZ29vZ2xlYXBpcy5jb20vY29tcHV0ZS9zdGFnaW5nX2FscGhhL3Byb2plY3RzL215cnpha2VyZXltcy1zdGFnaW5nL3pvbmVzL3VzLWNlbnRyYWwxLWlyMS9pbnN0YW5jZXMvaWdtLTEtcXAzZA=="
}

L'elenco dei possibili errori include, a titolo esemplificativo:

• Impossibile creare una nuova istanza per i seguenti motivi:
  • Mancanza di capacità preassegnata.
  • Mancanza di quota, ad esempio per le CPU in una determinata regione.
  • È stato raggiunto il limite di numero di istanze VM per la rete associati al gruppo.
  • L'immagine disco specificata nel campo properties.disks[].initializeParams.sourceImage del modello di istanza è stata eliminata o le sue autorizzazioni sono cambiate.
  • La carta di credito dell'account di fatturazione associato al progetto ha rifiutato un pagamento.
• Impossibile eliminare un'istanza esistente perché:
  • L'account di servizio utilizzato dal gruppo non dispone dell'autorizzazione compute.instances.delete.
  • Sono state richieste troppe eliminazioni simultanee, superando i limiti di frequenza.
• Impossibile aggiungere un'istanza a un pool di destinazione perché il pool di destinazione era eliminati.

Dopo aver esaminato questi errori, puoi mitigarli. Ad esempio:

• Spostare il carico di lavoro in una zona diversa con capacità prerilasciabile.
• Richiedere un aumento della quota in una determinata regione.
• Aggiungi l'autorizzazione compute.instances.delete all'account di servizio utilizzato dal gruppo.

Se un'azione attivata da un gruppo di istanze gestite non va a buon fine (ad esempio, se un'autoscalabilità rileva un errore durante il tentativo di aumentare le dimensioni del gruppo), il gruppo potrebbe riprovare immediatamente l'azione. Se l'ultimo tentativo di ripetizione immediata non va a buon fine, il MIG registra l'errore e puoi visualizzarlo elencando gli errori dell'istanza. Dopo un po' di tempo di backoff, il gruppo proverà nuovamente a eseguire l'azione non riuscita. Se l'errore persiste, potrebbe essere registrato più volte.

Compute Engine conserva gli errori 500 più recenti degli ultimi 8 giorni anche se le istanze sottostanti non esistono più o non è stato possibile crearle.

Controlla se un'istanza VM fa parte di un gruppo di istanze gestite

Per verificare se una VM specifica è membro di un gruppo, puoi utilizzare la console o REST.

In alternativa, per identificare se una VM è o era membro di una gruppo di istanze, cerca queste due chiavi di metadati nei metadati dell'istanza:

• instance-template indica il modello da cui è stata creata la VM.
• created-by indica il gruppo di istanze gestite che ha creato la VM.

Anche se abbandonare l'istanza, la VM avrà ancora questi metadati a meno che non le rimuovi manualmente.

Ad esempio, se esiste una VM denominata random-instance-biy e vuoi sapere se è stata creata da un gruppo di istanze gestite, puoi descrivere l'istanza e cercare le chiavi dei metadati. Ad esempio:

gcloud compute instances describe random-instance-biy \
    --zone us-central1-f

L'interfaccia a riga di comando gcloud restituisce una risposta simile alla seguente:

canIpForward: false
cpuPlatform: Intel Ivy Bridge
creationTimestamp: '2016-08-24T14:11:38.012-07:00'
...
metadata:
  items:
  - key: instance-template
    value: projects/123456789012/global/instanceTemplates/example-it
  - key: created-by
    value: projects/123456789012/zones/us-central1-f/instanceGroupManagers/igm-metadata

Visualizzare lo stato preservato di un'istanza gestita

Se hai configurato un MIG stateful e vuoi vedere stato di conservazione di ciascuna istanza gestita, Visualizzazione della configurazione stateful e dello stato conservato.

Passaggi successivi

• Scopri di più sui gruppi di istanze gestite.
• Creare un modello di istanza che puoi per creare un gruppo di istanze gestite.