Mit Kontingenten arbeiten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Google Cloud verwendet Kontingente, um den Umfang einer bestimmten freigegebenen Google Cloud-Ressource einzuschränken. Jedes Kontingent stellt eine bestimmte zählbare Ressource dar, z. B. API-Aufrufe an einen bestimmten Dienst, die Anzahl der von Ihrem Projekt gleichzeitig verwendeten Load-Balancer oder die Anzahl der Projekte, die Sie erstellen können.

Auf dieser Seite wird die Verwendung von Kontingenten in Ihren Projekten beschrieben, z. B. wie Sie vorhandene Kontingentlimits einsehen und ändern, wie Sie ein höheres Kontingent anfordern und wie die Kontingentnutzung überwacht wird.

Viele Dienste haben auch Limits, die nicht mit dem Kontingentsystem in Zusammenhang stehen. Dies sind feste Einschränkungen wie die maximale Dateigröße oder die Datenbankschema-Begerenzungen, die nicht erhöht oder verringert werden können. Informationen dazu finden Sie auf der Seite für Kontingente und Limits des entsprechenden Dienstes (z. B. Kontingente und Limits für Cloud Storage).

Weitere Informationen zur Ressourcennutzung finden Sie unter den folgenden Links:

Jetzt testen

Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Jetzt kostenlos starten

Über Kontingente

Bevor Sie lernen, wie Sie Ihr Kontingent überwachen und verwalten, sollten Sie sich mit den Funktionsweisen des Kontingentsystems von Google Cloud vertraut machen. In diesem Abschnitt werden einige wichtige Kontingentkonzepte vorgestellt, einschließlich Kontingenttypen, Kontingentlimits und Anfragen zur Kontingenterhöhung.

Warum werden Kontingente durchgesetzt?

Kontingente gibt es aus verschiedenen Gründen. Darunter:

  • Der Schutz der Community der Google Cloud-Nutzer vor unvorhergesehenen Auslastungsspitzen und überlasteten Diensten.
  • Für die Ressourcenverwaltung. Sie können zum Beispiel Ihre eigenen Limits für die Nutzung von Diensten festlegen, während Sie Ihre Anwendungen entwickeln und testen, um unerwartete Kosten durch die Nutzung teurer Ressourcen zu vermeiden.

Kontingentarten

Es gibt zwei Kategorien für Kontingente:

  • Ratenkontingente werden in der Regel verwendet, um die Anzahl der Anfragen zu begrenzen, die an APIs oder Dienste gesendet werden können. Ratenkontingente werden nach einem für den Dienst spezifischen Zeitintervall zurückgesetzt, z. B. die Anzahl der API-Anfragen pro Tag.
  • Zuteilungskontingente werden verwendet, um die Nutzung von Ressourcen zu begrenzen, die keine Nutzungsrate haben, z. B. die Anzahl der VMs, die zu einem bestimmten Zeitpunkt von Ihrem Projekt verwendet wurden. Zuweisungskontingente werden im Laufe der Zeit nicht zurückgesetzt. Stattdessen müssen Sie die Ressource explizit freigeben, wenn Sie sie nicht mehr verwenden möchten, z. B. durch Löschen eines GKE-Clusters.

Innerhalb dieser Kategorien sind einige Kontingente global und gelten für Ihre Nutzung der Ressource überall in Google Cloud, während andere regional oder zonal sind und für Ihre Nutzung der Ressource in einer bestimmten Google Cloud-Region (beide Kontingenttypen) oder Zone (nur Zuweisungskontingente) gelten. Beispielsweise gibt es separate Limits für die Anzahl der Compute Engine-VM-Instanzen, die Sie in jeder Google Cloud-Region erstellen können.

Kontingente werden auf Projektbasis erzwungen, mit Ausnahme der Anzahl der Projekte, die Sie erstellen können. Diese werden pro Nutzerkonto und Rechnungskonto erzwungen.

