Informationen zu MIGs und verwalteten Instanzen ansehen


Verwenden Sie die Methoden auf dieser Seite, um Informationen zu Ihren verwalteten Instanzgruppen (MIGs) sowie Informationen zu den VM-Instanzen in den einzelnen MIGs aufzurufen.

Hinweise

  • Prüfen Sie die Einschränkungen und erstellen Sie eine Gruppe.
  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei Compute Engine authentifizieren.

    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.
    3. REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

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

        gcloud init

      Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Informationen zu MIGs aufrufen

Sie können Informationen zu Gruppen abrufen, um beispielsweise die mit der Gruppe verknüpften Richtlinien zu überprüfen und zu prüfen, ob die Gruppe stabil ist oder ob gerade Änderungen an ihr durchgeführt werden. Weitere Informationen zu den VM-Instanzen in einer MIG finden Sie unter Informationen zu den verwalteten VM-Instanzen in einer MIG anzeigen.

MIGs auflisten

Eine Liste der verwalteten Instanzgruppen können Sie entweder mit der Console, der gcloud CLI oder REST abrufen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

    Zu den Instanzgruppen.

    Wenn Sie über Instanzgruppen verfügen, werden die Gruppen auf dieser Seite aufgelistet, einschließlich der verwalteten Instanzgruppen und der nicht verwalteten Instanzgruppen.

    In der Spalte Gruppentyp wird angegeben, ob die Gruppe verwaltet, zustandsorientiert oder nicht verwaltet ist. Die zustandsorientierten Gruppentypen sind auch verwaltete Instanzgruppen.

gcloud

So rufen Sie eine Liste aller verwalteten Instanzgruppen in einem Projekt ab:

gcloud compute instance-groups managed list

REST

Rufen Sie für zonale MIGs die Methode instanceGroupManagers.list auf:

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

Rufen Sie für regionale MIGs die Methode regionInstanceGroupManagers.list auf:

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

Attribute einer MIG aufrufen

Zum Aufrufen von Informationen zu einer bestimmten MIG, einschließlich der Richtlinien (z. B. Richtlinien für die automatische Reparatur und Aktualisierung der Gruppe), verwenden Sie die Konsole, die gcloud CLI oder REST.

Zum Ansehen des id-Werts der Gruppe müssen Sie die gcloud CLI oder die Compute Engine API verwenden.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

    Zu den Instanzgruppen.

    Wenn Sie bereits Instanzgruppen haben, werden sie auf dieser Seite aufgelistet. Hier werden auch nicht verwaltete Instanzgruppen aufgelistet.

  2. Klicken Sie in der Spalte Name der Liste auf den Namen der Instanzgruppe, die Sie sich genauer ansehen möchten. Es wird eine Seite mit den Attributen der Instanzgruppe und eine Liste der zur Gruppe gehörenden Instanzen angezeigt.

  3. Klicken Sie auf Details, um die Konfiguration der Gruppe aufzurufen.

gcloud

So erhalten Sie Informationen zu einer bestimmten Gruppe:

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

Der Befehl gibt Details zur Gruppe zurück, einschließlich der verknüpften Richtlinien.

Mit dem Flag --format können Sie die Ausgabe beschränken. Der folgende Befehl gibt beispielsweise nur die Autoscaling-Konfiguration der Gruppe zurück, falls vorhanden.

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

REST

Rufen Sie für zonale MIGs die Methode instanceGroupManagers.get auf: Rufen Sie für regionale MIGs die Methode regionInstanceGroupManagers.get auf:

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

Die Antwort enthält Details zur Gruppe, einschließlich der zugeordneten Richtlinien, mit Ausnahme der Autoscaling-Richtlinie der Gruppe. Obwohl Autoscaling ein Feature von MIGs ist, ist es eine separate REST-Ressource.

Autoscaling-Richtlinie

Wenn der Gruppe Autoscaling zugeordnet ist, wird die Autoscaling-Ressource im Feld status.autoscaler der Gruppe aufgeführt.

