Kontingente und Limits

Damit Sie die Kapazität planen und Dienstunterbrechungen vermeiden können, wendet Cloud Logging Kontingente und Systemlimits auf API-Anfragen, Speicher und Ressourcenkonfigurationen an. Sie können für die meisten Kontingente eine Erhöhung anfordern. Systemlimits sind jedoch fest und können nicht geändert werden.

Logging-Kontingente und Nutzungslimits

In der folgenden Tabelle sind die Kontingente und Limits für die Nutzung von Cloud Logging aufgeführt. In der Regel können Sie eine Erhöhung eines Kontingents anfordern. Limits können jedoch nicht geändert werden.

Einige Einträge sind als pro Projekt aufgeführt, aber der Hinweis gibt an, dass der Eintrag auch für Rechnungskonten, Ordner und Organisationen gilt und nicht hierarchisch ist. Wenn Sie beispielsweise mehrere Google Cloud -Projekte in einer Organisation haben, können Sie für jedes Google Cloud -Projekt bis zu 200 Senken konfigurieren. Für dieselbe Organisation können Sie auch bis zu 200 Senken auf Organisationsebene konfigurieren.

Kategorie	Höchstwert des Limits oder Anfangskontingentwert	Hinweise
Größe einer LogEntry	256 KiB	Dieses Limit ist ein Näherungswert und basiert auf internen Datengrößen, nicht auf der tatsächlichen Größe der REST API-Anfrage. Kann nicht erhöht werden.
Größe eines Audit-Logeintrags	512 KiB	Kann nicht erhöht werden.
Anzahl der Label	64 pro LogEntry	Kann nicht erhöht werden.
Länge eines LogEntry-Labelschlüssels	512 B	Cloud Logging kürzt übergroße Labelschlüssel, wenn der zugehörige Logeintrag geschrieben wird. Kann nicht erhöht werden.
Länge eines LogEntry-Labelwerts	64 KiB	Cloud Logging kürzt zu große Labelwerte, wenn der zugehörige Logeintrag geschrieben wird. Kann nicht erhöht werden.
Länge einer Abfrage in der Logging-Abfragesprache	20.000 Zeichen	Kann nicht erhöht werden.
Query Fan-out	200 Buckets	Dieses Limit ist die maximale Anzahl von Buckets, die Logeinträge für eine Ressource enthalten können. Weitere Informationen finden Sie unter Abfrage gibt einen Fehler zurück. Kann nicht erhöht werden. Aus Leistungsgründen sollten Sie die Anzahl der Log-Buckets minimieren und Ihre Log-Buckets in einer Region erstellen. Wenn Sie häufig Logeinträge abfragen müssen, die aus verschiedenen Ressourcen stammen, sollten Sie Logeinträge an einige zentrale Log-Buckets weiterleiten.
Anzahl der Senken	200 pro Google Cloud -Projekt	Kann auf 4.000 erhöht werden. Dieses Kontingent gilt auch für Rechnungskonten, Ordner und Organisationen und ist nicht hierarchisch.
Länge eines Einschlussfilters für Senken	20.000 Zeichen	Kann nicht erhöht werden.
Länge eines Senken-Ausschlussfilters	20.000 Zeichen	Kann nicht erhöht werden.
Anzahl der „Ausschließen“-Filter	50 pro Senke	Kann nicht erhöht werden. Wenn Sie mehr als 50 Ausschlussfilter benötigen, verfeinern Sie den Einschlussfilter.
Anzahl der Log-Buckets	100 pro Google Cloud -Projekt	Kann auf 2.500 erhöht werden. Dieses Kontingent ist die maximale Anzahl von Buckets, die Logeinträge für eine Ressource enthalten können. Es umfasst auch Buckets, die bald gelöscht werden. Dieses Kontingent gilt auch für Rechnungskonten, Ordner und Organisationen und ist nicht hierarchisch. Wenn Sie die maximale Anzahl von Log-Buckets erhöhen, kann dies die Nutzerfreundlichkeit beeinträchtigen, da der Standard-Logbereich nicht alle Log-Buckets in einem Projekt enthalten kann.
Anzahl der benutzerdefinierten indexierten Felder	20 pro Log-Bucket	Kann nicht erhöht werden. Cloud Logging unterstützt die Volltextindexierung. Daher raten wir davon ab, eine benutzerdefinierte Indexierung zu definieren.
Anzahl der Logansichten	30 pro Log-Bucket	Kann auf 1.000 Logansichten für einen einzelnen Log-Bucket erhöht werden. Wenn Sie die maximale Anzahl von Logansichten erhöhen, kann dies die Nutzerfreundlichkeit beeinträchtigen, da der Standard-Logbereich nicht alle Logansichten in einem Projekt enthalten kann.
Ältester Zeitstempel, der in Log-Buckets gespeichert werden kann	Wird durch die Aufbewahrungsdauer des Log-Buckets bestimmt.	Bei einem benutzerdefinierten Log-Bucket mit der Standardaufbewahrungsdauer liegt dieser Wert 30 Tage in der Vergangenheit. Die Logging API akzeptiert Logeinträge mit älteren Zeitstempeln und diese Logeinträge werden an Senkenziele weitergeleitet. Wenn jedoch Logeinträge mit älteren Zeitstempeln an einen Log-Bucket weitergeleitet werden, werden sie nicht gespeichert.
Zukünftiger Zeitstempel, der in Log-Buckets gespeichert werden kann	Bis zu 1 Tag in der Zukunft	Die Logging API lehnt Einträge mit Zeitstempeln ab, die mehr als einen Tag in der Zukunft liegen, und gibt den Fehler INVALID_ARGUMENT zurück. Kann nicht erhöht werden.
Anzahl der Logbereiche pro Ressource	100	Kann auf 10.000 erhöht werden.
Anzahl der Logansichten und Projekte, die in einem Logbereich enthalten sind	100	Wir empfehlen, dass in einem Logbereich nach Möglichkeit Logansichten anstelle von Projekten aufgeführt werden. Das Auflisten von Logansichten führt zu einer kürzeren Abfragezeit und mehr Klarheit darüber, welche Logeinträge abgefragt werden.
Anzahl der Projekte, die in einem Logbereich enthalten sind	5	Wir empfehlen, dass ein Logbereich nach Möglichkeit Logansichten anstelle von Projekten auflistet. Die Logansichten können sich in verschiedenen Projekten befinden.