Kontingentinformationen aufrufen

Es gibt mehrere Möglichkeiten, Ihr Google Cloud-Kontingent aufzurufen und zu verwalten:

Im weiteren Verlauf dieses Dokuments werden Einzelheiten zur Verwendung dieser Ansätze beschrieben. Jedes Produkt oder jeder Dienst hat seine eigenen Kontingente und Limits mit spezifischen Informationen zu den Kontingenten dieses Dienstes, z. B. der GKE-Seite „Kontingente und Limits“.

Informationen zu Kontingentlimits

Obwohl viele Dienste für einige Ressourcen Standardkontingente haben, sind die für Ihre Anwendungen geltenden Kontingentlimits spezifisch für Sie, Ihr Projekt oder Ihre Organisation. Wenn Sie beispielsweise ein Testkonto zum Ausprobieren der Plattform nutzen, für das Sie keinen Cent bezahlen, haben Sie möglicherweise für einige Ressourcen ein sehr geringes Kontingent im Vergleich zu selbst den niedrigsten Kontingenten für ein Konto, dessen Nutzung abgerechnet wird. Wenn Sie die Abrechnung für Ihr Projekt aktivieren, werden die Kontingente für die meisten Dienste erhöht. Kontingente können sich auch im Laufe der Zeit erhöhen, wenn Sie Google Cloud mit der Zeit stärker nutzen.

Wenn für Ihr Projekt eine bestimmte Ressource mehr benötigt wird, als Ihre Kontingente zulassen, können Sie für einen bestimmten Dienst ein höheres Kontingent anfordern. Weitere Informationen zur Funktionsweise von Anfragen zur Kontingenterhöhung finden Sie unter Anfragen zur Kontingenterhöhung. Sie können auch eigene Limits für bestimmte Kontingente hinzufügen, wenn Sie Ausgabengrenzen festlegen möchten, insbesondere beim Entwickeln oder Testen einer Anwendung, die teure Ressourcen verwendet.

Einige Kontingente sind für bestimmte Nutzer unbegrenzt. In diesem Fall können Sie diese Ressource so viel verwenden, wie Sie möchten.

Schließlich kann eine kleine Anzahl von Kontingenten nicht von ihren Standardwerten aus erhöht werden, z. B. wenn eine höhere Nutzung ein Anti-Pattern ist oder Ressourcen sehr begrenzt sind. Diese sind in der Regel auf der Seite „Kontingente und Limits“ des entsprechenden Dienstes dokumentiert, wie in diesem Beispiel von Cloud Functions dargestellt.

Aufbrauchen von Kontingenten

Wenn das Kontingent der Aufgabe, die Sie ausführen möchten, z. B. das Bereitstellen einer Anwendung, das Erstellen eines neuen Projekts oder das Aufrufen einer API, nicht ausreicht, erhalten Sie in den meisten Fällen einen Kontingentfehler. Die Aufgabe schlägt fehl, bis Sie Ressourcen freigeben (für das Zuweisungskontingent), den Zeitraum zurücksetzen (für das Ratenkontingent) oder eine Kontingenterhöhung anfordern und erhalten.

Wie der Kontingentfehler angezeigt wird, hängt von dem Tool oder Client ab, das oder den Sie für die Interaktion mit Google Cloud verwenden. Einzelheiten zu Kontingentfehlern finden Sie unter Kontingentfehler.

Sie können Kontingentfehler vermeiden, wenn Sie Monitoring so einrichten, dass Sie benachrichtigt werden, wenn das Kontingentlimit fast erreicht ist. Weitere Informationen zum Monitoring Ihrer Kontingente finden Sie weiter unten in diesem Dokument unter Monitoring und Benachrichtigungen zu Kontingentmesswerten.

Anfragen zur Kontingenterhöhung

