Mit Kontingenten arbeiten

Für Projektinhaber gelten auf der Google Cloud Platform (GCP) Kontingente bezüglich der Ressourcennutzung. Sie stehen für ein hartes Limit in Bezug auf die Menge einer bestimmten GCP-Ressource, auf die ein Projekt zurückgreifen kann. Es gibt zwei Arten von Kontingenten, die die Ressourcennutzung beschränken:

  • Ratenkontingente wie API-Anfragen pro Tag. Diese Art von Kontingent wird nach einer bestimmten Zeit zurückgesetzt, z. B. nach einer Minute oder einem Tag.
  • Zuteilungskontingente wie die Anzahl der vom Projekt genutzten virtuellen Maschinen oder der Load-Balancer. Diese Art von Kontingent wird nicht nach Ablauf einer bestimmten Zeit zurückgesetzt, sondern muss explizit freigegeben werden, wenn Sie die Ressource nicht mehr nutzen möchten. Dies geschieht beispielsweise durch Löschen eines GKE-Clusters.

Kontingente gibt es aus verschiedenen Gründen. Unter anderem schützen sie die Nutzer der GCP-Community vor unvorhergesehenen Auslastungsspitzen. Die Kontingente helfen Ihnen auch bei der Ressourcenverwaltung: Sie können z. B. beim Entwickeln und Testen Ihrer Anwendungen innerhalb des von Google bereitgestellten Kontingents eigene Obergrenzen für die Nutzung von Diensten festlegen. Jedes Kontingentlimit wird in Form einer bestimmten zählbaren Ressource ausgedrückt. Diese reichen von Anfragen an eine API pro Tag bis zur Anzahl an Load-Balancern, die von der Anwendung genutzt werden.

Nicht alle Projekte haben für dieselben Dienste die gleichen Kontingente. Wenn Sie beispielsweise ein kostenloses Testkonto nutzen, um die Plattform kennenzulernen, ist das Kontingent möglicherweise stark begrenzt. Höhere Kontingente sind für einige Dienste erst verfügbar, nachdem Sie für Ihr Projekt die Abrechnung aktiviert haben. Wenn Sie die Google Cloud Platform mit der Zeit stärker nutzen, können sich Ihre Kontingente entsprechend erhöhen. Sie können gegebenenfalls auch mehr Kontingente anfordern. Außerdem können Sie Monitoringfunktionen und Benachrichtigungen in Stackdriver einrichten, um über ungewöhnliches Verhalten bei der Verwendung von Kontingenten oder bevorstehende Kontingentüberschreitungen informiert zu werden.

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

Kontingente aufrufen

Es gibt zwei Möglichkeiten, Ihre aktuellen Kontingentlimits in der Google Cloud Console aufzurufen:

  • Auf der Seite Kontingente finden Sie eine Liste mit der Kontingentnutzung und den Kontingentlimits aller Ihrer Projekte.

  • In der Console finden Sie Kontingentinformationen zu einer bestimmten API, z. B. zur Ressourcennutzung in einem bestimmten Zeitraum.

Darüber hinaus bieten einige Dienste über ein Befehlszeilentool Zugriff auf Informationen zu Kontingenten und zur Ressourcennutzung. In Compute Engine können Sie beispielsweise mithilfe von gcloud compute auf Kontingentinformationen zugreifen.

Informationen zum Überwachen Ihrer Kontingentnutzung finden Sie weiter unten im Abschnitt Kontingentnutzung überwachen.

Alle Projektkontingente anzeigen

Führen Sie die folgenden Schritte aus, um sich die Kontingente (Kontingentnutzung und Kontingentlimits) für alle Ressourcen in Ihrem Projekt anzeigen zu lassen:

  1. Öffnen Sie in der GCP Console die Seite "Kontingente" unter "IAM & Verwaltung".
  2. Wählen Sie aus der Projektliste ein Projekt aus oder erstellen Sie ein neues. Die Seite "Kontingente" für das ausgewählte Projekt wird angezeigt. Jeder Kontingenttyp, der in den einzelnen Diensten verfügbar ist, wird in einer eigenen Zeile aufgeführt.
  3. Optional: Sortieren und filtern Sie die Ergebnisse, um die benötigten Informationen zu finden:

    • Ordnen Sie die Liste mithilfe der Filter am oberen Seitenrand nach Kontingenttyp, Dienst, Messwert und/oder Zone neu an.
    • 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 auch das am wenigsten verwendete Kontingent zuerst anzeigen lassen. Wählen Sie hierfür den Pfeil Spitzenzeiten in den letzten 7 Tagen aus.

