Mit Kontingenten arbeiten

Google Cloud nutzt 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 gleichzeitig von Ihrem Projekt verwendeten Load-Balancer oder die Anzahl der Projekte, die Sie erstellen können.

In diesem Dokument 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.

Informationen zum Aufrufen weiterer API-Nutzungsmesswerte finden Sie unter API-Nutzung überwachen.

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 zu prüfen und zu bewerten. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Jetzt kostenlos starten

Über Kontingente

Bevor Sie erfahren, wie Sie Ihr Kontingent überwachen und verwalten können, 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 gelten Kontingente?

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. Beispielsweise können Sie eigene Limits für die Dienstnutzung festlegen, während Sie Ihre Anwendungen entwickeln und testen. So vermeiden Sie, dass unerwartete Kosten auf teure Ressourcen zugreifen.

Kontingentarten

Es gibt zwei Kategorien für Kontingente:

  • Ratenkontingente werden in der Regel verwendet, um die Anzahl der Anfragen zu begrenzen, die Sie an eine API oder einen Dienst senden 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 gelten 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 den einzelnen Google Cloud-Regionen erstellen können.

Kontingente werden pro Projekt erzwungen, mit Ausnahme der Anzahl von Projekten, die Sie erstellen können. Diese werden pro Nutzerkonto und Rechnungskonto erzwungen.

Kontingentinformationen ansehen

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. Außerdem enthält jedes Produkt bzw. jeder Dienst eine eigene Kontingent- und Limitsseite mit spezifischen Informationen zu den Kontingenten dieses Dienstes, z. B. der GKE-Seite „Kontingente und Limits“.

Informationen zu Kontingentlimits

Viele Dienste haben für einige Ressourcen Standardkontingente. Die für Ihre Anwendungen geltenden Kontingentlimits gelten jedoch speziell für Sie, Ihr Projekt oder Ihre Organisation. Wenn Sie beispielsweise ein kostenloses Testkonto nutzen, um die Plattform kennenzulernen, ist das Kontingent für einige Ressourcen möglicherweise im Vergleich zu den niedrigsten Kontingenten für eine in Rechnung gestellte Menge sehr niedrig. 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 Ihr Projekt mehr von einer bestimmten Ressource benötigt, als Ihr Kontingent zulässt, können Sie für einen bestimmten Dienst mehr Kontingente anfordern. Weitere Informationen zur Funktionsweise von Anfragen zur Kontingenterhöhung finden Sie unter Anfragen zu Kontingenterhöhungen. Für bestimmte Kontingente können Sie auch eigene Limits festlegen, 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 eine beliebige Menge dieser Ressource nutzen.

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.

Kontingent aufgebraucht

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 vom Tool oder Client ab, mit dem Sie mit Google Cloud interagieren. Weitere Informationen zu Kontingentfehlern finden Sie unter Kontingentfehler.

Sie können Kontingentfehler vermeiden, indem Sie Monitoring einrichten, damit Sie benachrichtigt werden, wenn die Kontingentlimits fast erreicht sind. Weitere Informationen zum Überwachen 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 anhand strenger 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. Bewertungskriterien für automatisierte Überprüfungen werden nicht veröffentlicht, um Fairness für alle Kunden zu gewährleisten und Versuche, den Prozess zu manipulieren, zu verhindern. In einigen Fällen werden Anfragen zur Erhöhung von Kontingenten an Prüfer weitergeleitet, die ebenfalls strenge Kriterien erfüllen, aber ihre 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.

Anfragen zur Kontingenterhöhung werden von Cloud Customer Care (nicht von der Abrechnung) bearbeitet, die Ihre Anfrage normalerweise innerhalb von 2 bis 3 Werktagen bearbeiten. Sie erhalten eine E-Mail, sobald Ihre Anfrage eingegangen ist. Auf diese können Sie antworten, wenn Sie Fragen haben oder zusätzliche Informationen zu Ihrem Antrag benötigen (z. B. wenn Ihr Antrag auf Erhöhung dringend ist). Nach der Verarbeitung der Anfrage erhalten Sie 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.

Weitere Informationen zum Anfordern eines größeren Kontingents finden Sie unter Höheres Kontingent anfordern.

Berechtigungen

Berechtigungen zum Aufrufen des Projektkontingents

Damit Sie Ihr Projektkontingent in der Google Cloud Console ansehen oder programmgesteuert auf das Projektkontingent zugreifen können, benötigen Sie die folgenden IAM-Berechtigungen:

  • resourcemanager.projects.get
  • resourcemanager.folders.get (wenn Sie das Kontingent für einen gesamten Ordner ansehen möchten)
  • resourcemanager.organizations.get (wenn Sie das Kontingent für eine gesamte Organisation ansehen möchten)
  • serviceusage.quotas.get

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.

