Kontingentmesswerte verwenden

Auf dieser Seite wird beschrieben, wie Sie Benachrichtigungsrichtlinien und -diagramme erstellen, um die Kontingentnutzung zu überwachen oder anzuzeigen. Allgemeine Informationen zu Kontingenten, einschließlich Informationen zu Kontingenten und Preiskontingenten, finden Sie unter Mit Kontingenten arbeiten.

Für alle Benachrichtigungsrichtlinien und -diagramme auf dieser Seite lautet die überwachte Ressource consumer_quota. Die Messwerte für diese Ressource sind eine Teilmenge der serviceruntime Messwerte.

  • Definitionen der Begriffe "Gauge", "Delta" und "Cumulative" finden Sie unter Arten von Messwerten.
  • Weitere Informationen zu den Feldern, die für die Kombination von Zeitachsen verwendet werden, finden Sie unter Aligner und Reducer.

Nutzerkontingente

Zum Anzeigen der Kontingentnutzung für ein bestimmtes Kontingent müssen Sie die Zeitachsen nach einem bestimmten Wert des Labels quota_metric filtern. Im Beispiel in diesem Abschnitt wird veranschaulicht, wie Sie den richtigen Wert für dieses Label durch Aufrufen von Zeitachsendaten ermitteln. Gehen Sie so vor, um den Wert dieses Labels für ein bestimmtes API-Kontingent zu ermitteln:

  1. Rufen Sie in der Google Cloud Console die Seite Kontingente für Identity and Access Management auf:

    Kontingente aufrufen

  2. Suchen Sie das gewünschte Kontingent und klicken Sie auf Alle Kontingente.

  3. Wenn ein Dienst Kontingentmesswerte unterstützt, wird das Feld Kontingentmesswert mit dem Wert des Labels quota_metric für diese API angezeigt. Der folgende Screenshot zeigt, dass der Wert des Labels quota_metric für das Kontingent der Compute Engine API-Subnetzwerke compute.googleapis.com/subnetworks lautet:

    Beispiel für eine Detailseite eines Kontingentmesswerts.

    Wenn ein Dienst keine Kontingentmesswerte unterstützt, wird das Feld Kontingentmesswert nicht angezeigt.

Beispiel

Das Ziel besteht darin, ein Diagramm zu erstellen, das die Speicherkontingente von Compute Engine nach Region zeigt.

  1. Wählen Sie in der Google Cloud Console Cloud Monitoring und dann Metrics Explorer aus.

  2. Konfigurieren Sie den Metrics Explorer, um die Nutzung des Zuteilungskontingents aufzurufen. Setzen Sie dazu den Ressourcentyp auf Nutzerkontingent und wählen Sie als Messwerttyp Nutzung von Zuteilungskontingenten aus:

    Wählen Sie das Nutzerkontingent aus.

    Das Diagramm zeigt die Nutzung des Zuteilungskontingents als Balkendiagramm für den Zeitraum von sechs Wochen. Wenn Sie die Legende aufrufen, sehen Sie, dass das Diagramm die Kontingentnutzung für mehrere Dienste anzeigt.

    Wenn Sie die Cloud Monitoring API verwenden, lautet der entsprechende Filterwert:

    metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota"
    
  3. Wenn Sie die Anzeige auf den Compute Engine-Dienst beschränken möchten, fügen Sie den Filter service = "compute.googleapis.com" hinzu:

    Nutzerkontingent nach Compute-Dienst filtern.

    Im Diagramm wird nun die Zeitachse für die zugewiesene Kontingentnutzung für Compute Engine-Kontingente angezeigt. Die Legende zeigt den Wert des Labels quota_metric für jede angezeigte Zeitachse an. Dieser Wert gibt das spezifische Kontingent an. Beispiel: compute.googleapis.com/disks_total_storage gibt an, dass die Zeitachsen für das Gesamtspeicherkontingent des Compute Engine-Speichers gelten. Im Diagramm wird die Kontingentnutzung nur für Kontingente angezeigt, für die die Nutzung aufgezeichnet wurde. Wenn ein Projekt beispielsweise keine Compute Engine-Ressourcen hat, führt dieser Filter zu einem Diagramm ohne Daten.

    Wenn Sie die Cloud Monitoring API verwenden, lautet der entsprechende Filterwert:

    metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota" resource.label.service="compute.googleapis.com"
    
  4. Fügen Sie den Filter quota_metric = "compute.googleapis.com/disks_total_storage" hinzu, um ein Diagramm zu erstellen, in dem die gesamte Speichernutzung des Compute Engine-Speicherkontingents angezeigt wird:

    Nutzerkontingent nach Kontingentmesswert filtern.

    Wenn Sie die Cloud Monitoring API verwenden, lautet der entsprechende Filterwert:

    metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota" metric.label.quota_metric="compute.googleapis.com/disks_total_storage"
    
  5. Die vorhergehende Karte zeigt Zeitreihen für die Regionen us-centra1 und us-east1 sowie für mehrere Zonen, einschließlich der Zone us-central1-a. Wenn Sie nur die Kontingentnutzung nach Region anzeigen möchten, fügen Sie einen Filter hinzu, der auf dem Label location basiert. In diesem Beispiel, in dem beide Regionen mit dem Präfix us- beginnen und mit 1 enden, funktioniert ein Filter, der den regulären Ausdruck location =~"^us.*1$" verwendet, gut:

    Nach Kontingentmesswert und Region filtern.