In der Liste sehen Sie auch die aktuelle Nutzung eines bestimmten Kontingents. Bei Zuteilungskontingenten entspricht die aktuelle Nutzung einfach der Menge an Ressourcen, die Sie aktuell nutzen. Bei Ratenkontingenten pro Tag wird die bisherige Nutzung des aktuellen Tages angezeigt. Bei Ratenkontingenten pro Minute oder 100 Sekunden wird die durchschnittliche Nutzung in den letzten 24 Stunden angezeigt.

Weitere Informationen zu Kontingenten für einen bestimmten Dienst und zu deren Bedeutung finden Sie in der jeweiligen Dokumentation: Die Kontingente zu Compute Engine sind beispielsweise unter Ressourcenkontingente dokumentiert.

API-spezifische Kontingente

Weitere Informationen zu Kontingenten für eine bestimmte API, einschließlich der Nutzung im Verlauf der Zeit, finden Sie in der Konsole auf der Kontingentseite der 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.

Führen Sie folgende Schritte aus, um sich die aktuellen Limits für eine bestimmte API anzeigen zu lassen:

  1. Rufen Sie die Dashboard-Seite "APIs & Dienste" der GCP Console auf.
  2. Wählen Sie aus der Projektliste ein Projekt aus oder erstellen Sie ein neues.
  3. Klicken Sie auf den Namen der jeweiligen API.
  4. Klicken Sie auf Kontingente. Die Kontingentnamen und die zugehörigen Limits für die ausgewählte API werden auf der Seite "Kontingente" angezeigt. Standardmäßig entsprechen diese Limits den von Google vorgegebenen Limits: Informationen dazu, wie Sie ein niedrigeres Limit festlegen können, finden Sie unter Nutzung einschränken. Wenn für ein bestimmtes Kontingent kein von Google festgelegtes Limit besteht, wird das Limit als unbegrenzt angezeigt.

Nicht alle Kontingente werden auf einer API-spezifischen Kontingentseite angezeigt. Für Anfragen an die Compute Engine API gibt es beispielsweise eine API-spezifische Kontingentseite, auf der jedoch die Nutzung der Compute-Ressourcen von Compute Engine (Zuteilungskontingent) nicht angezeigt wird. Wenn Sie einen Dienst an mehreren Standorten nutzen, werden auf der API-spezifischen Kontingentseite keine regionalen und zonalen Kontingentlimits und deren entsprechende Nutzung angezeigt. Eine vollständige Liste der Kontingente Ihres Projekts finden Sie auf der Projektseite Kontingente. Dort können Sie auch nach Zonen filtern.

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

Höheres Kontingent anfordern

Für die meisten abrechenbaren Dienste mit einem Kontingentlimit können Sie so vorgehen, um eine Kontingentänderung anzufordern:

  1. Verwenden Sie die Kästchen auf der Kontingentseite, um ein oder mehrere Kontingente auszuwählen. Klicken Sie dann auf KONTINGENTE BEARBEITEN. Die Abrechnung muss für das Projekt aktiviert sein, damit die Kästchen angeklickt werden können.
  2. Füllen Sie rechts im Feld "Kontingente bearbeiten" das Formular mit Ihrem Namen, Ihrer E-Mail-Adresse und Ihrer Telefonnummer aus und klicken Sie dann auf Weiter.
  3. Wählen Sie im Feld "Kontingente bearbeiten" den Dienst aus, um die Ansicht zu maximieren, und bearbeiten Sie die Kontingente für diesen Dienst, indem Sie die gewünschten Limits eingeben. Klicken Sie auf Fertig.
  4. Wiederholen Sie diese Schritte, um die Kontingente in jedem der ausgewählten Dienste zu bearbeiten.
    • Ein Dienst mit einem Warnsymbol (error) wurde noch nicht bearbeitet oder ein Feld wurde nicht ausgefüllt.
    • Wenn Sie weitere Kontingente bearbeiten möchten, wählen Sie diese aus der Liste auf der linken Seite aus.
    • Durch Klicken auf das Löschsymbol (delete) können Sie einen Dienst aus dem Feld "Kontingente bearbeiten" entfernen.
  5. Klicken Sie auf Anfrage senden, wenn Sie mit dem Bearbeiten der Kontingente fertig sind.