Informationen zum Autoscaling erhalten Sie, wenn Sie die Methode autoscalers.get für eine zonale MIG oder die Methode regionAutoscalers.get für eine regionale MIG aufrufen. Die URL der Autoscaling-Ressource enthält deren Namen. Dies ist standardmäßig der Name der Gruppe, der das Autoscaling zugeordnet ist. Sie können beispielsweise die folgende Anfrage für das Autoscaling einer regionalen MIG stellen:

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

Stabilität einer MIG prüfen

Sie können mit verschiedenen Befehlen und Anfragen Instanzen in einer verwalteten Instanzgruppe erstellen, löschen und ändern. Diese Vorgänge werden mit dem Status DONE zurückgegeben, nachdem die Gruppe Aktionen zum Erstellen, Löschen oder Aktualisieren dieser Instanzen geplant hat. Die Instanzen in der Gruppe sind jedoch erst dann erstellt, gelöscht oder aktualisiert, wenn diese zugrunde liegenden Aktionen abgeschlossen sind. Sie müssen den Status der Gruppe überprüfen oder alternativ den Status der entsprechenden Instanzen überprüfen.

Eine verwaltete Instanzgruppe ist stabil, wenn an keinen Instanzen in der verwalteten Instanzgruppe Änderungen vorgenommen werden, keine zukünftigen Änderungen für die Instanzen geplant sind und die Gruppe selbst nicht gerade geändert wird.

Sie möchten z. B. wissen, ob eine Gruppe stabil ist, wenn Sie Abhängigkeiten haben, die voraussetzen, dass alle Instanzen in der Gruppe fehlerfrei ausgeführt werden. Sie können beispielsweise beginnen, Jobs zu planen, Traffic zu senden oder Schlüsselbereiche zuzuweisen, nachdem Sie sich vergewissert haben, dass alle VMs ausgeführt werden und fehlerfrei sind.

Prüfen Sie, ob alle Instanzen in einer verwalteten Instanzgruppe ausgeführt werden und fehlerfrei sind, indem Sie den Wert des Feldes status.isStable der Gruppe prüfen.

gcloud

Führen Sie den Befehl describe aus:

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

Die gcloud CLI gibt detaillierte Informationen zur MIG zurück, einschließlich des Felds status.isStable.

Wenn ein Skript pausiert werden soll, bis die MIG stabil ist, verwenden Sie den Befehl wait-until mit dem Flag --stable. Beispiel:

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

Der Befehl gibt das Ergebnis zurück, nachdem status.isStable für die MIG auf true gesetzt wurde.

REST

Stellen Sie für eine zonale MIG eine GET-Anfrage an die Methode instanceGroupManagers.get:

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

Ersetzen Sie für regional verwaltete Instanzgruppen zones/zone durch regions/region:

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

Diese Anfragen geben detaillierte Informationen zur MIG zurück, einschließlich des Felds status.isStable.

Wenn status.isStable auf false gesetzt ist, bedeutet das, dass Änderungen aktiv sind, ausstehen oder dass die MIG selbst geändert wird.

Wenn status.isStable auf true gesetzt ist, bedeutet das Folgendes:

  • Die Instanzen in der MIG werden nicht geändert und die currentAction für alle Instanzen ist NONE.
  • Es gibt keine Änderungen bei Instanzen in der MIG.
  • Die MIG selbst wird nicht geändert.

Beachten Sie, dass die Stabilität einer MIG von zahlreichen Faktoren abhängt, da eine MIG auf verschiedene Arten geändert werden kann. Beispiel:

  • Sie stellen eine Anfrage, um eine neue Instanzvorlage bereitzustellen.
  • Sie stellen eine Anfrage, um in der Gruppe Instanzen zu erstellen, zu löschen, deren Größe anzupassen oder sie zu aktualisieren.
  • Durch das Autoscaling wird eine Anfrage gestellt, um die Größe der MIG zu ändern.
  • Eine Ressource für die automatische Reparatur ersetzt in der MIG eine oder mehrere fehlerhafte Instanzen.
  • In einer regionalen MIG werden einige der Instanzen neu verteilt.