Bei Verbraucherkontingenten identifiziert der Wert des Labels quota_metric sowohl den Dienst als auch die konkrete Kontingentnutzung, die überwacht wird. Anhand dieser Informationen können Sie Diagramme oder Benachrichtigungsrichtlinien erstellen, die einen bestimmten Kontingentmesswert überwachen.

Beispiele für Benachrichtigungsrichtlinien

Eine Benachrichtigungsrichtlinie ist eine Sammlung von Bedingungen und Benachrichtigungsinformationen:

  • Eine Bedingung beschreibt, was überwacht wird, wie die Zeitachsedaten für diese Ressource kombiniert werden und wann eine Benachrichtigung generiert werden muss. Eine Benachrichtigungsrichtlinie muss mindestens eine Bedingung angeben.
  • Der Benachrichtigungskanal gibt an, wer benachrichtigt werden soll und wie er benachrichtigt werden soll, wenn eine Benachrichtigung erfolgt. Beispielsweise können Sie die Benachrichtigungsrichtlinie so konfigurieren, dass eine E-Mail an eine bestimmte Person oder an eine Gruppe von Personen gesendet wird.

Im verbleibenden Teil dieses Abschnitts enthält jeder Unterabschnitt eine JSON-Darstellung einer Benachrichtigungsrichtlinie. Wenn die Richtlinie mit der Google Cloud Console erstellt werden kann, sind auch zwei Tabellen enthalten:

  • Die erste Tabelle beschreibt, was überwacht wird und wie die Daten kombiniert werden.
  • Die zweite Tabelle beschreibt, wann eine Benachrichtigung generiert werden soll.

Die Werte in diesen Tabellen können zum Konfigurieren einer Benachrichtigungsrichtlinienbedingung verwendet werden.

Benachrichtigung über das Verhältnis von Kontingentnutzung zu Kontingentgrenze

Sie können eine Benachrichtigungsrichtlinie erstellen, um Sie zu benachrichtigen, wenn das Verhältnis von Kontingentnutzung zu Kontingentgrenze für einen Service in Ihrem Google Cloud-Projekt 80% überschreitet. Sie können diesen Richtlinientyp nur mithilfe der Cloud Monitoring API erstellen.

Verwendung der Cloud Monitoring API

Sie können diese Benachrichtigungsrichtlinie mithilfe der API-Methode erstellen alertPolicies.create. Sie können die Cloud Monitoring API direkt mit dem gcloud-Befehlszeilentool oder mithilfe von Clientbibliotheken aufrufen. Weitere Informationen finden Sie unter Richtlinien erstellen.

Informationen zur Darstellung von Benachrichtigungsrichtlinien in JSON oder YAML finden Sie unter Beispielrichtlinien.

