Vereinfachte API-Kontingentmesswerte in Cloud Monitoring verwenden

In diesem Dokument wird beschrieben, wie Sie die vereinfachten Compute Engine API-Kontingentmesswerte in Ihren Cloud Monitoring-Dashboards, Benachrichtigungsrichtlinien und -Abfragen verwenden.

Vereinfachte API-Kontingentmesswerte

Um die Auffindbarkeit und Verwaltbarkeit von Compute Engine API Kontingenten Google Cloud zu verbessern, hat die Anzahl der Kontingentmesswerte reduziert, indem Messwerte in weniger Kontingentgruppen zusammengefasst wurden. Diese vereinfachten Kontingentmesswerte bieten auch höhere Limits für jede Kontingentgruppe.

Alte und vereinfachte API-Kontingentmesswerte

In der folgenden Tabelle sind die alten API-Kontingentmesswerte und ihre vereinfachten Entsprechungen aufgeführt:

Alte API-Kontingentmesswerte Vereinfachte API-Kontingentmesswerte
compute.googleapis.com/list_requests compute.googleapis.com/global_reads
Leseanfragen pro Minute
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Alter Kontingentmesswert für Methoden, mit denen Compute Engine-Ressourcen aufgelistet werden.
compute.googleapis.com/get_macsec_config_requests
compute.googleapis.com/license_verification_requests
compute.googleapis.com/default
Alter Kontingentmesswert für globale Methoden, mit denen Compute Engine-Ressourcen erstellt, geändert oder gelöscht werden.		 compute.googleapis.com/global_writes
Mutationsanfragen pro Minute
compute.googleapis.com/global_resource_write_requests
compute.googleapis.com/heavy_weight_write_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_delete_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_create_requests
compute.googleapis.com/address_move_requests
compute.googleapis.com/project_set_common_instance_metadata_requests
compute.googleapis.com/regional_v2_public_advertised_prefixes_announce_requests
compute.googleapis.com/license_insert_requests
compute.googleapis.com/heavy_weight_read_requests_per_region compute.googleapis.com/reads_per_region
Leseanfragen pro Minute und Region
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Alter Kontingentmesswert für regionale und zonale Methoden, mit denen Compute Engine-Ressourcen aufgelistet werden.
compute.googleapis.com/license_verification_requests_per_region
compute.googleapis.com/instance_list_referrers_requests_per_region
compute.googleapis.com/operation_read_requests_per_region
compute.googleapis.com/network_endpoint_list_requests_per_region
compute.googleapis.com/regional_network_endpoint_list_requests_per_region
compute.googleapis.com/get_serial_port_output_requests_per_region
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_write_requests_per_region compute.googleapis.com/writes_per_region
Mutationsanfragen pro Minute und Region
compute.googleapis.com/default_per_region
Alter Kontingentmesswert für regionale und zonale Methoden, mit denen Compute Engine-Ressourcen erstellt, geändert oder gelöscht werden.
compute.googleapis.com/global_resource_write_requests_per_region
compute.googleapis.com/network_endpoint_write_requests_per_region
compute.googleapis.com/regional_network_endpoint_write_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_create_requests_per_region
compute.googleapis.com/address_move_requests_per_region
compute.googleapis.com/simulate_maintenance_event_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_delete_requests_per_region
compute.googleapis.com/regional_public_delegated_prefixes_announce_requests_per_region
compute.googleapis.com/recommend_locations_requests_per_region compute.googleapis.com/recommend_locations_per_region
RegionInstances.RecommendLocations-Anfragen pro Minute und Region
compute.googleapis.com/cache_invalidation_requests compute.googleapis.com/global_cache_invalidation_requests
Cache-Entwertungsanfragen pro Minute

Vereinfachte Messwerte in Cloud Monitoring-Dashboards verwenden

Wenn Sie die Compute Engine API-Nutzung anhand der vereinfachten API-Messwerte überwachen möchten, fügen Sie in Ihren Cloud Monitoring-Dashboards, -Benachrichtigungen und -Abfragen Filter für diese Messwerte hinzu.

Dashboard mit vereinfachten API-Kontingentmesswerten erstellen

So erstellen Sie ein Dashboard mit vereinfachten Messwerten:

  1. Wechseln Sie in der Google Cloud Console zu Monitoring:

    Zu Monitoring

  2. Wählen Sie im Navigationsbereich die Option Dashboards aus.

  3. Klicken Sie auf Benutzerdefiniertes Dashboard erstellen.

  4. Klicken Sie in der Dashboard-Symbolleiste auf Widget hinzufügen und wählen Sie einen Widgettyp aus, z. B. Liniendiagramm. Die Seite Widget konfigurieren wird geöffnet.

  5. Führen Sie im Abschnitt Messwert auswählen die folgenden Schritte aus:

    1. Wählen Sie für die Ressource Nutzerkontingent aus.
    2. Wählen Sie für die Messwertkategorie Quota aus.
    3. Wählen Sie für den Messwert Ratenkontingentnutzung aus und klicken Sie dann auf Anwenden.

  6. Verwenden Sie im Abschnitt Filter hinzufügen den Filter quota_metric und wählen Sie den entsprechenden vereinfachten API-Kontingentmesswert aus. Informationen zum Auffinden des vereinfachten Messwerts finden Sie unter Alte und vereinfachte API-Kontingentmesswerte.

  7. Klicken Sie auf Anwenden , um das Widget dem Dashboard hinzuzufügen.

  8. Klicken Sie in der Symbolleiste auf Speichern, um das Dashboard zu speichern.

Dashboard mit einem alten Kontingentmesswert ändern

