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.

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. Weitere Informationen zur Darstellung von Benachrichtigungsrichtlinien in JSON oder YAML finden Sie unter Beispiele für Richtlinien.

Mit dieser Beispielrichtlinie wird das Verhältnis der Kontingentnutzung der Cloud Spanner 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\"=\"spanner.googleapis.com\" resource.label.\"location\"=\"asia-east1\"",
              "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\"=\"spanner.googleapis.com\" resource.label.\"location\"=\"asia-east1\"",
              "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 to limit for spanner.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.
Erweiterte Aggregation	Ausrichter: `count true` Ausrichtungszeitraum: `1 m` 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


    {
        "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 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.
Erweiterte Aggregation	Ausrichter: `next older` Ausrichtungszeitraum: `1440 m` Der Ausrichter wird auf `next older` gesetzt, um den Messwert dieses `GAUGE`-Messwerts anzuzeigen. Der Abgleichzeitraum entspricht dem Stichprobenintervall für diesen Messwert.

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


    {
        "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 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.
Erweiterte Aggregation	Ausrichter: `max` Ausrichterzeitraum: `1500 m` Alternativer Aggregator:`sum` Der Ausrichter ist so eingestellt, dass er den Höchstwert des Messwerts anzeigt, der über den Ausrichtungszeitraum gemessen wurde. Der Ausrichtungszeitraum von 25 Stunden ist etwas länger als das Stichprobenintervall für diesen Messwert. 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.

Zeitreihen 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 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.
Erweiterte Aggregation	Ausrichter: `rate` Ausrichtungszeitraum: `1 m` 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. Der Ausrichtungszeitraum von 1 Minute entspricht dem Stichprobenintervall für diesen Messwert.

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 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`
Erweiterte Aggregation	Ausrichter: `next older` Ausrichtungszeitraum: `1500 m` 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

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

Zeitreihen 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`

Zeitreihen für `quota/rate/net_usage`

Zeitachsen für `quota/limit`