Die meisten Anfragen zur Kontingenterhöhung werden von automatisierten Systemen auf der Grundlage strikter Kriterien ausgewertet, darunter die Verfügbarkeit von Ressourcen, die Dauer der Nutzung von Google Cloud und andere Faktoren. Anfragen, die bestimmte Kriterien nicht erfüllen, werden abgelehnt. Die Bewertungskriterien für automatisierte Überprüfungen werden nicht offengelegt, um Fairness für alle Kunden zu ermöglichen und Versuche zu verhindern, den Prozess zu manipulieren. In einigen Fällen werden Anfragen zur Kontingenterhöhung an menschliche Prüfer eskaliert, die ebenfalls strenge Kriterien erfüllen, aber die besonderen Umstände berücksichtigen können.

Möglicherweise werden Sie bei einigen Kontingenterhöhungen aufgefordert, im Voraus zu bezahlen. Beispielsweise werden Sie möglicherweise aufgefordert, eine Zahlung auszuführen, wenn Sie mehr Projekte anfordern, die kostenpflichtige Cloud-Dienste verwenden. Die Zahlung kann mit allen zukünftigen Belastungen verrechnet werden und wird in Ihrem Konto als Gutschrift angezeigt.

Informationen zum Anfordern eines höheren Kontingents finden Sie unter Höheres Kontingent anfordern. Sie benötigen keinen kostenpflichtigen Kundendienst, um eine Kontingenterhöhung anzufordern. Anfragen zur Kontingenterhöhung werden in der Regel innerhalb von 2–3 Werktagen abgeschlossen. Sie erhalten eine E-Mail, wenn Ihre Anfrage eingegangen ist. Sie können darauf antworten, wenn Sie Fragen haben oder zusätzliche Informationen zu Ihrer Anfrage angeben möchten, z. B. wenn Ihre Erhöhungsanfrage dringend ist. Sie erhalten nach der Verarbeitung der Anfrage eine weitere E-Mail, in der Sie darüber informiert werden, ob die Kontingenterhöhung genehmigt oder abgelehnt wurde. Die E-Mail gibt gegebenenfalls das Datum des Inkrafttretens der Erhöhung an.

Berechtigungen

Berechtigungen zum Aufrufen des Projektkontingents

Wenn Sie Ihr Projektkontingent in der Google Cloud Console aufrufen oder programmatisch auf das Projektkontingent zugreifen möchten, benötigen Sie die folgenden IAM-Berechtigungen (Identity and Access Management):

In der Referenz für IAM-Berechtigungen erfahren Sie, welche Rollen diese Berechtigungen standardmäßig enthalten.

Berechtigungen zum Ändern des Projektkontingents

Zum Ändern Ihres Kontingents auf Projekt-, Ordner- oder Organisationsebene benötigen Sie die folgende Berechtigung:

Diese ist standardmäßig in den Rollen „Inhaber“, „Bearbeiter“, „Kontingentadministrator“ und „Service Usage-Administrator“ enthalten.

Berechtigungen zum Aufrufen von Anfragen zur Kontingenterhöhung

Wenn Sie Anfragen zur Kontingenterhöhung in der Google Cloud Console ansehen möchten, benötigen Sie die folgenden IAM-Berechtigungen:

Kontingent in der Google Cloud Console ansehen

Ihre aktuellen Kontingentlimits können Sie in zwei verschiedenen Bereichen der Google Cloud Console einsehen:

  • Auf der Seite Kontingente sind alle Kontingentnutzungen und -limits für Ihr Projekt aufgelistet.
  • Das Google Cloud Console API-Dashboard, das Kontingentinformationen für eine bestimmte API auflistet, einschließlich der Ressourcennutzung in einem bestimmten Zeitraum.

Alle Projektkontingente ansehen

