Kontingente und Limits

Wenn Sie Trace-Daten an Ihr Google Cloud -Projekt senden möchten, können Sie die Telemetry (OTLP) API oder die Cloud Trace API verwenden. Die Telemetry API implementiert die OpenTelemetry OTLP API und bietet eine bessere Kompatibilität und Unterstützung für die Open-Source-OpenTelemetry-Umgebung. Die Trace API ist eine proprietäre Google Cloud API, die vor der Unterstützung der Telemetry API eingeführt wurde. Die Limits für die Telemetry API sind oft großzügiger als für die Trace API.

Kontingente und Limits der Trace API

In diesem Abschnitt finden Sie Informationen zu Kontingenten und Limits, die nur für die Trace API gelten. Die in diesem Abschnitt aufgeführten Kontingente und Limits gelten nicht für die Telemetry API.

Cloud Trace erzwingt zwei Arten von Kontingenten: ein Ratenkontingent für Ihre Cloud Trace API-Anfragen und ein Datenaufnahmekontingent für die Spans, die Sie an Trace senden.

Kontingente

In der folgenden Tabelle sind die Kontingenteinheiten für Lese- und Schreibvorgänge sowie das tägliche Kontingent für die Aufnahme von Spans für die Trace API zusammengefasst. Sie haben beispielsweise für die drei API-Befehle GetTrace, ListTraces und ListSpan insgesamt 300 Kontingenteinheiten pro 60 Sekunden. Hier zwei unterschiedliche Beispiele dafür, wie Sie alle verfügbaren Kontingenteinheiten nutzen könnten:

12 API-Aufrufe mit dem Befehl ListTraces pro 60 Sekunden
10 API-Aufrufe mit dem Befehl ListTraces und 50 API-Aufrufe mit dem Befehl GetTrace pro 60 Sekunden

Kategorie	Kontingenteinheiten insgesamt
Lesevorgänge¹	300 pro 60 Sekunden
Schreibvorgänge²	4.800 pro 60 Sekunden
Aufgenommene Spans^3,4	3.000.000 pro Tag – 5.000.000.000 pro Tag

¹ Zu den Leseoperationen gehören GetTrace, ListTraces und ListSpan. Ein Aufruf von ListTraces verbraucht 25 Kontingenteinheiten. Aufrufe von GetTrace verbrauchen ListSpan 1 Kontingenteinheit.
² Schreibvorgänge umfassen PatchTraces, BatchWrite und CreateSpan. Jeder Schreibvorgang verbraucht 1 Kontingenteinheit.
³ Dieses Kontingent gilt nur für Spans, die über die Cloud Trace API erfasst werden. Die Aufnahme über die Telemetry API ist uneingeschränkt. ⁴ Ihr Tageskontingent für die Aufnahme von Trace-Spans für die Cloud Trace API ergibt sich aus Ihrem Rechnungskontoverlauf und den von Ihnen beantragten Kontingenterhöhungen.

Limits

In dieser Tabelle sind die Limits für die Cloud Trace API aufgeführt.

Beschreibung	Wert
Maximale Anzahl Spans pro Aufruf mit dem Befehl `GetTrace`	10.000
Maximale Anzahl Spans pro Aufruf mit dem Befehl `PatchTraces`	25.000
Maximale Anzahl Traces pro Aufruf mit dem Befehl `ListTraces`	1.000 in den Ansichten `ROOTSPAN` und `MINIMAL` 100 in der Ansicht `COMPLETE`
Maximale Länge eines Spannen-Namens	128 Byte
Maximale Anzahl von Labels oder Attributen pro Span	32
Maximale Größe des Schlüssels für ein Label oder Attribut	128 Byte
Maximale Größe des Werts für ein Label oder Attribut	256 Byte
Maximale Anzahl von Ereignissen pro Span	128
Maximaler Zeitstempel in der Vergangenheit für die Aufnahme eines Spans	14 Tage
Maximaler zukünftiger Zeitstempel für die Aufnahme eines Spans	3 Tage
Maximaler Zeitstempel in der Vergangenheit für Ereignis relativ zum Zeitstempel des Spans	365 Tage

Das Überschreiten eines Limits führt möglicherweise nicht dazu, dass ein API-Aufruf mit einem Fehler fehlschlägt. Ein Fehler wird beispielsweise nicht gemeldet, wenn die Anzahl der Attribute, die einem Span zugeordnet sind, 32 überschreitet. Stattdessen verwendet die Cloud Trace API in diesem Szenario einen nicht deterministischen Algorithmus, um 32 Attribute für die Aufnahme auszuwählen. Die verbleibenden Attribute werden verworfen.

Die Cloud Trace API enthält Details zu den Endpunkten GetTrace, PatchTraces und ListTraces.