Mit dieser Beispielrichtlinie wird das Verhältnis der Kontingentnutzung der Identity and Access Management API zum Kontingentlimit überwacht. Da die Kombination von Kontingentlimits möglicherweise bedeutungslos ist, wird in diesem Beispiel ein Standort angegeben.

{
    "combiner": "OR",
    "conditions": [
      {
        "conditionThreshold": {
          "filter": "metric.type=\"serviceruntime.googleapis.com/quota/allocation/usage\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"iam.googleapis.com\"",
          "aggregations": [
            {
              "alignmentPeriod": "86400s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_NEXT_OLDER"
            }
          ],
          "denominatorFilter": "metric.type=\"serviceruntime.googleapis.com/quota/limit\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"iam.googleapis.com\"",
          "denominatorAggregations" : [
            {
              "alignmentPeriod": "86400s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_NEXT_OLDER"
            }
          ],
          "comparison": "COMPARISON_GT",
          "duration": "60s",
          "thresholdValue": 0.8,
          "trigger": {
            "count": 1
          }
        },
        "displayName": "Ratio quota usage for iam.googleapis.com by label.quota_metric [SUM]",
      }
    ],
    "displayName": "Ratio quota usage to limit",
    "enabled": true,
  }

Benachrichtigung bei quota/exceeded-Fehlern

Sie können eine Benachrichtigungsrichtlinie erstellen, um Sie zu benachrichtigen, wenn ein Service in Ihrem Google Cloud-Projekt den Fehler "Kontingent überschritten" meldet. Sie können diesen Richtlinientyp mithilfe der Google Cloud Console oder mithilfe der Cloud Monitoring API erstellen.

Google Cloud Console verwenden

Der Rest des Inhalts in diesem Teilabschnitt bezieht sich auf das Bedingungsdialogfeld einer Benachrichtigungsrichtlinie.

Schließen Sie die Ausrichtung mithilfe der Einstellungen in der folgenden Tabelle. Mit dieser Einstellung geben Sie an, dass Sie die Zeitachsendaten für den serviceruntime Messwert /quota/exceeded für alle Services in Ihrem Google Cloud-Projekt überwachen und die Daten nach Kontingentgrenze gruppieren möchten.

Bereich Ziel
Feld

Wert
Ressourcentyp Geben Sie consumer_quota ein.
Messwert serviceruntime.googleapis.com/quota/exceeded auswählen
Filter

Leer lassen

Wenn Sie dieses Feld leer lassen, werden alle verfügbaren Messwertdaten im Diagramm angezeigt. Um die angezeigten Daten einzuschränken, können Sie einen Filter hinzufügen. Um beispielsweise die Daten auf den Logging-Service einzuschränken, fügen Sie den Filter service = logging.googleapis.com hinzu.

Group By (Gruppieren nach)

Wählen Sie quota_metric aus.

Bei dieser Option werden die Daten nach dem Namenstyp des quota_metric gruppiert.

Aggregator

Wählen Sie sum aus.

Das Aggregationsfeld wird automatisch auf sum gesetzt, wenn Daten gruppiert werden. Mit dieser Einstellung wird festgelegt, wie die Daten in den einzelnen Zeitachsen kombiniert werden.

Zeitraum Wählen Sie 1 m
aus
Erweiterte Aggregation Ausrichter: count true

Dieser Messwert ist vom Typ GAUGE, d. h., jeder Datenpunkt in der Zeitachse ist eine sofortige Messung. Der Werttyp ist BOOL. Der Wert true gibt an, dass das Kontingent überschritten wurde.

Für diesen Messwert sind die Ausrichter-Einstellungen von count true und count äquivalent.

Schließen Sie das Dialogfeld Konfiguration mit den folgenden Einstellungen ab. Diese Einstellungen bewirken, dass in der Benachrichtigungsrichtlinie eine Warnung erstellt wird, wenn die Anzahl der Fehler wegen überschrittener Kontingente den Wert 0 für 1 m überschreitet. Hier wird der Wert 0 ausgewählt, da Fehler aufgrund von Kontingentüberschreitungen unerwartet sind und ein Hinweis darauf sind, dass ein Kontingent erhöht werden muss oder dass ein Service geändert werden muss, um die API-Anfragen zu reduzieren. Sie können einen höheren Grenzwert verwenden.