Führen Sie die folgenden Schritte aus, um die Kontingentnutzung und -limits für alle Ressourcen in Ihrem Projekt anzusehen:

  1. Öffnen Sie in der Google Cloud Console die Seite Kontingente.

    Kontingente aufrufen

  2. Wenn Sie sich auf die benötigten Informationen konzentrieren möchten, können Sie die Liste so filtern und sortieren:

    • Geben Sie zum Filtern der Liste die gewünschten Attribute und Werte in das Feld Filter ein. Wenn Sie beispielsweise die BigQuery API-Kontingente aufrufen möchten, wählen Sie Dienst und dann BigQuery API aus.
    • Zum Sortieren der Liste klicken Sie auf die Überschrift der Spalte, nach der Sie sortieren möchten. Wenn Sie beispielsweise alphabetisch nach dem Kontingentnamen sortieren möchten, klicken Sie auf die Spaltenüberschrift Kontingent.

      Standardmäßig werden die am häufigsten verwendeten Kontingente in der Liste sortiert. So können Sie leicht feststellen, bei welchen Limits die Gefahr besteht, dass sie überschritten werden.

Die Seite Kontingente zeigt eine Tabelle mit konfigurierbaren Spalten an. Die Spalten Dienst und Kontingent enthalten allgemeine Informationen dazu, welches Kontingent beschrieben wird. Beispiel: Der Dienst könnte Folgendes sein: Cloud Logging API und die Kontingente könnten Folgendes sein: Anfragen für Logaufnahme pro Minute. Im Feld Kontingent wird auch beschrieben, wie das Kontingent ausgewertet wird. Ratenkontingente werden pro Minute, 100 Sekunden oder pro Tag ausgewertet. Kontingente ohne diese Angaben sind Zuordnungskontingente.

Weitere Informationen zum Kontingent finden Sie in den Spalten Messwert, Bezeichnung des Limits und Überwachte Ressource. Diese Spalten enthalten detaillierte Informationen zum Diagramm eines Kontingents.

Informationen zur Kontingentnutzung finden Sie in den Spalten Aktuelle Nutzung und Spitzennutzung in den letzten 7 Tagen. Die in diesen Feldern angezeigten Werte werden so berechnet:

  • Für Ratenkontingente pro Minute gilt:

    • Die Aktuelle Nutzung gibt die Gesamtnutzung in den letzten zehn Minuten an.
    • Die 7-Tage-Höchstnutzung ist die durchschnittliche Spitzenauslastung in einem Intervall von einer Stunde für die letzten 7 Tage.
  • Für Ratenkontingente pro 100 Sekunden gilt:

    • Die Aktuelle Nutzung gibt die Gesamtnutzung in den letzten zehn Minuten an.
    • Die 7-Tage-Höchstnutzung ist die Spitze der Gesamtnutzung, berechnet über 1-Stunden-Intervalle der letzten 7 Tage.
  • Für Ratenkontingente pro Tag gilt:

    • Die aktuelle Nutzung ist die Gesamtnutzung für weit im aktuellen 24-Stunden-Zeitraum für Tagesratenkontingente.
    • Die 7-Tage-Höchstnutzung ist die Spitze der Gesamtnutzung, gemittelt über 1-Tage-Intervalle der letzten 7 Tage.
  • Für Zuweisungskontingente gilt:

    • Aktuelle Nutzung ist der aktuellste Wert. Diese Zahl kann beispielsweise die Anzahl der Load-Balancer enthalten, die derzeit von Ihrem Projekt verwendet werden.
    • Der 7-Tage-Höchstnutzung ist eine Schätzung der maximalen Nutzung. Die Schätzung wird berechnet, indem die Daten der letzten sieben Tage in 1-Stunden-Intervalle aufgeteilt werden. Dabei wird der Datenpunkt aus jedem Intervall mit dem neuesten Zeitstempel ausgewählt, und dann das Maximum dieses Sets ausgewählt. Aufgrund der Art und Weise, wie der Spitzenverbrauch geschätzt wird, könnte der Wert des Feldes den tatsächlichen Spitzenverbrauch unterschätzen.

