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:

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

Kontingente aufrufen
Suchen Sie das gewünschte Kontingent und klicken Sie auf Alle Kontingente.
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:

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.

Wählen Sie in der Google Cloud Console Cloud Monitoring und dann Metrics Explorer aus.
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:

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"
```
Wenn Sie die Anzeige auf den Compute Engine-Dienst beschränken möchten, fügen Sie den Filter service = "compute.googleapis.com" hinzu:

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"
```
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:

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"
```
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:

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

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


{
    "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

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


{
    "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. Hinweis: Aufgrund des Intervalls zwischen den Stichproben sollte der Zeitraum des Diagramms mindestens eine Woche betragen.

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. Hinweis: Die Gruppierung oder Zusammenfassung von Kontingentlimits kann zu irreführenden Ergebnissen führen. Wenn es beispielsweise ein regionales Kontingentlimit von 30 pro Region und 20 Regionen gibt, beträgt das Kontingentlimit insgesamt 600. Sie können jedoch das Kontingentlimit pro Region überschreiten, wenn die Gesamtnutzung weniger als 600 beträgt.

Kontingentmesswerte verwenden

Nutzerkontingente

Beispiel

Beispiele für Benachrichtigungsrichtlinien

Benachrichtigung über das Verhältnis von Kontingentnutzung zu Kontingentgrenze

Verwendung der Cloud Monitoring API

Benachrichtigung bei quota/exceeded-Fehlern

Google Cloud Console verwenden

Verwendung der Cloud Monitoring API

Benachrichtigung über den absoluten quota/allocation/usage

Google Cloud Console verwenden

Verwendung der Cloud Monitoring API

Diagrammbeispiele

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

Zeitachsen für quota/rate/net_usage

Zeitachsen für quota/limit

Benachrichtigung bei `quota/exceeded`-Fehlern

Benachrichtigung über den absoluten `quota/allocation/usage`

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

Zeitachsen für `quota/rate/net_usage`

Zeitachsen für `quota/limit`