Konfigurationsbereich
– Feld

Wert
Condition triggers if Any time series violates
Condition is above
Threshold 0
For 1 m

Verwendung der Cloud Monitoring API

Sie können diese Benachrichtigungsrichtlinie mithilfe der API-Methode erstellen alertPolicies.create. Sie können die Cloud Monitoring API direkt mit dem gcloud-Befehlszeilentool oder mithilfe von Clientbibliotheken aufrufen. Weitere Informationen finden Sie unter Richtlinien erstellen.

Informationen zur Darstellung von Benachrichtigungsrichtlinien in JSON oder YAML finden Sie unter Beispielrichtlinien.

Mit dieser Beispielrichtlinie wird das Verhältnis der Kontingentnutzung der Identity and Access Management API zum Kontingentlimit überwacht. Da die Kombination von Kontingentlimits möglicherweise bedeutungslos ist, wird in diesem Beispiel ein Standort angegeben.

{
    "combiner": "OR",
    "conditions": [
      {
        "conditionThreshold": {
          "aggregations": [
            {
              "alignmentPeriod": "60s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_COUNT_TRUE"
            }
          ],
          "comparison": "COMPARISON_GT",
          "duration": "60s",
          "filter": "metric.type=\"serviceruntime.googleapis.com/quota/exceeded\" resource.type=\"consumer_quota\"",
          "trigger": {
            "count": 1
          }
        },
        "displayName": "Quota exceeded error by label.quota_metric SUM",
      }
    ],
    "displayName": "Quota exceeded policy",
  }

Benachrichtigung über den absoluten quota/allocation/usage

Sie können eine Benachrichtigungsrichtlinie erstellen, damit Sie benachrichtigt werden, wenn die Nutzung von Zuteilungskontingenten für einen bestimmten Service in Ihrem Google Cloud-Projekt einen benutzerdefinierten Grenzwert überschreitet. Sie können diesen Richtlinientyp mithilfe der Google Cloud Console oder mithilfe der Cloud Monitoring API erstellen.

Google Cloud Console verwenden

Der Rest des Inhalts in diesem Teilabschnitt bezieht sich auf das Bedingungsdialogfeld einer Benachrichtigungsrichtlinie.

Schließen Sie die Ausrichtung mithilfe der Einstellungen in der folgenden Tabelle. Mit dieser Einstellung geben Sie an, dass Sie die Zeitachsendaten für den serviceruntime Messwert /quota/allocation/usage für einen Service in Ihrem Google Cloud-Projekt überwachen und die Daten nach Kontingentgrenze gruppieren möchten.

Bereich Ziel
Feld

Wert
Ressourcentyp Geben Sie consumer_quota ein.
Messwert serviceruntime.googleapis.com/quota/allocation/usage auswählen
Filter Fügen Sie den Filter service = iam.googleapis.com hinzu.

Ersetzen Sie iam.googleapis.com mit dem Namen des Service, den Sie überwachen möchten. In diesem Beispiel wurde dieser allgemeine Service ausgewählt.

Group By (Gruppieren nach)

Wählen Sie quota_metric aus.

Bei dieser Option werden die Daten nach dem Namenstyp des quota_metric gruppiert.

Aggregator

Wählen Sie sum aus.

Das Aggregationsfeld wird automatisch auf sum gesetzt, wenn Daten gruppiert werden. Mit dieser Einstellung wird festgelegt, wie die Daten in den einzelnen Zeitachsen kombiniert werden.

Zeitraum Wählen Sie 1440 m
aus

Der angegebene Zeitraum entspricht dem Stichprobenintervall für diesen Messwert.

Erweiterte Aggregation Ausrichter: next older

Der Ausrichter wird auf next older gesetzt, um den Messwert dieses GAUGE-Messwerts anzuzeigen.