Weitere Informationen zu Kontingenten für einen bestimmten Dienst finden Sie in der Dokumentation zu diesem Dienst. Das Compute Engine-Kontingent ist beispielsweise unter Ressourcenkontingente dokumentiert.

API-spezifische Kontingente aufrufen

Weitere Details zu Kontingenten für eine bestimmte API, einschließlich der laufenden Nutzung, finden Sie in der Google Cloud Console auf der Seite mit den Kontingenten für die API. Je nach der API können diese Limits Anfragen pro Tag, Anfragen pro Minute und Anfragen pro Minute pro Nutzer umfassen. Für einige APIs gelten sehr niedrige Limits, bis Sie die Abrechnung für Ihr Projekt aktivieren.

Sie können sich die aktuellen Limits für eine bestimmte API in zwei verschiedenen Bereichen der Google Cloud Console ansehen:

Anzahl der Projekte, die Sie erstellen können

Für jedes Nutzerkonto (einschließlich Dienstkonten) und Rechnungskonto ist die Anzahl der Projekte, die sie erstellen können, begrenzt. Wenn in Ihrem Kontingent weniger als 30 Projekte vorhanden sind, wird die Anzahl der im Kontingent verbleibenden Projekte in einer Meldung auf der Seite Neues Projekt angezeigt. Weitere Informationen zur Verwaltung dieses Kontingents finden Sie unter Projektkontingente verwalten und Anfragen zu Projektkontingenten.

Kontingent über die Google Cloud Console verwalten

Abhängig von Ihrer Ressourcennutzung möchten Sie die Kontingentlimits Ihres Projekts unter Umständen erhöhen oder herabsetzen. In diesem Abschnitt wird beschrieben, wie Sie die festgelegten Kontingentlimits ändern können. Klicken Sie in der Spalte Details auf Alle Kontingente, um Ihre Kontingentlimits aufzurufen.

Kontingente filtern

So filtern Sie die Liste der Kontingente nach bestimmten Attributen:

  1. Rufen Sie in der Google Cloud Console die Seite Kontingente auf.

    Kontingente aufrufen

  2. Klicken Sie auf Filter, um Ihr Kontingent anhand eines bestimmten Attributs abzufragen.

Höheres Kontingentlimit anfordern

Sie können in der Google Cloud Console eine Erhöhung der meisten Kontingente beantragen.


Eine detaillierte Anleitung dazu finden Sie direkt in der Google Cloud Console. Klicken Sie dazu einfach auf Anleitung:

Anleitung


Der Rest dieses Abschnitts führt Sie durch denselben Prozess wie das Klicken auf Anleitung.

So beantragen Sie über die Google Cloud Console ein höheres Kontingentlimit:

  1. Rufen Sie die Seite Kontingente auf:

    Kontingente aufrufen

  2. Suchen Sie auf der Seite Kontingente in der Spalte Kontingent nach dem Kontingent, das Sie erhöhen möchten.

    Über das Suchfeld Filter können Sie nach Ihrem Kontingent suchen.

  3. Klicken Sie das Kästchen links neben Ihrem Kontingent an.

  4. Klicken Sie auf KONTINGENTE BEARBEITEN. Das Formular Kontingentänderungen wird angezeigt.

  5. Geben Sie im Formular Kontingentänderungen in das Feld Neues Limit das gewünschte Kontingent für Ihr Projekt ein.

  6. Füllen Sie die zusätzlichen Felder im Formular aus und klicken Sie dann auf FERTIG.

  7. Klicken Sie auf Anfrage senden.

