API-Kontingente von globalen Messwerten zu regionalen Messwerten migrieren


In diesem Dokument werden die Kontingentmesswerte für regionale APIs und das Limit für jeden Messwert beschrieben. Außerdem erfahren Sie, wie Sie Ihre Cloud-Monitoring-Dashboards, Benachrichtigungsrichtlinien und Abfragen für die Verwendung der regionalen Messwerte aktualisieren.

Kontingentmesswerte für regionale APIs

Regionale Compute Engine-APIs, die die globalen Kontingentmesswerte verwendet haben, werden zu den regionalen Messwerten migriert. Globale APIs verwenden weiterhin die globalen Messwerte und Kontingentlimits. Siehe API-Ratenbegrenzungen für globale Messwerte.

Weitere Informationen zu den Methoden, die die regionalen Messwerte und Limits verwenden, finden Sie unter API-Ratenbegrenzungen für regionale Messwerte.

In der folgenden Tabelle sind alle Messwerte aufgeführt, die von den Kontingentmesswerten für globale APIs zu regionalen Messwerten migriert werden:

Kontingentmesswert für globale APIs Kontingentmesswert für regionale APIs
compute.googleapis.com/default compute.googleapis.com/default_per_region BETA
compute.googleapis.com/read_requests compute.googleapis.com/read_requests_per_region BETA
compute.googleapis.com/list_requests compute.googleapis.com/list_requests_per_region BETA
compute.googleapis.com/operation_read_requests compute.googleapis.com/operation_read_requests_per_region BETA
compute.googleapis.com/heavy_weight_read_requests compute.googleapis.com/heavy_weight_read_requests_per_region BETA
compute.googleapis.com/heavy_weight_write_requests compute.googleapis.com/heavy_weight_write_requests_per_region BETA
compute.googleapis.com/global_resource_write_requests compute.googleapis.com/global_resource_write_requests_per_region BETA

Die folgenden Messwerte haben keine globalen APIs. Wenn Sie in den Dashboards, Benachrichtigungen oder Abfragen von Cloud Monitoring auf diese Messwerte verweisen, müssen Sie diese Messwerte zu den entsprechenden regionalen Messwerten migrieren.

Kontingentmesswert für globale APIs Kontingentmesswert für regionale APIs
compute.googleapis.com/simulate_maintenance_event_requests compute.googleapis.com/simulate_maintenance_event_requests_per_region BETA
compute.googleapis.com/instance_list_referrers_requests compute.googleapis.com/instance_list_referrers_requests_per_region BETA
compute.googleapis.com/get_serial_port_output_requests compute.googleapis.com/get_serial_port_output_requests_per_region BETA
compute.googleapis.com/network_endpoint_write_requests compute.googleapis.com/network_endpoint_write_requests_per_region BETA
compute.googleapis.com/network_endpoint_list_requests compute.googleapis.com/network_endpoint_list_requests_per_region BETA

Die folgenden Messwerte haben keine regionalen oder zonalen APIs. Daher sind für die Migration der Kontingente regionaler APIs keine Änderungen erforderlich.

  • compute.googleapis.com/project_set_common_instance_metadata_requests
  • compute.googleapis.com/license_insert_requests

Cloud Monitoring-Messwerte migrieren

Wenn Sie von den vorhandenen API-Kontingentmesswerten zu den Kontingentmesswerten regionaler APIs migrieren, müssen Sie die Cloud Monitoring-Dashboards, -Benachrichtigungen und -Abfragen manuell aktualisieren, um regionale Messwerte zu verwenden.

Cloud Monitoring-Dashboard aktualisieren, um die regionalen Messwerte zu verwenden

So ändern Sie eine Benachrichtigungsrichtlinie, die einen Kontingentmesswert für globale APIs überwacht, in einen regionalen Messwert:

  1. Wählen Sie in der Google Cloud Console Monitoring aus.
  2. Wählen Sie im Navigationsbereich die Option Dashboards aus.
  3. Wählen Sie das zu bearbeitende Dashboard aus, das einen regionalen Messwert verwenden soll.
  4. Klicken Sie auf Dashboard bearbeiten.
  5. Bearbeiten Sie den Filter für den zu migrierenden Messwert:

    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 regionale API-Kontingent an. Der Filter quota_metric =~ compute.googleapis.com/read_requests.* verwendet beispielsweise einen regulären Ausdruck, um alle Zeitreihendaten abzugleichen, die den Kontingentmesswert compute.googleapis.com/read_requests.* verwenden.

      Filterwert bearbeiten, um einen regionalen Messwert zu verwenden.

      Weitere Informationen zu den Messwerten finden Sie unter API-Ratenbegrenzungen für regionale Messwerte.

    4. Klicken Sie auf Fertig, um die Änderungen zu speichern.

    5. Optional: Wenn Sie die Nutzung von Kontingenten pro Region aufrufen möchten, maximieren Sie den Header Gruppiert und wählen Sie location im Feld Gruppieren nach aus.

  6. Klicken Sie auf Editor schließen.

Cloud Monitoring-Benachrichtigungsrichtlinien aktualisieren, um die Kontingentmesswerte für regionale APIs zu verwenden

So ändern Sie eine Benachrichtigungsrichtlinie, die einen Kontingentmesswert für globale APIs überwacht, in einen regionalen Messwert:

  1. Wählen Sie in der Google Cloud Console Monitoring aus.
  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 die Benachrichtigungsrichtlinie, die Sie bearbeiten möchten, um einen regionalen Messwert zu verwenden.
  4. Klicken Sie auf Bearbeiten, um die Richtlinie zu ändern.
  5. Bearbeiten Sie den Filter für den zu migrierenden Messwert:

    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 regionale API-Kontingent an. Der Filter quota_metric =~ compute.googleapis.com/read_requests.* verwendet beispielsweise einen regulären Ausdruck, um alle Zeitreihendaten abzugleichen, die den Kontingentmesswert compute.googleapis.com/read_requests.* verwenden.

      Benachrichtigung bearbeiten, um einen regionalen Messwert zu verwenden.

      Weitere Informationen zu den Messwerten finden Sie unter API-Ratenbegrenzungen für regionale Messwerte.

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

    5. Optional: Wenn Sie eine regionsspezifische Benachrichtigung für den regionalen Messwert wünschen, maximieren Sie den Header Über Zeitreihen hinweg und wählen Sielocation im Feld Zeitreihen gruppieren nach aus.

  6. Klicken Sie auf Richtlinie speichern.

Cloud Monitoring-Abfragen für die Verwendung der regionalen Kontingentmesswerte aktualisieren

Verwenden Sie den Abfrageeditor und bearbeiten Sie den Abfragefilter, um den Kontingentmesswert in einer MQL-basierten Benachrichtigungsrichtlinie oder in einem Diagramm in einem Dashboard zu ändern. Informationen dazu finden Sie unter Abfrageeditor verwenden.

Öffnen Sie den Abfrageeditor und bearbeiten Sie den Filter für den Abfragemesswert, wie im folgenden Beispiel gezeigt:

Regulärer Ausdruck für regionalen Kontingentmesswert

Optional können Sie die Benachrichtigung mithilfe des Vorgangs group-by anhand eines Standorts gruppieren:

Nach Standort gruppieren