So aktualisieren Sie ein Dashboard, das einen alten Messwert enthält:

  1. Wechseln Sie in der Google Cloud Console zu Monitoring:

    Zu Monitoring

  2. Wählen Sie im Navigationsbereich die Option Dashboards aus.

  3. Öffnen Sie das Dashboard mit dem Diagramm, das aktualisiert werden muss.

  4. Klicken Sie auf Bearbeiten.

  5. Suchen Sie das Widget, das Sie aktualisieren möchten, und bearbeiten Sie es.

  6. Aktualisieren Sie im Abschnitt Messwert auswählen den Filter, der den alten Messwert enthält:

    1. Wählen Sie im Feld Filter die Option quota_metric aus.
    2. Aktualisieren Sie im Feld Wert den aktuellen Wert auf den entsprechenden vereinfachten API-Kontingentmesswert. Informationen zum Auffinden des Ersatzes für Ihren alten Messwert finden Sie unter Alte und vereinfachte API-Kontingentmesswerte. Ändern Sie beispielsweise compute.googleapis.com/read_requests in compute.googleapis.com/global_reads.

  7. Klicken Sie auf Anwenden, um die Änderungen zu übernehmen.

Vereinfachte API-Kontingentmesswerte in Cloud Monitoring-Benachrichtigungsrichtlinien verwenden

Wenn Sie die Compute Engine API-Nutzung anhand der vereinfachten API-Messwerte überwachen möchten, fügen Sie in Ihren Cloud Monitoring-Benachrichtigungsrichtlinien Filter für diese Messwerte hinzu.

Benachrichtigungsrichtlinie mit vereinfachten API-Kontingentmesswerten erstellen

So erstellen Sie eine Benachrichtigungsrichtlinie mit vereinfachten Messwerten:

  1. Wechseln Sie in der Google Cloud Console zu Monitoring:

    Zu Monitoring

  2. Wählen Sie im Navigationsbereich die Option Benachrichtigungen aus.

  3. Klicken Sie auf Richtlinie erstellen.

  4. Führen Sie im Abschnitt Messwert auswählen die folgenden Schritte aus:

    1. Wählen Sie für die Ressource Nutzerkontingent aus.
    2. Wählen Sie für die Messwertkategorie Quota aus.
    3. Wählen Sie für den Messwert Ratenkontingentnutzung aus und klicken Sie dann auf Anwenden.

  5. Verwenden Sie im Abschnitt Filter hinzufügen den Filter quota_metric und wählen Sie den entsprechenden vereinfachten API-Kontingentmesswert aus. Informationen zum Auffinden des vereinfachten Messwerts finden Sie unter Alte und vereinfachte API-Kontingentmesswerte.

  6. Konfigurieren Sie die Bedingung, Benachrichtigungskanäle und Dokumentation nach Bedarf.

  7. Klicken Sie auf Richtlinie speichern.

Sie können auch den Google Cloud Terraform-Anbieter verwenden, um Benachrichtigungsrichtlinien in Ihrem Google Cloud Projekt zu erstellen. Weitere Informationen finden Sie unter Benachrichtigungsrichtlinien mit Terraform erstellen.

Benachrichtigungsrichtlinie mit einem alten Kontingentmesswert ändern

So aktualisieren Sie eine vorhandene Benachrichtigungsrichtlinie, die einen alten Kontingentmesswert verwendet:

  1. Wechseln Sie in der Google Cloud Console zu Monitoring:

    Zu Monitoring

  2. Wählen Sie im Navigationsbereich die Option Benachrichtigungen aus. Die Seite "Benachrichtigungen" zeigt Bereiche an, in denen zusammenfassende Informationen, Vorfälle und Benachrichtigungsrichtlinien aufgelistet sind.

  3. Wenn Sie eine vorhandene Richtlinie bearbeiten möchten, klicken Sie unter Richtlinien auf den Richtliniennamen.

  4. Aktualisieren Sie im Abschnitt Messwert auswählen den Filter, der den alten Messwert enthält:

    1. Wählen Sie im Feld Filter die Option quota_metric aus.
    2. Aktualisieren Sie im Feld Wert den Wert auf den entsprechenden vereinfachten API-Kontingentmesswert. Informationen zum Auffinden des Ersatzes für Ihren alten Messwert finden Sie unter Alte und vereinfachte API-Kontingentmesswerte. Ändern Sie beispielsweise compute.googleapis.com/read_requests in compute.googleapis.com/global_reads.

  5. Klicken Sie auf Fertig , um die Änderungen im Filter zu speichern.

  6. Klicken Sie auf Richtlinie speichern.

Vereinfachte Kontingentmesswerte in Cloud Monitoring-Abfragen verwenden

Verwenden Sie den Abfrageeditor und bearbeiten Sie den Abfragefilter, um eine PromQL-basierte Benachrichtigungsrichtlinie oder ein Diagramm in einem Dashboard zu aktualisieren. Weitere Informationen finden Sie unter Codeeditor für PromQL verwenden.

Wenn Sie Ihre Abfrage aktualisieren möchten, ersetzen Sie den alten Messwertnamen im Filter quota_metric durch den entsprechenden vereinfachten Messwertnamen.

Beispiel 1:

Abfrage mit einem alten Messwert:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/read_requests"}[1m])

Geänderte Abfrage mit vereinfachtem Messwert:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/global_reads"}[1m])

Beispiel 2:

Abfrage mit einem alten Messwert:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/heavy_weight_write_requests_per_region"}[1m])

Geänderte Abfrage mit vereinfachtem Messwert:

rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", \
quota_metric=~"compute.googleapis.com/writes_per_region"}[1m])