Obwohl das obige Verfahren für die meisten Anfragen zur Kontingenterhöhung gilt, kann eine der folgenden Ausnahmen auftreten:

  • In einigen Fällen werden Sie von der Google Cloud Console zu einem separaten Formular weitergeleitet, um ein höheres Limit anzufordern. Nachdem Sie das Formular gesendet haben, bestätigt Google Cloud Ihre Anfrage per E-Mail.
  • Einige Kontingente können nicht über die Google Cloud Console aktualisiert werden. Wenn Sie feststellen, dass Sie ein Kontingent nicht über die Console ändern können, fordern Sie eine Erhöhung über Cloud Customer Care an. Das Abrechnungsteam bearbeitet keine Kontingenterhöhungen.

Wenn Ihre Anfrage zur Kontingenterhöhung Genehmigung erfordert, können Sie erwarten, eine E-Mail von Google Cloud mit einer Empfangsbestätigung zu erhalten. Sie können auf diese E-Mail antworten, wenn Sie weitere Hilfe benötigen. Cloud Customer Care bearbeitet Ihre Anfrage normalerweise innerhalb von zwei bis drei Werktagen und sendet Ihnen eine zweite E-Mail, in der Sie darüber informiert werden, ob die Kontingenterhöhung genehmigt oder abgelehnt wurde. Die E-Mail gibt gegebenenfalls das Datum des Inkrafttretens der Erhöhung an.

Weitere Informationen zur Funktionsweise der Kontingenterhöhung finden Sie unter Anfragen zur Kontingenterhöhung.

Anfragen zur Kontingenterhöhung ansehen

Sie können derzeit ausstehende und vergangene Kontingenterhöhungsanfragen in der Google Cloud Console sehen.

So zeigen Sie ausstehende Anfragen zur Kontingenterhöhung an:

  1. Prüfen Sie, ob Sie die Berechtigung zum Ansehen von Kontingenterhöhungsanfragen haben.

  2. Rufen Sie die Seite Kontingente auf:

    Kontingente aufrufen

  3. Auf der Seite Kontingente wird neben den Kontingentlimits, die derzeit auf eine Entscheidung für zuvor gesendete Erhöhungsanfragen warten, Ausstehend angezeigt. Sie können auf Ausstehend klicken, um Details zu den ausstehenden Anfragen anzuzeigen.

Ausstehende Anfragen werden auch im Formular Kontingentänderungen angezeigt, wenn eine neue Kontingenterhöhung angefordert wird.

So zeigen Sie alle Kontingenterhöhungsanfragen an (derzeit ausstehende und vergangene Anfragen):

  1. Rufen Sie die Seite Kontingente auf:

    Kontingente aufrufen

  2. Klicken Sie auf den Tab Anfragen erhöhen.

  3. Klicken Sie auf Filter um Ihre Kontingenterhöhungsanfragen nach einem bestimmten Attribut abzufragen.

Ist eine Organisation oder ein Ordner ausgewählt, werden auf der Seite alle Anfragen zur Kontingenterhöhung für alle Projekte unter der Organisation oder dem Ordner angezeigt.

Nutzung einschränken

Möglicherweise möchten Sie die Nutzung einer bestimmten Ressource einschränken, indem Sie ein eigenes Kontingentlimit festlegen. Wenn Sie beispielsweise verhindern möchten, dass Ihnen Anfragen berechnet werden, die das Limit für die kostenlose Nutzung überschreiten, können Sie eine Obergrenze für die Anfragen pro Tag anfordern.

Führen Sie die gleichen Schritte wie unter Höheres Kontingentlimit anfordern aus, um ein Kontingent zu begrenzen.

Die Einschränkung der Nutzung mit Kontingenten gilt nicht für alle Dienste. Weitere Informationen finden Sie auf der Seite zu den Kontingenten für den jeweiligen Dienst.

Kontingente über das Google Cloud CLI verwalten (Alpha)

Mit dem Google Cloud CLI können Sie aktuelle Kontingente abrufen und die Kontingentnutzung für einige Google Cloud APIs und -Dienste beschränken, einschließlich project-, folder- und Kontingenten auf Organisationsebene, sofern verfügbar.

