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

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

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

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.