Zusammengesetzte Systemdiagnose-Ressourcen ansehen, aktualisieren und löschen
Auf dieser Seite wird beschrieben, wie Sie Ihre Composite Health-Ressourcen verwalten, nachdem Sie sie erstellt haben. Sie können Richtlinien zur Aggregation von Systemdiagnosen, Systemdiagnosequellen und zusammengesetzte Systemdiagnosen auflisten, beschreiben, aktualisieren und löschen.
Richtlinien zur Aggregation von Systemdiagnosen verwalten
In diesem Abschnitt wird beschrieben, wie Sie Richtlinien zur Aggregation von Gesundheitsdaten verwalten.
Richtlinien zur Aggregation von Systemdiagnosen auflisten
Sie können die von Ihnen konfigurierten Richtlinien zur Aggregation von Systemdiagnosen auflisten.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Richtlinien zur Aggregation von Systemdiagnosen.
gcloud
Verwenden Sie den Befehl gcloud compute health-aggregation-policies list, um alle Richtlinien zur Zusammenfassung von Systemdiagnosen in einer Region aufzulisten.
gcloud compute health-aggregation-policies list \
--regions=REGION
Ersetzen Sie REGION durch die Region der Richtlinien zur Aggregation von Gesundheitsdaten.
API
Wenn Sie alle Richtlinien zur Gesundheitsaggregation in einer Region auflisten möchten, senden Sie eine Anfrage an die Methode regionHealthAggregationPolicies.list.
HTTP-Methode und URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies
Ersetzen Sie Folgendes:
PROJECT_ID: Die Projekt-ID für die Richtlinie zur Aggregation von Gesundheitsdaten.REGION: die Region der Richtlinien für die Aggregation von Systemdiagnosen.
Richtlinie zur Aggregation von Systemdiagnosen beschreiben
Sie können eine Richtlinie zur Service Health-Aggregation beschreiben, um die zugehörigen Details aufzurufen.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Richtlinien zur Aggregation von Systemdiagnosen.
Klicken Sie auf den Namen der Richtlinie zur Aggregation von Systemdiagnosen, die Sie beschreiben möchten.
gcloud
Führen Sie den Befehl gcloud compute health-aggregation-policies describe aus.
gcloud compute health-aggregation-policies describe POLICY \
--region=REGION
Ersetzen Sie Folgendes:
POLICY: der Name der Richtlinie zur Aggregation von SystemdiagnosenREGION: die Region der Richtlinie zur Aggregation von Systemdiagnosen
API
Senden Sie eine Anfrage an die Methode regionHealthAggregationPolicies.get.
HTTP-Methode und URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY
Ersetzen Sie Folgendes:
PROJECT_ID: Die Projekt-ID für die Richtlinie zur Aggregation von Gesundheitsdaten.REGION: die Region der Richtlinie zur Aggregation von Systemdiagnosedaten.POLICY: Der Name der Richtlinie für die Zusammenfassung von Systemdiagnosen.
Richtlinie zur Aggregation von Systemdiagnosen aktualisieren
Sie können die Beschreibung, den Prozentsatz für den Schwellenwert für den Zustand „Gut“ oder den Mindestschwellenwert für den Zustand „Gut“ einer Richtlinie zur Aggregation von Systemdiagnosen aktualisieren.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Richtlinien zur Aggregation von Systemdiagnosen.
Klicken Sie auf den Namen der Richtlinie zur Aggregation von Systemdiagnosen, die Sie aktualisieren möchten.
Klicken Sie auf Bearbeiten.
Aktualisieren Sie die Felder, die Sie ändern möchten.
Klicken Sie auf Speichern.
gcloud
Führen Sie den Befehl gcloud compute health-aggregation-policies update aus.
Lassen Sie die Flags für Attribute weg, die Sie nicht aktualisieren möchten.
gcloud compute health-aggregation-policies update POLICY \
--region=REGION \
--description="DESCRIPTION" \
--healthy-percent-threshold=PERCENT_HEALTHY \
--min-healthy-threshold=MINIMUM_HEALTHY
Ersetzen Sie Folgendes:
POLICY: der Name der Richtlinie zur Aggregation von Systemdiagnosen, die aktualisiert werden sollREGION: die Region der Richtlinie zur Aggregation von SystemdiagnosenDESCRIPTION: eine aktualisierte Beschreibung der RichtliniePERCENT_HEALTHY: Der aktualisierte Mindestprozentsatz der Endpunkte in einem Backend-Dienst, die fehlerfrei sein müssen, damit die Gesundheitsquelle als fehlerfrei gilt, z. B.75MINIMUM_HEALTHY: Die aktualisierte Mindestanzahl von Endpunkten in einem Backend-Dienst, die fehlerfrei sein müssen, damit die Gesundheitsquelle als fehlerfrei gilt, z. B.2
API
Beschreiben Sie die Richtlinie zur Aggregation von Gesundheitsdaten und notieren Sie sich den Wert für den Schlüssel
fingerprint, den Sie im nächsten Schritt verwenden.Senden Sie eine Anfrage an die Methode
regionHealthAggregationPolicies.patch. Lassen Sie die Felder für Attribute weg, die Sie nicht aktualisieren möchten.HTTP-Methode und URL:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY
JSON-Text der Anfrage:
{ "description": "DESCRIPTION", "healthyPercentThreshold": PERCENT_HEALTHY, "minHealthyThreshold": MINIMUM_HEALTHY, "fingerprint": "FINGERPRINT" }Ersetzen Sie Folgendes:
PROJECT_ID: Die Projekt-ID für die Richtlinie zur Aggregation von Gesundheitsdaten.REGION: die Region der Richtlinie zur Aggregation von Systemdiagnosedaten.POLICY: Der Name der Richtlinie zur Zusammenfassung von Gesundheitsdaten, die aktualisiert werden soll.DESCRIPTION: Eine aktualisierte Beschreibung der Richtlinie.PERCENT_HEALTHY: Der aktualisierte Mindestprozentsatz der Endpunkte in einem Backend-Dienst, die fehlerfrei sein müssen, damit die Gesundheitsquelle als fehlerfrei gilt, z. B.75.MINIMUM_HEALTHY: Die aktualisierte Mindestanzahl von Endpunkten in einem Backend-Dienst, die fehlerfrei sein müssen, damit die Gesundheitsquelle als fehlerfrei gilt, z. B.2.FINGERPRINT: Der aktuelle Wert für den Schlüsselfingerprint, den Sie im vorherigen Schritt gefunden haben.
Richtlinie zur Aggregation von Systemdiagnosen löschen
Sie können eine Richtlinie zur Aggregation von Systemdiagnosen löschen, wenn sie nicht mit einer vorhandenen Quelle für die Systemdiagnose verknüpft ist.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Richtlinien zur Aggregation von Systemdiagnosen.
Klicken Sie auf das Kästchen neben der Richtlinie zur Zusammenfassung von Gesundheitsdaten, die Sie löschen möchten.
Klicken Sie auf Löschen.
Klicken Sie zur Bestätigung auf Löschen.
gcloud
Führen Sie den Befehl gcloud compute health-aggregation-policies delete aus.
gcloud compute health-aggregation-policies delete POLICY \
--region=REGION
Ersetzen Sie Folgendes:
POLICY: der Name der Richtlinie zur Aggregation von Systemdiagnosen, die gelöscht werden sollREGION: die Region der Richtlinie zur Aggregation von Systemdiagnosen
API
Senden Sie eine Anfrage an die Methode regionHealthAggregationPolicies.delete.
HTTP-Methode und URL:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY
Ersetzen Sie Folgendes:
PROJECT_ID: Die Projekt-ID für die Richtlinie zur Aggregation von Gesundheitsdaten.REGION: die Region der Richtlinie zur Aggregation von Systemdiagnosedaten.POLICY: der Name der zu löschenden Richtlinie für die Zusammenfassung von Gesundheitsdaten.
Quellen für Systemdiagnose verwalten
In den folgenden Abschnitten wird beschrieben, wie Sie Ihre Gesundheitsdatenquellen verwalten.
Systemdiagnosequellen auflisten
Sie können die von Ihnen konfigurierten Gesundheitsquellen auflisten.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Gesundheitsquellen.
gcloud
Verwenden Sie den Befehl gcloud compute health-sources list, um alle Gesundheitsdatenquellen in einer Region aufzulisten.
gcloud compute health-sources list \
--regions=REGION
Ersetzen Sie REGION durch die Region der Systemdiagnosequellen.
API
Wenn Sie alle Gesundheitsquellen in einer Region auflisten möchten, senden Sie eine Anfrage an die Methode regionHealthSources.list.
HTTP-Methode und URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID der Gesundheitsquelle.REGION: die Region der Gesundheitsdatenquellen.
Systemdiagnosequelle beschreiben
Sie können eine Gesundheitsquelle beschreiben, um die zugehörigen Details aufzurufen.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Gesundheitsquellen.
Klicken Sie auf den Namen der Gesundheitsdatenquelle, die Sie beschreiben möchten.
gcloud
Führen Sie den Befehl gcloud compute health-sources describe aus.
gcloud compute health-sources describe HEALTH_SOURCE \
--region=REGION
Ersetzen Sie Folgendes:
HEALTH_SOURCE: der Name der GesundheitsquelleREGION: die Region der Gesundheitsquelle
API
Senden Sie eine Anfrage an die Methode regionHealthSources.get.
HTTP-Methode und URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID der Gesundheitsquelle.REGION: die Region der Gesundheitsquelle.HEALTH_SOURCE: der Name der Gesundheitsquelle.
Systemdiagnosequelle aktualisieren
Sie können die Beschreibung, den Back-End-Dienst oder die Richtlinie zur Aggregation von Systemdiagnosen einer vorhandenen Systemdiagnosequelle aktualisieren.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Gesundheitsquellen.
Klicken Sie auf den Namen der Gesundheitsquelle, die Sie aktualisieren möchten.
Klicken Sie auf Bearbeiten.
Aktualisieren Sie die Felder, die Sie ändern möchten.
Klicken Sie auf Speichern.
gcloud
Führen Sie den Befehl gcloud compute health-sources update aus.
Lassen Sie die Flags für Attribute weg, die Sie nicht aktualisieren möchten.
gcloud compute health-sources update HEALTH_SOURCE \
--region=REGION \
--description="DESCRIPTION" \
--sources=BACKEND_SERVICE \
--health-aggregation-policy=POLICY
Ersetzen Sie Folgendes:
HEALTH_SOURCE: Name der zu aktualisierenden GesundheitsquelleREGION: die Region der GesundheitsquelleDESCRIPTION: eine aktualisierte Beschreibung der GesundheitsdatenquelleBACKEND_SERVICE: der Name eines Backend-Dienstes, der als Quelle für die Systemdiagnose verwendet werden sollDer Backend-Dienst muss die folgenden Anforderungen erfüllen:
- Das Load-Balancing-Schema muss
INTERNALoderINTERNAL_MANAGEDsein. - Sie muss sich in derselben Region wie die Gesundheitsdatenquelle befinden, die Sie erstellen.
- Die Back-Ends müssen Instanzgruppen oder Netzwerk-Endpunktgruppen vom Typ
GCE_VM_IPoderGCE_VM_IP_PORTsein.
- Das Load-Balancing-Schema muss
POLICY: Der Name einer aktualisierten Richtlinie zur Zusammenfassung von Gesundheitsdaten, die auf diese Gesundheitsdatenquelle angewendet werden soll.
API
- Beschreiben Sie die Gesundheitsdatenquelle und notieren Sie sich den Wert für den Schlüssel
fingerprint, den Sie im nächsten Schritt verwenden. Senden Sie eine Anfrage an die Methode
regionHealthSources.patch. Lassen Sie die Felder für Attribute weg, die Sie nicht aktualisieren möchten.HTTP-Methode und URL:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE
JSON-Text der Anfrage:
{ "description": "DESCRIPTION", "sources": [ "projects/PROJECT_ID/regions/REGION/backendServices/BACKEND_SERVICE" ], "healthAggregationPolicy": "projects/PROJECT_ID/regions/REGION/healthAggregationPolicies/POLICY", "fingerprint": "FINGERPRINT" }Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID der Gesundheitsquelle.REGION: die Region der Gesundheitsquelle.HEALTH_SOURCE: Name der zu aktualisierenden Gesundheitsquelle.DESCRIPTION: eine aktualisierte Beschreibung der Gesundheitsdatenquelle.BACKEND_SERVICE: Der Name eines Backend-Dienstes, der als Quelle für den Zustand verwendet werden soll.Der Backend-Dienst muss die folgenden Anforderungen erfüllen:
- Das Load-Balancing-Schema muss
INTERNALoderINTERNAL_MANAGEDsein. - Sie muss sich in derselben Region wie die Gesundheitsdatenquelle befinden, die Sie erstellen.
- Die Back-Ends müssen Instanzgruppen oder Netzwerk-Endpunktgruppen vom Typ
GCE_VM_IPoderGCE_VM_IP_PORTsein.
- Das Load-Balancing-Schema muss
POLICY: Eine aktualisierte Richtlinie zur Zusammenfassung von Gesundheitsdaten, die auf diese Gesundheitsdatenquelle angewendet werden soll.FINGERPRINT: Der aktuelle Wert für den Schlüsselfingerprint, den Sie im vorherigen Schritt gefunden haben.
Systemdiagnosequelle löschen
Sie können eine Gesundheitsquelle löschen, wenn sie nicht mit einer vorhandenen zusammengesetzten Systemdiagnose verknüpft ist.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Gesundheitsquellen.
Klicken Sie auf das Kästchen neben der Gesundheitsquelle, die Sie löschen möchten.
Klicken Sie auf Löschen.
Klicken Sie zur Bestätigung auf Löschen.
gcloud
Führen Sie den Befehl gcloud compute health-sources delete aus.
gcloud compute health-sources delete HEALTH_SOURCE \
--region=REGION
Ersetzen Sie Folgendes:
HEALTH_SOURCE: Name der zu löschenden GesundheitsquelleREGION: die Region der Gesundheitsquelle
API
Senden Sie eine Anfrage an die Methode regionHealthSources.delete.
HTTP-Methode und URL:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID der Gesundheitsquelle.REGION: die Region der Gesundheitsquelle.HEALTH_SOURCE: der Name der Gesundheitsquelle, die gelöscht werden soll.
Zusammengesetzte Systemdiagnosen verwalten
In den folgenden Abschnitten wird beschrieben, wie Sie zusammengesetzte Systemdiagnosen verwalten.
Zusammengesetzte Systemdiagnosen auflisten
Sie können die von Ihnen konfigurierten zusammengesetzten Systemdiagnosen auflisten.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Zusammengesetzte Systemdiagnosen.
gcloud
Verwenden Sie den gcloud compute composite-health-checks list-Befehl, um alle zusammengesetzten Systemdiagnosen in einer Region aufzulisten.
gcloud compute composite-health-checks list \
--regions=REGION
Ersetzen Sie REGION durch die Region der zusammengesetzten Systemdiagnosen.
API
Wenn Sie alle zusammengesetzten Systemdiagnosen in einer Region auflisten möchten, senden Sie eine Anfrage an die Methode regionCompositeHealthChecks.list.
HTTP-Methode und URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID für den zusammengesetzten Health-Check.REGION: die Region der zusammengesetzten Systemdiagnosen.
Zusammengesetzte Systemdiagnose beschreiben
Sie können eine zusammengesetzte Systemdiagnose beschreiben, um die zugehörigen Details aufzurufen.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Zusammengesetzte Systemdiagnosen.
Klicken Sie auf den Namen der zusammengesetzten Systemdiagnose, die Sie beschreiben möchten.
gcloud
Führen Sie den Befehl gcloud compute composite-health-checks describe aus.
gcloud compute composite-health-checks describe COMPOSITE_HEALTH_CHECK \
--region=REGION
Ersetzen Sie Folgendes:
COMPOSITE_HEALTH_CHECK: der Name der zusammengesetzten SystemdiagnoseREGION: die Region der zusammengesetzten Systemdiagnose
API
Senden Sie eine Anfrage an die Methode regionCompositeHealthChecks.get.
HTTP-Methode und URL:
GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID für den zusammengesetzten Health-Check.REGION: die Region der zusammengesetzten Systemdiagnose.COMPOSITE_HEALTH_CHECK: der Name der zusammengesetzten Systemdiagnose.
Zusammengesetzte Systemdiagnose aktualisieren
Sie können die Beschreibung, die Systemdiagnosequellen oder das Systemdiagnoseziel einer zusammengesetzten Systemdiagnose aktualisieren.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Zusammengesetzte Systemdiagnosen.
Klicken Sie auf den Namen der zusammengesetzten Systemdiagnose, die Sie aktualisieren möchten.
Klicken Sie auf Bearbeiten.
Aktualisieren Sie die Felder, die Sie ändern möchten.
Klicken Sie auf Speichern.
gcloud
Führen Sie den Befehl gcloud compute composite-health-checks update aus.
Lassen Sie die Flags für Attribute weg, die Sie nicht aktualisieren möchten.
gcloud compute composite-health-checks update COMPOSITE_HEALTH_CHECK \
--region=REGION \
--description="DESCRIPTION" \
--health-sources=HEALTH_SOURCES \
--health-destination=HEALTH_DESTINATION
Ersetzen Sie Folgendes:
COMPOSITE_HEALTH_CHECK: der Name der zusammengesetzten Systemdiagnose, die aktualisiert werden sollREGION: die Region der zusammengesetzten SystemdiagnoseDESCRIPTION: eine aktualisierte BeschreibungHEALTH_SOURCES: die Namen einer oder mehrerer Gesundheitsquellen, die mit der zusammengesetzten Systemdiagnose verknüpft werden sollenSie können mehrere Gesundheitsdatenquellen in einer durch Kommas getrennten Liste angeben.
HEALTH_DESTINATION: Der URI der Weiterleitungsregel, die den zusammengesetzten Gesundheitsstatus von diesem zusammengesetzten Health-Check empfängt, z. B.projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE.Die Weiterleitungsregel muss mit einem Ersteller-Load-Balancer verknüpft sein, der Composite Health unterstützt und die folgenden Anforderungen erfüllt:
- Das Load-Balancing-Schema muss
INTERNALoderINTERNAL_MANAGEDsein. - Er muss sich in derselben Region wie die zusammengesetzte Systemdiagnose befinden.
- Das Load-Balancing-Schema muss
API
Beschreiben Sie die zusammengesetzte Systemdiagnose und notieren Sie sich den Wert für den Schlüssel
fingerprint, den Sie im nächsten Schritt verwenden.Senden Sie eine Anfrage an die Methode
regionCompositeHealthChecks.patch. Lassen Sie die Felder für Attribute weg, die Sie nicht aktualisieren möchten.HTTP-Methode und URL:
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK
JSON-Text der Anfrage:
{ "description": "DESCRIPTION", "healthSources": [ "projects/PROJECT_ID/regions/REGION/healthSources/HEALTH_SOURCE" ], "healthDestination": "projects/PROJECT_ID/regions/REGION/forwardingRules/FORWARDING_RULE", "fingerprint": "FINGERPRINT" }Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID für den zusammengesetzten Health-Check.REGION: die Region der zusammengesetzten Systemdiagnose.COMPOSITE_HEALTH_CHECK: der Name der zu aktualisierenden zusammengesetzten Systemdiagnose.DESCRIPTION: eine aktualisierte Beschreibung.HEALTH_SOURCE: Der Name einer Statusquelle, die mit der zusammengesetzten Systemdiagnose verknüpft werden soll. Wenn Sie mehrere Systemdiagnosequellen verknüpfen möchten, fügen Sie jede Quelle dem ArrayhealthSourceshinzu.FORWARDING_RULE: Die Weiterleitungsregel, die den kombinierten Systemdiagnosestatus von dieser kombinierten Systemdiagnose empfängt.FINGERPRINT: Der aktuelle Wert für den Schlüsselfingerprint, den Sie im vorherigen Schritt gefunden haben.
Zusammengesetzte Systemdiagnose löschen
Sie können eine zusammengesetzte Systemdiagnose löschen.
Console
Rufen Sie in der Google Cloud Console die Seite Composite Health auf:
Klicken Sie auf Zusammengesetzte Systemdiagnosen.
Klicken Sie auf das Kästchen neben dem zusammengesetzten Health-Check, den Sie löschen möchten.
Klicken Sie auf Löschen.
Klicken Sie zur Bestätigung auf Löschen.
gcloud
Führen Sie den Befehl gcloud compute composite-health-checks delete aus.
gcloud compute composite-health-checks delete COMPOSITE_HEALTH_CHECK \
--region=REGION
Ersetzen Sie Folgendes:
COMPOSITE_HEALTH_CHECK: Der Name des zu löschenden zusammengesetzten Health-Checks.REGION: die Region der zusammengesetzten Systemdiagnose
API
Senden Sie eine Anfrage an die Methode regionCompositeHealthChecks.delete.
HTTP-Methode und URL:
DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/compositeHealthChecks/COMPOSITE_HEALTH_CHECK
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID für den zusammengesetzten Health-Check.COMPOSITE_HEALTH_CHECK: Der Name des zu löschenden zusammengesetzten Health-Checks.REGION: die Region der zusammengesetzten Systemdiagnose.