Für diesen Ansatz müssen Sie zuerst die neueste Version des Google Cloud CLI installiert und initialisiert haben, einschließlich der Alphabefehle. Wenn Sie Cloud Shell für die Interaktion mit Google Cloud verwenden, wird das Google Cloud CLI für Sie installiert.

Führen Sie den folgenden Befehl aus und ersetzen Sie dabei Ihre Projekt-ID und den Dienstnamen ein:

gcloud alpha services quota list \
    --service=SERVICE_NAME.googleapis.com \
    --consumer=projects/PROJECT_ID

So rufen Sie die Kontingentdetails desselben Dienstes für eine Organisation auf:

gcloud alpha services quota list \
    --service=SERVICE_NAME.googleapis.com \
    --consumer=organizations/ORG_ID

Eine vollständige Liste der gcloud quota-Befehle und Flags finden Sie in der Referenz zum Google Cloud CLI.

Zusätzlich zu gcloud quota haben einige Dienste einen eigenen Befehlszeilenzugriff auf Informationen zu Kontingenten und zur Ressourcennutzung. In Compute Engine können Sie beispielsweise mithilfe von gcloud compute auf Kontingentinformationen zugreifen.

Kontingente über die Service Usage API verwalten

Mit den Service Usage APIs können Sie aktuelle Kontingente abrufen und die Kontingentnutzung für einige Google Cloud APIs und -Dienste beschränken. Weitere Informationen zu Service Usage finden Sie hier:

Sie können die Service Usage API allerdings nicht nutzen, um ein höheres Kontingent anzufordern. Dazu müssen Sie die Google Cloud Console verwenden.

Monitoring und Benachrichtigungen zu Kontingentmesswerten

Mit der Cloud Monitoring API und der Benutzeroberfläche können Sie die Kontingentnutzung, -limits und -fehler im Detail überwachen. Sie können diese Messwerte verwenden, um benutzerdefinierte Dashboards und Benachrichtigungen zu erstellen. So können Sie die Kontingentnutzung im Zeitverlauf überwachen und erhalten Benachrichtigungen, wenn beispielsweise ein Kontingentlimit erreicht wird.

Cloud Monitoring unterstützt eine Vielfalt an Messwerten, die Sie mit Filtern und Aggregationen kombinieren können. Auf diese Weise erhalten Sie neue und aufschlussreiche Einblicke in Ihre Kontingentnutzung. Beispielsweise können Sie einen Messwert für die Nutzung von Zuteilungskontingenten mit einem quota_metric-Filter für Cloud TPU-Namen kombinieren.

So rufen Sie mit dem Metrics Explorer die Messwerte für eine überwachte Ressource auf:

  1. Rufen Sie in der Google Cloud Console unter „Monitoring“ die Seite „Metrics Explorer” auf.
  2. Zum Metrics Explorer

  3. Wählen Sie in der Symbolleiste den Tab Explorer aus.
  4. Wählen Sie den Tab Konfiguration aus.
  5. Maximieren Sie das Menü Messwert auswählen, geben Sie quota usage in die Filterleiste ein und wählen Sie dann über die Untermenüs einen bestimmten Ressourcentyp und Messwert aus:
    1. Wählen Sie im Menü Aktive Ressourcen die Option Nutzerkontingent aus.
    2. Wählen Sie im Menü Aktive Messwertkategorien die Option Kontingent aus.
    3. Wählen Sie im Menü Aktive Messwerte die Option Nutzung von Zuteilungskontingenten oder Nutzung von Ratenkontingenten aus.
    4. Klicken Sie auf Anwenden.
  6. Optional: Konfigurieren Sie die Anzeige der Daten, fügen Sie Filter hinzu und verwenden Sie die Menüs Gruppieren nach, Aggregator und Diagrammtyp. Sie können beispielsweise nach Ressourcen- oder Messwertlabels gruppieren. Weitere Informationen finden Sie unter Messwerte bei Verwendung von Metrics Explorer auswählen.
  7. Optional: Ändern Sie die Diagrammeinstellungen:
    • Legen Sie für Kontingente und andere Messwerte, die eine Stichprobe pro Tag melden, den Zeitraum auf mindestens eine Woche fest und geben Sie als Darstellungstyp Übereinander angeordnetes Balkendiagramm an.
    • Stellen Sie für Verteilungsmesswerte die Darstellung auf Heatmap-Diagramm ein.