Wie Sie Spans annotieren, hängt vom Cloud Trace API-Endpunkt ab. Wenn Sie den batchWrite-Endpunkt verwenden, fügen Sie dem Span-Objekt Attribute hinzu. Wenn Sie den patchTraces-Endpunkt verwenden, fügen Sie dem TraceSpan-Objekt Labels hinzu.

Limits und Kontingente der Telemetry API

In diesem Abschnitt werden die Limits aufgeführt, die nur gelten, wenn die Telemetry API zum Erfassen von Tracedaten verwendet wird. Die Telemetry API, die die OpenTelemetry OTLP API implementiert, ist für die Verwendung mit Anwendungen konzipiert, die mit einem der OpenTelemetry SDKs instrumentiert werden. Die in diesem Abschnitt aufgeführten Limits gelten nicht für die Cloud Trace API.

Beschreibung	Wert	Hinweis
Maximale Größe von Attributschlüsseln	512 Byte	Limit.
Maximale Größe von Attributwerten	64 KiB	Limit.
Maximale Größe des Namens eines `Span`^*-Objekts	1.024 Byte	Limit.
Maximale Anzahl von Attributen, die an ein `Span`^*-Objekt angehängt werden können	1.024	Limit.
Maximale Anzahl von Ressourcenattributen pro `ResourceSpans`^*-Objekt	1.024	Limit.
Maximale Anzahl von Attributen pro `ResourceSpan`^*-Objekt Enthält Attribute, die an untergeordnete Objekte der folgenden Typen angehängt sind: `Resource`, `Span`, `ScopeSpans`, `Event` und `Link.`	8.192	Limit.
Maximale Anzahl von `Event`^-Objekten pro `Span`^-Objekt	256	Limit.
Maximale Anzahl von `Link`^-Objekten pro `Span`^-Objekt	128	Limit.
Maximale Größe des Namens eines `Event`^*-Objekts	1.024 Byte	Limit.
Maximale Anzahl von Attributen pro `Event`^*-Objekt	1.024	Limit.
Maximale Anzahl von Attributen pro `Link`^*-Objekt	1.024	Limit.
Maximale Größe von Schema-URLs	8.192 Byte	Limit.
Maximale Anzahl von Bytes für die Aufnahme von Traces pro Minute	2,4 GB für die folgenden 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 für alle anderen Regionen.	Kontingent.

^* Eine Definition dieser Struktur finden Sie in der Datei trace.proto.

Limits für Tracebereiche

Limits für Tracebereiche	Wert
Maximale Anzahl von Trace-Bereichen pro Projekt	100
Maximale Anzahl von Ansichten pro Trace-Bereich	20

Aufbewahrungsdauer

Kategorie	Aufbewahrungsdauer
Von Cloud Trace gespeicherte Spandaten	30 Tage
`_Trace`-Bucket	30 Tage

Kontingent verwalten

In diesem Abschnitt wird beschrieben, wie Sie eine Änderung eines Kontingents anfordern und wie Sie die Kontingentnutzung überwachen.

Änderungen am Cloud Trace API-Kontingent anfordern

In derGoogle Cloud console können Sie höhere oder niedrigere Cloud Trace API-Limits anfordern. Weitere Informationen finden Sie unter Kontingente aufrufen und verwalten.

Wenn die Fehlermeldung Edit is not allowed for this quota ausgegeben wird, können Sie den Support kontaktieren, um Änderungen am Kontingent anzufordern. Beachten Sie auch, dass die Abrechnung für dasGoogle Cloud -Projekt aktiviert sein muss, damit die Kästchen angeklickt werden können.

Kontingentnutzung im Blick behalten

Damit Sie Ihr Kontingent nicht überschreiten und den Überblick über die Leistung Ihrer Apps behalten, sollten Sie Ihre Updates in Batches zusammenfassen und Ihre Kontingentnutzung im Blick behalten. Sie können beispielsweise eine Benachrichtigungsrichtlinie erstellen, die Sie benachrichtigt, wenn Ihre Nutzung einen Grenzwert überschreitet. Detaillierte Informationen zum Überwachen Ihrer API-Anfragen sowie zu den Antworten darauf finden Sie unter API-Nutzung verfolgen.

Informationen zum Aufrufen des Kontingents für die Cloud Trace API und Ihres täglichen Kontingents für die Span-Aufnahme finden Sie unter Kontingente ansehen und verwalten.
Unter Nutzung einschränken erfahren Sie, wie Sie Ihre API-Kontingenteinheiten und täglichen Kontingenteinheiten für die Span-Aufnahme verringern.
Unter Höheres Kontingent anfordern finden Sie Informationen zum Anfordern einer Erhöhung Ihrer API-Kontingenteinheiten und der täglichen Kontingente für die Span-Aufnahme.
Unter Benachrichtigungen zur Kontingentüberschreitung erstellen erhalten Sie genaue Informationen zum Erstellen von Benachrichtigungsrichtlinien, mit denen Sie Ihr Trace API-Kontingent und Ihre Rate für die Span-Aufnahme in Trace verfolgen können.

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