Kontingente und Limits der Logging API

Für die Nutzung der Logging API gelten die folgenden Limits. Sie können Änderungen an Ihren Logging API-Kontingenten und -Limits anfordern. Eine Anleitung dazu finden Sie auf dieser Seite unter Änderungen an Cloud Logging API-Kontingenten anfordern.

Wenn Sie Ihre API-Kontingente aufrufen möchten, rufen Sie das API-Dashboard auf, wählen Sie eine API aus und klicken Sie dann auf Kontingente.

Kategorie	Höchstwert des Limits oder Anfangskontingentwert	Hinweise
Lebensdauer der API-Seitentoken	24 Stunden	Kann nicht erhöht werden.
Größe einer entries.write-Anfrage	10 MB	Kann nicht erhöht werden.
Anteil der entries.write-Anfragen nach Region	4,8 GB pro Minute und Google Cloud Projekt in den Regionen asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1 300 MB pro Minute und Google Cloud Projekt in allen anderen Regionen	Sie können eine Kontingenterhöhung anfordern. Dieses Kontingent gilt auch für Rechnungskonten, Ordner und Organisationen und ist nicht hierarchisch. Weitere Informationen zu diesen Kontingenten finden Sie unter Kontingente für die Aufnahme pro Region. Die Verwendung von Ausschlussfiltern reduziert die Rate der Schreibanfragen nicht, da Logeinträge nach der entries.write-Anfrage ausgeschlossen werden.
Anzahl der entries.list-Anfragen	60 pro Minute und Google Cloud Projekt	Kann nicht erhöht werden. Dieses Limit gilt auch für Rechnungskonten, Ordner und Organisationen und ist nicht hierarchisch. Wenn Sie große Mengen an Logs abfragen möchten, sollten Sie die BigQuery APIs verwenden. Wenn Sie große Mengen an Logs übertragen möchten, sollten Sie eine Logsenke verwenden oder Logeinträge kopieren.
Anzahl der verschiedenen Ressourcennamen in einem einzelnen entries.write-Befehl	1000	Kann nicht erhöht werden. Im Feld logName eines Logeintrags wird der Ressourcenname des Logeintrags angegeben.
Steuerungsanfragen pro Minute	600	Kann nicht erhöht werden. Dieses Kontingent gilt für administrative und Konfigurations-API-Anfragen. Dazu gehören alle Anfragen im täglichen Kontrollanfragekontingent sowie Anfragen, die Logs löschen oder Ressourcen wie Log-Buckets, Logansichten, IAM-Richtlinien für Logansichten, Logbereiche und logbasierte Messwerte verwalten.
Steuerungsanfragen pro Tag	1.000 pro Google Cloud -Projekt	Kann nicht erhöht werden. Dieses Kontingent gilt für API-Anfragen zum Erstellen und Aktualisieren von Ausschlüssen und Senken.
Anzahl der Google Cloud Projekte oder anderer Ressourcennamen in einer einzelnen entries.list-Anfrage von	100	Kann nicht erhöht werden.
Rate der Exporte in Pub/Sub-Themen	60 GB/Min pro Google Cloud -Projekt, -Ordner oder -Organisation, in dem bzw. der die Senke definiert ist	Sie können eine Supportanfrage stellen, um Ihr Kontingent zu erhöhen. Ein erhöhtes Kontingent wird basierend auf der Pub/Sub-Verfügbarkeit gewährt. Wenn die Exportrate das Kontingent überschreitet, wird der Fehler in einem Logeintrag aufgezeichnet. Das Feld „Zusammenfassung“ weist auf einen Fehler bei der Senkenkonfiguration hin und der Fehlercode wird als topic_over_quota aufgeführt. Informationen zur Fehlerbehebung finden Sie unter Kontingentprobleme bei Senken.