Auf ähnliche Weise können Sie Kontingentlimits oder Fehler aufgrund von Kontingentüberschreitungen einsehen. Zuerst wählen Sie als Ressourcentyp Nutzerkontingent und dann Kontingentlimit oder Kontingent überschritten aus.

Nachdem Sie die gewünschten Informationen zur Kontingentnutzung ermittelt haben, können Sie mit Cloud Monitoring benutzerdefinierte Dashboards und Benachrichtigungen erstellen. Dies erleichtert Ihnen die Beobachtung und Wartung einer robusten Anwendung. Weitere Informationen finden Sie in folgenden Dokumenten:

Beispiele für gängige kontingentspezifische Benachrichtigungsrichtlinien finden Sie unter Kontingentmesswerte verwenden.

Im Cloud Monitoring-Referenzhandbuch finden Sie eine detaillierte Referenz für Kontingentmesswerte.

Unterstützung von Kontingentmesswerten prüfen

Nicht alle Dienste unterstützen Kontingentmesswerte in Cloud Monitoring. Wenn Sie sich die anwendbaren Kontingentmesswerte für unterstützte Dienste ansehen möchten, wählen Sie beim Erstellen eines Diagramms oder beim Erstellen einer Benachrichtigungsrichtlinie als Ressourcentyp Nutzerkontingent aus. Dienste, die Kontingentmesswerte nicht unterstützen, sind dann nicht zu sehen.

  • Zu den gängigen Diensten, die Kontingentmesswerte unterstützen, gehören: Compute Engine, Dataflow, Cloud Spanner, Pub/Sub, Cloud Vision, Speech-to-Text, Cloud Monitoring und Cloud Logging.

  • Zu den gängigen Diensten, die keine Kontingentmesswerte unterstützen, gehören App Engine, Cloud Storage und Cloud SQL.

Kontingentfehler

Wenn Ihr Projekt bei der Nutzung eines Dienstes ein Kontingent überschreitet, gibt Google Cloud einen Fehler basierend darauf zurück, wie Sie auf den Dienst zugegriffen haben:

  • Wenn Sie mit einer HTTP/REST-Anfrage ein Kontingent überschritten haben, gibt Google Cloud den HTTP-Statuscode 429 TOO MANY REQUESTS zurück.
  • Wenn Sie mit einer API-Anfrage ein Kontingent überschreiten, gibt Google Cloud den HTTP-Statuscode 413 REQUEST ENTITY TOO LARGE zurück.
  • Wenn Sie mit gRPC ein Kontingent überschritten haben, gibt Google Cloud einen ResourceExhausted-Fehler zurück. Wie dieser Fehler angezeigt wird, hängt vom Dienst ab.
  • Wenn Sie mit einem Google Cloud CLI-Befehl ein Kontingent überschritten haben, gibt die gcloud CLI eine Fehlermeldung über das Kontingent aus und liefert den Exit-Code 1.

Ratenkontingente werden nach einem vordefinierten Zeitintervall zurückgesetzt, das für jeden Dienst spezifisch ist. Weitere Informationen finden Sie in der Dokumentation zu Kontingenten für den jeweiligen Dienst.

Wenn Sie benachrichtigt werden möchten, wenn Fehler in Zukunft auftreten, können Sie benutzerdefinierte Benachrichtigungen für bestimmte Kontingentfehler erstellen, wie in Kontingentmesswerte überwachen beschrieben.