Vereinfachte API-Kontingentmesswerte in Cloud Monitoring verwenden

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

Vereinfachte API-Kontingentmesswerte

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

In der folgenden Tabelle sind alle vereinfachten API-Kontingentmesswerte aufgeführt, die die vorhandenen API-Kontingentmesswerte zusammenfassen:

Vorhandene Kontingentmesswerte für APIs Vereinfachter Kontingentmesswert für APIs
compute.googleapis.com/list_requests Read requests per minute
compute.googleapis.com/global_readsBETA
compute.googleapis.com/read_requests
compute.googleapis.com/heavy_weight_read_requests
compute.googleapis.com/default
Vorhandener Kontingentmesswert für Methoden, die Compute Engine-Ressourcen auflisten.
compute.googleapis.com/get_macsec_config_requests
compute.googleapis.com/license_verification_requests
compute.googleapis.com/default
Vorhandener Kontingentmesswert für globale Methoden, mit denen Compute Engine-Ressourcen erstellt, geändert oder gelöscht werden.		 Mutation requests per minute
compute.googleapis.com/global_writesBETA
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 Read requests per minute per region
compute.googleapis.com/reads_per_regionBETA
compute.googleapis.com/read_requests_per_region
compute.googleapis.com/list_requests_per_region
compute.googleapis.com/default_per_region
Vorhandenes 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 Mutation requests per minute per region
compute.googleapis.com/writes_per_regionBETA
compute.googleapis.com/default_per_region
Vorhandenes 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 RegionInstances RecommendLocations requests per minute per region
compute.googleapis.com/recommend_locations_per_regionBETA
compute.googleapis.com/cache_invalidation_requests Cache invalidation requests per minute
compute.googleapis.com/global_cache_invalidation_requestsBETA

Vereinfachte Messwerte in Cloud Monitoring verwenden

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

Vereinfachte Messwerte in Cloud Monitoring-Dashboards verwenden

So verwenden Sie einen vereinfachten Kontingentmesswert in den Dashboards:

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

    Zu Monitoring

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

  3. Wählen Sie das zu bearbeitende Dashboard aus, das einen vereinfachten Messwert verwenden soll.

  4. Klicken Sie auf Dashboard bearbeiten und fügen Sie ein Widget hinzu.

  5. Fügen Sie einen Filter für den Messwert hinzu, den Sie überwachen möchten:

    1. Wählen Sie im Feld Filter die Option quota_metric aus.
    2. Wählen Sie im Feld Vergleichsoperator die Option = aus.
    3. Geben Sie im Feld Wert den Namen des Messwerts für das API-Kontingent an. Der Filter quota_metric = compute.googleapis.com/global_reads verwendet beispielsweise einen regulären Ausdruck, um alle Zeitreihendaten abzugleichen, die den Kontingentmesswert compute.googleapis.com/global_reads verwenden.

  6. Klicken Sie in der Symbolleiste auf Übernehmen, um die Änderungen auf das Dashboard anzuwenden.

Vereinfachte Kontingentmesswerte in Cloud Monitoring-Benachrichtigungsrichtlinien verwenden

So erstellen Sie eine Benachrichtigungsrichtlinie, um die Nutzung eines vereinfachten API-Kontingentmesswerts zu überwachen:

  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. Klicken Sie auf Richtlinie erstellen, um eine Benachrichtigungsrichtlinie hinzuzufügen.

  4. Wählen Sie einen Filter für den Messwert aus, den Sie überwachen möchten:

    1. Wählen Sie im Feld Filter die Option quota_metric aus.
    2. Wählen Sie im Feld Vergleichsoperator die Option = aus.
    3. Geben Sie im Feld Wert den Namen des Messwerts für das vereinfachte Kontingent an. Der Filter quota_metric = compute.googleapis.com/global_reads verwendet beispielsweise einen regulären Ausdruck, um alle Zeitreihendaten abzugleichen, die den Kontingentmesswert compute.googleapis.com/global_reads verwenden.
    4. Klicken Sie auf Fertig, um die Änderungen im Filter zu speichern.

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

Vereinfachte Kontingentmesswerte in Cloud Monitoring-Abfragen verwenden

Verwenden Sie den Abfrageeditor und bearbeiten Sie den Abfragefilter, um den vereinfachten Kontingentmesswert in einer MQL- oder PromQL-basierten Benachrichtigungsrichtlinie oder in einem Diagramm in einem Dashboard zu verwenden. Informationen dazu finden Sie unter Abfrageeditor verwenden. Öffnen Sie den Abfrageeditor und fügen Sie den Filter wie in den folgenden Beispielen gezeigt hinzu: MQL: 

  fetch consumer_quota
   | metric 'serviceruntime.googleapis.com/quota/rate/net_usage'
   | filter (metric.quota_metric =~ 'compute.googleapis.com/global_reads')
   | align rate(1m)
   | every 1m
   | group_by [], [value_net_usage_aggregate: aggregate(value.net_usage)]
Hinweis: MQL wird am 22. Juli 2025 eingestellt. Verwenden Sie PromQL, um Ihre Dashboards zu erstellen. Weitere Informationen finden Sie unter Einstellung von MQL. PromQL: 
   sum(rate(serviceruntime_googleapis_com:quota_rate_net_usage{monitored_resource="consumer_quota", 

   quota_metric=~"compute.googleapis.com/globalreads"}[${_interval}]))