Aufnahmekontingente pro Region

Um die Isolation zu verbessern und regionale Ressourcen vor einer Überlastung bei der Aufnahme zu schützen, wird durch Cloud Logging-Kontingente das Datenvolumen, das in eine Aufnahmeregion geschrieben wird, proGoogle Cloud -Projekt begrenzt.

In der folgenden Tabelle sind die Standardkontingente für die einzelnen Regionen aufgeführt:

Aufnahmeregion	Standardwert
asia-east1, asia-northeast1, asia-southeast1, asia-south1, europe-west1, europe-west2, europe-west3, europe-west4, us-central1, us-east4, us-west1	4, 8 GB pro Minute und Google Cloud -Projekt
Alle verbleibenden Regionen	300 MB pro Minute und Google Cloud -Projekt

Die Standardwerte für die regionalen Kontingente überschreiten die Aufnahmemengen der meisten Nutzer. Wenn das Aufnahmevolumen Ihres Projekts aus einer Region in den sechs oder mehr Monaten vor der Durchsetzung der Kontingente jedoch nahe am Standardkontingent oder darüber lag, enthält Ihr anfängliches Kontingent eine automatische, einmalige Erhöhung. Daher sind Ihre Kontingente möglicherweise höher als die Standardwerte in der vorherigen Tabelle. Informationen zum Prüfen von Kontingenten finden Sie unter Cloud Logging API-Kontingente prüfen.

Wenn Sie ein regionales Kontingent überschreiten, werden Ihre Schreibanfragen an die Cloud Logging API möglicherweise mit der Fehlermeldung „Ressource erschöpft“ abgelehnt. Empfehlungen, wie Sie das Überschreiten von Kontingenten vermeiden können, finden Sie unter Logging-Kontingente verwalten und überwachen.

Cloud Logging API-Kontingente prüfen

So prüfen Sie Ihre Cloud Logging API-Kontingente:

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

   Rufen Sie Kontingente und Systemlimits auf.

   Wenn Sie diese Seite über die Suchleiste suchen, wählen Sie das Ergebnis aus, dessen Zwischenüberschrift IAM & Admin lautet.