Schließen Sie das Dialogfeld Konfiguration mit den folgenden Einstellungen ab. Durch diese Einstellungen wird in der Benachrichtigungsrichtlinie eine Warnung erstellt, wenn der Wert der Zeitachse für 1440 m über 2,5 liegt. Der Wert von 1440 m entspricht dem Ausrichtungszeitraum. Für dieses Beispiel wurde der Wert 2,5 ausgewählt, da er etwas höher als der Normalwert für das Testsystem ist. Wählen Sie den Schwellenwert basierend auf dem zu überwachenden Service in Kombination mit dem erwarteten Wertebereich für den Messwert aus.

Konfigurationsbereich
– Feld

Wert
Condition triggers if Any time series violates
Condition is above
Threshold 2.5
For 1440 m

Verwendung der Cloud Monitoring API

Sie können diese Benachrichtigungsrichtlinie mithilfe der API-Methode erstellen alertPolicies.create. Sie können die Cloud Monitoring API direkt mit dem gcloud-Befehlszeilentool oder mithilfe von Clientbibliotheken aufrufen. Weitere Informationen finden Sie unter Richtlinien erstellen.

Informationen zur Darstellung von Benachrichtigungsrichtlinien in JSON oder YAML finden Sie unter Beispielrichtlinien.

Mit dieser Beispielrichtlinie wird das Verhältnis der Kontingentnutzung der Identity and Access Management API zum Kontingentlimit überwacht. Da die Kombination von Kontingentlimits möglicherweise bedeutungslos ist, wird in diesem Beispiel ein Standort angegeben.

{
    "combiner": "OR",
    "conditions": [
      {
        "conditionThreshold": {
          "aggregations": [
            {
              "alignmentPeriod": "86400s",
              "crossSeriesReducer": "REDUCE_SUM",
              "groupByFields": [
                "metric.label.quota_metric"
              ],
              "perSeriesAligner": "ALIGN_NEXT_OLDER"
            }
          ],
          "comparison": "COMPARISON_GT",
          "duration": "84600s",
          "filter": "metric.type=\"serviceruntime.googleapis.com/quota/allocation/usage\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"iam.googleapis.com\"",
          "thresholdValue": 2.5,
          "trigger": {
            "count": 1
          }
        },
        "displayName": "Allocation quota usage for iam.googleapis.com by label.quota_metric SUM",
      }
    ],
    "displayName": "Absolute quota usage policy",
  }

Diagrammbeispiele

Diagramme zeigen Zeitachsendauer an. Mit dem Metrics Explorer können Sie ein Diagramm erstellen. Mit dem Metrics Explorer können Sie das Diagramm entweder löschen, wenn Sie es nicht mehr benötigen, oder es in einem Dashboard speichern. In der Dashboard-Ansicht können Sie ein Diagramm zum Dashboard hinzufügen.

Um ein Diagramm zu erstellen, geben Sie an, was Sie anzeigen möchten und wie Sie diese Daten anzeigen möchten. Der Rest dieses Abschnitts enthält Einstellungen, die zum Erstellen von Diagrammen verwendet werden können. Sie können auch die Einstellungen für das Dialogfeld Zielvorhaben einer Benachrichtigungsrichtlinie verwenden, um ein Diagramm zu erstellen.

Maximale Nutzung im Intervall für quota/allocation/usage

Um die Zeitachsendaten für den serviceruntime-Messwert quota/allocation/usage für alle Services in Ihrem Google Cloud-Projekt anzusehen, bei denen die Daten nach dem Namen der Quotenmetrik gruppiert sind und der maximale Wert der Metrik in einem 25-Stunden-Intervall angezeigt wird, nutzen Sie die folgenden Einstellungen:

Bereich Ziel
Feld

Wert
Ressourcentyp Geben Sie consumer_quota ein.
Messwert serviceruntime.googleapis.com/quota/allocation/usage auswählen
Filter Fügen Sie den Filter service = iam.googleapis.com hinzu.

Ersetzen Sie iam.googleapis.com mit dem Namen des Service, den Sie überwachen möchten. In diesem Beispiel wurde dieser allgemeine Service ausgewählt.