Sobald alle Aktionen abgeschlossen sind, wird status.isStable wieder auftrue gesetzt für diese MIG.

Informationen zu einzelnen VM-Instanzen finden Sie unter Status von verwalteten Instanzen überprüfen.

MIG auf Deaktivierung von VM-Reparaturen prüfen

Um zu prüfen, ob die VM-Reparaturen in einer MIG deaktiviert sind, verwenden Sie die Console, die gcloud CLI oder die API.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

    Zu den Instanzgruppen

  2. Klicken Sie auf den Namen der Instanzgruppe, die Sie aufrufen möchten. Ihnen wird eine Seite mit den Attributen der Instanzgruppe und einer Liste der zur Gruppe gehörenden Instanzen angezeigt.
  3. Klicken Sie auf den Tab Details.
  4. Aktivieren Sie im Abschnitt Lebenszyklus von VM-Instanzen das Feld Standardaktion bei Fehler. Wenn der Wert No action ist, sind die Reparaturen in der MIG deaktiviert.

gcloud

Verwenden Sie die describe-Methode so:

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

Suchen Sie im Antworttext nach dem Feld defaultActionOnFailure. Folgende Werte sind möglich:

  • REPAIR: Die MIG erstellt eine fehlgeschlagene oder fehlerhafte VM in derselben Zone neu.
  • DO_NOTHING: Die Reparaturen sind in der MIG deaktiviert. Die MIG führt für eine fehlgeschlagene oder eine fehlerhafte VM in der Gruppe keine Aktionen aus.

Das folgende Beispiel zeigt, wie die MIG eine VM durch Neuerstellung repariert.

instanceLifecyclePolicy:
  defaultActionOnFailure: REPAIR
  forceUpdateOnRepair: NO

API

Verwenden Sie für eine zonale MIG die Methode instanceGroupManagers.get oder für eine regionale MIG die Methode regionInstanceGroupManagers.get.

Mit dem folgenden Aufruf können Sie die MIG-Aktion bei VM-Fehlern in einer zonalen MIG anzeigen lassen:

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

Prüfen Sie im Antworttext das Feld instanceLifecyclePolicy.defaultActionOnFailure. Folgende Werte sind möglich:

  • REPAIR: Die MIG erstellt eine fehlgeschlagene oder fehlerhafte VM in derselben Zone neu.
  • DO_NOTHING: Die Reparaturen sind in der MIG deaktiviert. Die MIG führt für eine fehlgeschlagene oder eine fehlerhafte VM in der Gruppe keine Aktionen aus.

Das folgende Beispiel zeigt, wie die MIG eine VM durch Neuerstellung repariert.

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

Wenn Sie nicht möchten, dass eine MIG eine fehlgeschlagene oder fehlerhafte VM in der Gruppe repariert, können Sie die Reparaturen in der MIG deaktivieren.

Frühere automatische Reparaturvorgänge ansehen

Wenn Sie die automatische Reparatur konfiguriert haben, können Sie vergangene automatische Reparaturereignisse anzeigen.

Rolling Updates beobachten

Wenn Sie ein Rolling Update initiiert haben und wissen möchten, wann das Update abgeschlossen ist, informieren Sie sich unter Updates überwachen.

Zustandsorientierte Konfiguration aufrufen

Wenn Sie eine zustandsorientierte MIG konfiguriert haben und die Konfiguration prüfen möchten, finden Sie unter Zustandsorientierte Konfiguration aufrufen weitere Informationen.

Informationen zu den verwalteten VM-Instanzen in einer MIG aufrufen

Verwaltete Instanzen einer MIG auflisten