Anfragen zu GCP-Kontingenten werden normalerweise innerhalb von 2 Werktagen bearbeitet. Sie sollten vom GCP-Support eine E-Mail-Bestätigung für Ihre Anfrage erhalten. Sollten Sie weitere Hilfe benötigen, können Sie auf diese E-Mail antworten. Beachten Sie, dass die Genehmigung großer Kontingenterhöhungen länger dauern kann.

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 festlegen. Die einfachste Möglichkeit, das Kontingent zu begrenzen, besteht darin, die Limits auf der API-spezifischen Kontingentseite zu bearbeiten.

  1. Öffnen Sie die API-spezifische Kontingentseite für die API, deren Nutzung Sie begrenzen möchten.
  2. Klicken Sie in der Zeile des Kontingents, das Sie ändern möchten, auf das Bearbeitungssymbol (edit) und geben Sie dann das gewünschte Gesamtkontingent bis zu dem von Google festgelegten Limit ein.
  3. Klicken Sie auf Speichern, um die Änderungen zu speichern.

Wenn Sie ein Kontingent, das auf dieser Seite nicht angezeigt wird (z. B. VMs), begrenzen oder ein Limit erhöhen möchten, müssen Sie die Limits gemäß der unter Höheres Kontingent anfordern beschriebenen Vorgehensweise über "Kontingent bearbeiten" ändern.

Kontingentmesswerte überwachen (Beta)

Neben der Anzeige grundlegender Kontingentinformationen in der Google Cloud Console können Sie in der GCP die API und die Benutzeroberfläche von Stackdriver verwenden, um Kontingentnutzung und -fehler im Detail zu überwachen. Dabei werden Kontingentmesswerte im Messwert-Explorer dargestellt. Mit diesen Messwerten können Sie benutzerdefinierte Dashboards und Benachrichtigungen einrichten, um die Kontingentnutzung in einem bestimmten Zeitraum zu überwachen und über Ereignisse informiert zu werden, z. B. wenn ein Kontingentlimit erreicht wird.

Stackdriver 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. Sie können z. B. einen Messwert zum Erfassen der Nutzung von Zuteilungskontingenten mit einem quota_metrics-Filter für Cloud TPUs kombinieren.

Zum Messwert-Explorer

Wenn Sie sich Kontingentmesswerte im Messwert-Explorer ansehen möchten, müssen Sie als Ressourcentyp Nutzerkontingent auswählen. Dann wählen Sie Nutzung von Zuteilungskontingenten oder Nutzung von Ratenkontingenten aus, um die Nutzung der entsprechenden Kontingente zu überwachen. Anschließend können Sie die optionalen Filter- und Aggregationsoptionen verwenden, um die angezeigten Daten weiter einzugrenzen. Wenn Sie die gewünschten Informationen zur Kontingentnutzung zusammengestellt haben, können Sie mit Stackdriver benutzerdefinierte Dashboards und Benachrichtigungen erstellen und eine Anwendung so fortlaufend überwachen und warten, was zu ihrer Stabilität beiträgt. Auf ähnliche Weise können Sie Fehler aufgrund von Kontingentüberschreitungen einsehen. Zuerst wählen Sie als Ressourcentyp Nutzerkontingent und dann Kontingent überschritten aus. Auf den folgenden Seiten erhalten Sie Informationen zur Vorgehensweise:

Eine detaillierte Referenz zu Kontingentmesswerten finden Sie in der Stackdriver Monitoring-Dokumentation.

Kontingentmesswerte werden nicht von allen Diensten unterstützt. Dienste, die diese Messwerte nicht unterstützen, werden in Stackdriver nicht unter "Nutzerkontingent" aufgeführt.

Kontingentfehler

Wenn Ihr Projekt bei der Nutzung eines Dienstes ein bestimmtes Kontingent überschreitet, gibt die Plattform einen Fehler zurück.

Im Allgemeinen gibt die GCP den HTTP-Fehlercode 429 zurück, wenn Sie für den Zugriff auf den Dienst HTTP/REST verwenden, oder ResourceExhausted, wenn Sie gRPC verwenden. Wie Ihnen dieser Fehler angezeigt wird, hängt vom jeweiligen Dienst ab.

Bei Verwendung von Stackdriver können Sie das mit dem Fehler verknüpfte Kontingent ermitteln und benutzerdefinierte Benachrichtigungen für Kontingentfehler erstellen, wie in Kontingentmesswerte überwachen beschrieben. Der Kontingentfehler-Messwert kann in benutzerdefinierten Stackdriver-Dashboards erst ausgewählt werden, wenn Kontingentüberschreitungen für ein Projekt vorliegen.

Hat Ihnen diese Seite weitergeholfen? Teilen Sie uns Ihr Feedback mit:

Feedback geben zu...