Kontingent in der 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 Cloud Console API-Dashboard, das Kontingentinformationen für eine bestimmte API auflistet, einschließlich der Ressourcennutzung in einem bestimmten Zeitraum.

Alle Projektkontingente ansehen

So rufen Sie die Kontingentnutzung und -limits für alle Ressourcen in Ihrem Projekt auf:

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

    Kontingente aufrufen

    Die Liste enthält für jeden Kontingenttyp, der in den einzelnen Diensten verfügbar ist, eine Position.

  2. Sortieren und filtern Sie die Ergebnisse, um die gewünschten Informationen einfacher zu finden:

    • Wenn Sie ein bestimmtes Attribut aufrufen möchten, klicken Sie auf Filtertabelle.
    • Um die Listen alphabetisch zu sortieren, halten Sie den Mauszeiger über Dienst, Name des Limits, Kontingentstatus oder Details-Überschrift.
    • Standardmäßig wird die Liste so sortiert, dass zuerst das am stärksten genutzte Kontingent angezeigt wird (in Bezug auf die Nutzung der letzten sieben Tage). So können Sie ermitteln, bei welchen Limits die Gefahr besteht, dass sie überschritten werden. Sie können sich das am wenigsten verwendete Kontingent zuerst anzeigen lassen, indem Sie den Pfeil Kontingentstatus umschalten.
    • Wenn Sie weitere Informationen zu Ihrer aktuellen Nutzung für ein bestimmtes Kontingent erhalten möchten, klicken Sie in der Spalte Details auf Alle Kontingente.

Die auf der Seite Kontingente aufgeführten Messwerte zur Kontingentnutzung werden so berechnet:

  • Ratenkontingente:
    • Bei Tageskontingenten entspricht der aufgelistete Wert die gesamte Nutzung im aktuellen 24-Stunden-Zeitraum.
    • Für das Kontingent pro Minute oder pro 100 Sekunden steht die angegebene durchschnittliche Nutzung für die letzten 24 Stunden.
  • Zuordnungskontingente: Die angezeigte Anzahl entspricht der Ressourcenmenge (z. B. der Anzahl der Load-Balancer), die derzeit von Ihrem Projekt verwendet wird.

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

Detaillierte Kontingentinformationen für eine bestimmte API, einschließlich der Nutzung im Zeitverlauf, finden Sie auf der Kontingentseite der API in der Cloud Console. 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 Cloud Console ansehen:

  • Auf der Seite „Kontingente” der Cloud Console, wie im Abschnitt Alle Projektkontingente ansehen beschrieben.

  • Auf der Dashboard-Seite „APIs & Dienste” der Cloud Console. Wählen Sie auf dieser Seite Ihr Projekt aus, klicken Sie auf den API-Namen und dann auf Kontingente. Auf der Seite Kontingente werden die Kontingentnamen für die API angezeigt. Sie können die Kontingente maximieren, um Informationen zur Nutzung in einem bestimmten Zeitraum sowie zum aktuellen Limit einzublenden. Standardmäßig entsprechen die angezeigten Limits denen von Google. Sie können die Nutzung einschränken, wie im Abschnitt Nutzung einschränken beschrieben. Wenn für ein bestimmtes Kontingent kein von Google festgelegtes Limit besteht, wird das Limit als unbegrenzt angezeigt.

    Einige Kontingente werden nicht auf einer API-spezifischen Kontingentseite angezeigt. Zum Beispiel haben Anfragen an die Compute Engine API eine API-spezifische Kontingentseite, jedoch ohne die Nutzung von Compute Engine-Ressourcen (Zuweisungskontingent). Wenn Sie einen Dienst an mehreren Standorten verwenden, werden auf der API-spezifischen Kontingentseite keine regionalen und zonalen Kontingentlimits und deren entsprechende Nutzung angezeigt. Eine vollständige Liste der Kontingentnutzung Ihres Projekts, die Sie nach Standort filtern können, finden Sie auf der Seite Kontingente des Projekts.

Anzahl der Projekte, die Sie erstellen können

Für jedes Nutzerkonto (einschließlich Dienstkonten) und jedes Rechnungskonto gilt ein Limit für die Anzahl der Projekte, die sie erstellen können. 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 Projektkontingentanfragen.

Kontingente über die 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 Filtertabelle von , um Ihr Kontingent anhand eines bestimmten Attributs abzufragen.

Höheres Kontingentlimit anfordern