Eine Liste der verwalteten Instanzen in einer Gruppe einschließlich ihrer Status und Vorlagen können Sie entweder mit der Console, der gcloud CLI oder REST abrufen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

    Zu den Instanzgruppen.

    Wenn Sie bereits Instanzgruppen haben, werden sie auf dieser Seite aufgelistet. Hier werden auch nicht verwaltete Instanzgruppen aufgelistet.

  2. Klicken Sie in der Spalte Name der Liste auf den Namen der Instanzgruppe, die Sie sich genauer ansehen möchten. Ihnen wird eine Seite mit den Attributen der Instanzgruppe und einer Liste der zur Gruppe gehörenden Instanzen angezeigt.

gcloud

Verwenden Sie in der gcloud CLI den Unterbefehl list-instances.

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

Dieser Befehl gibt eine Liste der Instanzen und ihrer Details sowie den aktuellen Status, die Instanzvorlage und den letzten Fehler zurück.

REST

Stellen Sie für eine zonale MIG eine GET-Anfrage an die Methode instanceGroupManagers.listManagedInstances und geben Sie den Namen einer verwalteten Instanzgruppe an:

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

Verwenden Sie für regional verwaltete Instanzgruppen mit einer oder mehreren Zonen stattdessen die Ressource regionInstanceGroupManagers: regionInstanceGroupManagers.list.

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

Die Antwort enthält eine Liste der Instanzen und ihrer Details, einschließlich des aktuellen Status und der Instanzvorlage.

Status von verwalteten Instanzen prüfen

Sie können mit verschiedenen Befehlen und Anfragen Instanzen in einer verwalteten Instanzgruppe erstellen, löschen und ändern. Diese Vorgänge werden mit dem Status DONE zurückgegeben, nachdem die Gruppe Aktionen zum Erstellen, Löschen oder Aktualisieren dieser Instanzen geplant hat. Die Instanzen in der Gruppe sind jedoch erst dann erstellt, gelöscht oder aktualisiert, wenn diese zugrunde liegenden Aktionen abgeschlossen sind. Prüfen Sie den Status der betreffenden Instanzen oder alternativ den Status der Gruppe selbst.

Verwenden Sie die Google Cloud CLI oder REST, um Details zu den Instanzen in einer verwalteten Instanzgruppe aufzurufen. Die Details enthalten den Instanzstatus und die aktuellen Aktionen, die die Gruppe auf ihren Instanzen ausführt.

gcloud

Alle verwalteten Instanzen

Prüfen Sie den Status und die aktuellen Aktionen für alle Instanzen in der Gruppe mit dem Befehl list-instances.

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

Der Befehl gibt eine Liste der Instanzen in der Gruppe zurück, einschließlich ihres Status, aktueller Aktionen und weiterer Details:

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

Die Spalte HEALTH_STATE ist leer, sofern Sie keine Systemdiagnose eingerichtet haben.

Eine bestimmte verwaltete Instanz

Zum Prüfen des Status und der aktuellen Aktion für eine bestimmte Instanz in der Gruppe verwenden Sie den Befehl describe-instance.

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

Der Befehl liefert Details zur Instanz, einschließlich des Instanzstatus, der aktuellen Aktion und (für zustandsorientierte MIGs) des beibehaltenen Status:

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

REST

Rufen Sie die Methode listManagedInstances für eine regionale oder zonale MIG-Ressource auf. Wenn Sie beispielsweise Details zu den Instanzen in einer zonalen MIG-Ressource abrufen möchten, können Sie die folgende Anfrage stellen:

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

Der Aufruf gibt eine Liste der Instanzen für die MIG zurück, einschließlich instanceStatus und currentAction jeder Instanz.

{
 "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"
  }
 ]
}

Eine Liste der gültigen instanceStatus-Feldwerte finden Sie unter Lebenszyklus von VM-Instanzen.

Wenn an einer Instanz eine Änderung vorgenommen wird, setzt das verwaltete Feld der Instanz das Feld currentAction auf eine der folgenden Aktionen, damit Sie den Fortschritt der Änderung verfolgen können. Andernfalls wird das Feld currentAction auf NONE gesetzt.