2. Filtern Sie die Liste der Kontingente für den Cloud Logging API-Dienst.

Änderungen an Cloud Logging API-Kontingenten anfordern

Wenn Sie wissen möchten, ob Sie über die Google Cloud Console ein höheres oder niedrigeres Logging API-Limit für ein Kontingent anfordern können, rufen Sie die Seite Kontingente und Systemlimits auf und suchen Sie nach dem gewünschten Kontingent.

• Wenn das Kontingent aufgeführt ist, können Sie auf dieser Seite eine Änderung des Limits beantragen. Informationen zu diesen Schritten finden Sie unter Kontingente aufrufen und verwalten.

• Wenn das Kontingent nicht aufgeführt ist oder Sie eine Kontingentaktualisierung anfordern und den Fehler Edit is not allowed for this quota erhalten, wenden Sie sich an den Support und fordern Sie eine Änderung des Kontingents an. Die Abrechnung muss für das Projekt vonGoogle Cloud aktiviert sein, damit Kontingente in der Google Cloud Console bearbeitet werden können.

Cloud Logging API-Kontingente verwalten und überwachen

So können Sie Dienstunterbrechungen aufgrund von Kontingentüberschreitungen vermeiden:

• Mit der automatischen Kontingentanpassung können Sie Ihre Kontingentnutzung überwachen und Erhöhungen anfordern. Weitere Informationen finden Sie unter Kontingentanpassung.
• Erstellen Sie Benachrichtigungen zu Kontingenten, um über die Nutzung informiert zu werden. Weitere Informationen finden Sie unter Kontingentbenachrichtigungen einrichten.

Nutzung von entries.list optimieren

entries.list wird voraussichtlich verwendet, um nach übereinstimmenden Logs zu suchen. Diese Methode ist nicht für das Abrufen großer Mengen von Logeinträgen vorgesehen. Wenn Sie Ihr entries.list-Kontingent regelmäßig ausschöpfen, sollten Sie die folgenden Optionen in Betracht ziehen:

• Achten Sie darauf, dass Sie die Cloud Logging API effektiv nutzen. Weitere Informationen finden Sie unter API-Nutzung optimieren.

• Wenn Sie im Voraus wissen, dass die zu analysierenden Logeinträge das entries.list-Kontingent überschreiten, konfigurieren Sie eine Logsenke, um Ihre Logs an ein unterstütztes Ziel zu exportieren.

Audit-Logging

Die maximalen Größen von Audit-Logs sind in der folgenden Tabelle aufgeführt. Anhand dieser Werte können Sie den Speicherplatz schätzen, den Sie in Ihren Senkenzielen benötigen.

Audit-Logtyp	Maximalgröße
Admin Activity	512 KiB
Datenzugriff	512 KiB
Systemereignis	512 KiB
Richtlinie abgelehnt	512 KiB

Aufbewahrungsdauer für Logs

Die folgenden Cloud Logging-Aufbewahrungsdauern gelten für Log-Buckets, unabhängig davon, welche Logtypen im Bucket enthalten sind oder ob sie von einem anderen Speicherort kopiert wurden:

Bucket	Ressourcen	Standardmäßige Aufbewahrungsdauer	Benutzerdefinierte Aufbewahrung
_Required	Projekt, Ordner, Organisation	400 Tage	Nicht konfigurierbar
_Default	Ordner, Organisation	30 Tage	Nicht konfigurierbar
_Default	Projekt	30 Tage	Konfigurierbar
Benutzerdefiniert	Projekt	30 Tage	Konfigurierbar

Für _Default und benutzerdefinierte Log-Buckets in Projekten können Sie Cloud Logging so konfigurieren, dass Ihre Logs zwischen 1 Tag undaufbewahrt werden. Informationen zum Festlegen von Aufbewahrungsregeln finden Sie unter Benutzerdefinierte Aufbewahrung konfigurieren.

Wenn Sie Logeinträge aus einem Ordner oder einer Organisation länger als 30 Tage speichern möchten, erstellen Sie eine Logsenke und leiten Sie diese Logeinträge an einen Log-Bucket in einem Projekt weiter.