Sie können die meisten Kontingente direkt in der Google Cloud Console anfordern, indem Sie die folgenden Schritte ausführen. Es kann eine der folgenden Ausnahmen gegeben werden:

  • 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.

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

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

  1. Rufen Sie die Seite Kontingente auf:

    Kontingente aufrufen

  2. Wählen Sie das Kontingent aus, das Sie ändern möchten:

    1. Klicken Sie in der Zeile des Kontingents, das Sie ändern möchten, auf ALLE KONTINGENTE. Klicken Sie im KONTINGENTBEREICH auf das Kästchen Global.
    2. Alternativ können Sie auf Warnung klicken, wenn dies in der Spalte Kontingentstatus angezeigt wird. Klicken Sie im KONTINGENTBEREICH auf das Kästchen neben dem Kontingent, das Sie ändern möchten.
  3. Klicken Sie auf der Hauptseite Kontingente auf KONTINGENTE BEARBEITEN.

  4. Füllen Sie das rechts angezeigte Anfrageformular aus:

    1. Geben Sie im Feld Neues Limit das erhöhte Kontingent ein, das Sie anfordern.
    2. Geben Sie in das Feld Beschreibung der Anfrage den Grund für Ihre Anfrage ein. Dabei ist es hilfreich, wenn Sie hier Informationen wie zukünftige Wachstumspläne, Regionen- oder Zonenverteilung sowie zusätzliche Anforderungen oder Abhängigkeiten angeben.
    3. Tippen Sie auf Weiter.
    4. Geben Sie im Bereich Kontaktdaten Ihre Telefonnummer in das Feld Telefon ein.
    5. Klicken Sie auf FERTIG.
  5. Klicken Sie auf Anfrage senden.

Nachdem Sie Ihre Anfrage über die Google Cloud Console gesendet haben, erhalten Sie von Google Cloud eine E-Mail, die Ihre Anfrage bestätigt. 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.

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. Wenn Sie das Kontingent begrenzen möchten, bearbeiten Sie die Limits auf der API-spezifischen Kontingentseite.

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

    Kontingente aufrufen

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

  3. Klicken Sie für die Nutzung, die Sie beschränken möchten, auf Alle Kontingente.

  4. Klicken Sie auf das Kästchen, um das Attribut auszuwählen, das Sie bearbeiten möchten.

  5. Klicken Sie auf Kontingente bearbeiten.

  6. Füllen Sie das Antragsformular aus.

  7. Geben Sie Ihr geändertes Kontingentlimit und optional eine Beschreibung ein.

  8. Klicken Sie auf FERTIG.

  9. Klicken Sie auf Anfrage senden.

Wenn Sie ein Kontingent begrenzen möchten, das nicht auf dieser Seite angezeigt wird, oder ein Limit über dem angegebenen Maximum festlegen, bearbeiten Sie die Limits wie unter Höheres Kontingent anfordern beschrieben.

Kontingente mit dem gcloud-Befehlszeilentool verwalten (Alpha)

Sie können das gcloud-Befehlszeilentool verwenden, um aktuelle Kontingente abzurufen und die Kontingentnutzung für einige Google Cloud APIs und -Dienste zu begrenzen, gegebenenfalls auch auf Projekt-, Ordner- und Organisationsebene.

Für diesen Ansatz müssen Sie zuerst die neueste Version des Cloud SDK installiert und initialisiert haben, einschließlich der Alphabefehle. Wenn Sie über Cloud Shell mit Google Cloud interagieren, wird das Cloud SDK 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 Cloud SDK-Referenz.

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 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 die Seite Monitoring auf.

    Zu Monitoring

  2. Klicken Sie im Navigationsbereich von Monitoring auf Metrics Explorer.
  3. Prüfen Sie, ob der Tab Messwert ausgewählt ist.
  4. Treffen Sie im Feld Ressourcentyp und Messwert finden Ihre Auswahl über das Menü oder geben Sie den Namen für die Ressource und den Messwert ein. Verwenden Sie die folgenden Informationen, um die Felder auszufüllen:
    1. Wählen Sie für Ressource das gewünschte Nutzerkontingent aus oder geben Sie es ein.
    2. Wählen Sie unter Messwert je nach gewünschter Art des zu überwachenden Kontingents die Option Nutzung von Zuteilungskontingenten oder Nutzung von Ratenkontingenten aus oder geben Sie sie ein.
  5. Mit den Menüs Filter, Gruppieren nach und Aggregator können Sie die Darstellung der Daten ändern. Sie können beispielsweise nach Ressourcen- oder Messwertlabels gruppieren. Weitere Informationen finden Sie unter Messwerte auswählen.

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 gcloud-Befehlszeilentool ein Kontingent überschritten haben, gibt das gcloud-Tool 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.