Folgende currentAction-Werte sind möglich:

  • ABANDONING. Die Instanz wird gerade aus der MIG entfernt.
  • CREATING: Die Instanz wird gerade erstellt.
  • CREATING_WITHOUT_RETRIES. Die Instanz wird ohne Neuversuche erstellt. Wenn die Instanz beim ersten Versuch nicht erstellt wird, versucht die MIG nicht, die Instanz noch einmal zu ersetzen.
  • DELETING: Die Instanz wird gerade gelöscht.
  • RECREATING. Die Instanz wird gerade ersetzt.
  • REFRESHING: Die Instanz wird aus den aktuellen Zielpools entfernt und anschließend zu den in der Liste enthaltenen Zielpools wieder hinzugefügt. Diese Liste kann mit den bestehenden Zielpools identisch sein oder davon abweichen.
  • RESTARTING: Die Instanz wird gerade mit den Methoden stop und start neu gestartet.
  • RESUMING. Die Instanz wird gerade fortgesetzt, nach dem sie vorher gesperrt war.
  • STARTING. Die Instanz wird gerade gestartet, nachdem sie vorher beendet wurde.
  • STOPPING: Die Instanz wird beendet.
  • SUSPENDING: Die Instanz wird angehalten.
  • VERIFYING: Die Instanz wurde erstellt und wird gerade verifiziert.
  • NONE: Für die Instanz werden gerade keine Aktionen durchgeführt.

Informationen zum Überprüfen, ob die Gruppe insgesamt stabil ist oder gerade geändert wird, finden Sie unter Status der Gruppe überprüfen.

Systemzustände prüfen

Wenn Sie die automatische Reparatur für Ihre verwaltete Instanzgruppe konfiguriert haben, können Sie jede einzelne VM auf ihren Systemstatus prüfen. Weitere Informationen finden Sie im Abschnitt zur Prüfung des Systemstatus.

Instanzfehler auflisten

Wenn bei Ihren verwalteten Instanzen Fehler aufgetreten sind, können Sie diese aufrufen, um ihre Ursache zu ermitteln und das Problem zu beheben.

Verwenden Sie die Google Cloud Console, die gcloud CLI oder REST, um eine Liste der Fehler aufzurufen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Instanzgruppen auf.

    Zu den Instanzgruppen

  2. Klicken Sie in der Spalte Name der Liste auf den Namen der Instanzgruppe, die Sie sich genauer ansehen möchten. Ihnen wird eine Seite mit den Attributen der Instanzgruppe und einer Liste der zur Gruppe gehörenden Instanzen angezeigt.

  3. Klicken Sie auf Fehler.

gcloud

Verwenden Sie den Befehl instance-groups managed list-errors, um die neuesten Fehler der Gruppe aufzulisten.

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

Beispiel:

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
...

REST

Senden Sie für eine zonal oder regional verwaltete Instanzgruppe eine GET-Anfrage an die Methode listErrors.

Beispiel:

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

Die Antwort sieht ungefähr so aus:


{
 "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=="
}

Die API listErrors unterstützt die Listenpaginierung. Wenn Sie die nächste Ergebnisseite abrufen möchten, verwenden Sie das Feld nextPageToken aus einer Antwort in einer nachfolgenden Anfrage. Beispiel: GET https://compute.googleapis.com/compute/v1/projects/project-id/zones/zone/instanceGroupManagers/instance-group-name/listErrors&maxResults=100&nextPageToken=next-page-token, wobei next-page-token durch das Token aus der vorherigen Antwort ersetzt wird.

Die Liste der möglichen Fehler umfasst unter anderem die folgenden Beispiele:

  • Eine neue Instanz kann aus folgenden Gründen nicht erstellt werden:
    • Kapazität auf Abruf nicht verfügbar.
    • Unzureichendes Kontingent, z. B. für CPUs in einer bestimmten Region.
    • Das Limit für die Anzahl der VM-Instanzen wurde für das mit der Gruppe verknüpfte Netzwerk erreicht.
    • Das im Feld properties.disks[].initializeParams.sourceImage der Instanzvorlage angegebene Speicherabbild wurde gelöscht oder seine Berechtigungen wurden geändert.
    • Mit der im Rechnungskonto hinterlegten Kreditkarte, das mit dem Projekt verknüpft ist, konnte eine Zahlung nicht durchgeführt werden.
  • Eine vorhandene Instanz kann aus folgendem Grund nicht gelöscht werden:
    • Dem Dienstkonto, das von dieser Gruppe verwendet wird, fehlt die Berechtigung compute.instances.delete.
    • Es wurden zu viele gleichzeitige Löschvorgänge angefordert, wodurch die geltenden Ratenbegrenzungen überschritten wurden.
  • Eine Instanz kann einem Zielpool nicht hinzugefügt werden, da der Zielpool gelöscht wurde.