Group By (Gruppieren nach)

Wählen Sie quota_metric aus.

Bei dieser Option werden die Daten nach dem Namenstyp des quota_metric gruppiert.

Aggregator

Wählen Sie sum aus.

Das Aggregationsfeld wird automatisch auf sum gesetzt, wenn Daten gruppiert werden. Mit dieser Einstellung wird festgelegt, wie die Daten in den einzelnen Zeitachsen kombiniert werden.

Zeitraum Wählen Sie 1500 m
aus

Der Zeitraum von 25 Stunden ist etwas länger als das Stichprobenintervall für diesen Messwert.

Erweiterte Aggregation Ausrichter:max
Sekundärer Aggregator:sum

Der Ausrichter ist so eingestellt, dass er den Höchstwert des Messwerts anzeigt, der über den Ausrichtungszeitraum gemessen wurde. Der alternative Aggregator kombiniert die Zeitachsen für die verschiedenen Services zu einer einzigen Zeitachse.

Zeitachsen für quota/rate/net_usage

Um die Zeitachsendaten für den serviceruntime-Messwert quota/rate/net_usage für alle Services in Ihrem Google Cloud-Projekt anzusehen, bei denen die Daten nach dem Namen der Quotenmetrik gruppiert sind und die Nutzungsrate angezeigt wird, nutzen Sie die folgenden Einstellungen:

Bereich Ziel
Feld

Wert
Ressourcentyp Geben Sie consumer_quota ein.
Messwert serviceruntime.googleapis.com/quota/rate/net_usage auswählen
Filter Fügen Sie den Filter service = iam.googleapis.com hinzu.

Ersetzen Sie iam.googleapis.com mit dem Namen des Service, den Sie überwachen möchten. In diesem Beispiel wurde dieser allgemeine Service ausgewählt.

Group By (Gruppieren nach)

Wählen Sie quota_metric aus.

Bei dieser Option werden die Daten nach dem Namenstyp des quota_metric gruppiert.

Aggregator

Wählen Sie sum aus.

Das Aggregationsfeld wird automatisch auf sum gesetzt, wenn Daten gruppiert werden. Mit dieser Einstellung wird festgelegt, wie die Daten in den einzelnen Zeitachsen kombiniert werden.

Zeitraum Wählen Sie 1 m
aus

Der Zeitraum von einer Minute entspricht dem Stichprobenintervall für diesen Messwert.

Erweiterte Aggregation Ausrichter: rate

Durch Festlegen des Ausrichters auf den Wert rate werden die in der Zeitachse für diesen DELTA-Messwert gespeicherten Werte in eine neue Zeitachse umgewandelt, in der die Rate-Daten gespeichert werden. Die Y-Achse für das Diagramm enthält die Einheiten des Kontingents pro Sekunde.

Zeitachsen für quota/limit

Verwenden Sie die folgenden Einstellungen, um die Zeitreihendaten für den serviceruntime-Messwert quota/limit für alle Services in Ihrem Google Cloud-Projekt, in denen die Daten über 25 Stunden aggregiert sind, anzuzeigen:

Bereich Ziel
Feld

Wert
Ressourcentyp Geben Sie consumer_quota ein.
Messwert serviceruntime.googleapis.com/quota/limit auswählen
Filter Fügen Sie den Filter service = iam.googleapis.com hinzu.

Ersetzen Sie iam.googleapis.com mit dem Namen des Service, den Sie überwachen möchten. In diesem Beispiel wurde dieser allgemeine Service ausgewählt.

Group By (Gruppieren nach) Leer lassen
Aggregator none
Zeitraum Wählen Sie 1500 m
aus

Der angegebene Zeitraum entspricht dem Stichprobenintervall für diesen Messwert.

Erweiterte Aggregation Ausrichter: next older

Der Ausrichter wird auf next older gesetzt, um den Messwert dieses GAUGE-Messwerts anzuzeigen. Der Ausrichtungszeitraum von 25 Stunden ist etwas länger als das Stichprobenintervall für diesen Messwert.