Nachdem Sie Fehler dieser Art geprüft haben, können Sie diese beheben. Beispiel:

  • Verschieben Sie Ihre Arbeitslast in eine Zone mit Kapazität auf Abruf.
  • Fordern Sie eine Kontingenterhöhung für eine bestimmte Region an.
  • Fügen Sie dem Dienstkonto, das von der Gruppe verwendet wird, die Berechtigung compute.instances.delete hinzu.

Wenn eine von einer verwalteten Instanzgruppe ausgelöste Aktion fehlschlägt (z. B. wenn beim Autoscaling ein Fehler beim Versuch auftritt, die Gruppe zu vergrößern), wird die Aktion möglicherweise sofort wiederholt. Wenn der letzte sofortige Wiederholungsversuch fehlschlägt, wird der Fehler von der MIG aufgezeichnet und Sie können die Instanzfehler auflisten, um ihn anzusehen. Nach einer gewissen Backoff-Zeit wiederholt die Gruppe die fehlgeschlagene Aktion noch einmal. Wenn der Fehler dauerhaft besteht, wird er möglicherweise mehrmals aufgezeichnet.

Compute Engine behält die letzten 500 Fehler der letzten acht Tage bei, auch wenn die zugrunde liegenden Instanzen nicht mehr vorhanden sind oder nicht erstellt werden konnten.

Zugehörigkeit einer VM-Instanz zu einer MIG prüfen

Mit der Console oder REST können Sie prüfen, ob eine bestimmte VM Mitglied einer Gruppe ist.

Console

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

    Zu „VM-Instanzen“

  2. Klicken Sie auf eine Instanz, um die VM-Instanzdetails anzuzeigen.
  3. Wenn die VM-Instanz Mitglied einer verwalteten Instanzgruppe ist, wird der Name dieser verwalteten Instanzgruppe unter der Überschrift Verwendet von angezeigt. Wenn die VM-Instanz kein Mitglied einer Gruppe ist, wird die Überschrift Verwendet von nicht auf der Detailseite der Instanz angezeigt.

REST

Siehe Referrers zu VM-Instanzen ansehen.

Alternativ können Sie in den Metadaten der Instanz nach den beiden folgenden Metadatenschlüsseln suchen, um zu ermitteln, ob eine VM Mitglied einer verwalteten Instanzgruppe ist oder war:

  • instance-template gibt die Vorlage an, aus der die VM erstellt wurde.
  • created-by gibt die verwaltete Instanzgruppe an, die die VM erstellt hat.

Selbst wenn Sie die VM verwerfen, bleiben die Metadateneinträge erhalten, außer Sie entfernen diese manuell.

Wenn beispielsweise eine VM mit dem Namen random-instance-biy vorhanden ist und Sie wissen möchten, ob die VM von einer verwalteten Instanzgruppe erstellt wurde, können Sie die Instanz angeben und nach den Metadatenschlüsseln suchen. Beispiel:

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

Die gcloud CLI gibt in etwa folgende Antwort zurück:

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

Beibehaltenen Status einer verwalteten Instanz aufrufen

Wenn Sie eine zustandsorientierte MIG konfiguriert haben und den beibehaltenen Status jeder verwalteten Instanz aufrufen möchten, finden Sie unter Zustandsorientierte Konfiguration und beibehaltenen Status aufrufen weitere Informationen.

Nächste Schritte