In Cloud Trace werden Ratenkontingente, Limits für die Aufnahme von Spans und Aufbewahrungszeiträume für Daten erzwungen, die davon abhängen, welche API Sie zum Senden von Trace-Daten an Ihr Google Cloud -Projekt verwenden: die Telemetry (OTLP) API oder die Cloud Trace API. Die Telemetry API implementiert die OpenTelemetry-OTLP-Spezifikation und bietet eine bessere Kompatibilität mit dem Open-Source-OpenTelemetry-Ökosystem.
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.
In Cloud Trace werden zwei verschiedene Arten von Kontingenten erzwungen: ein Ratenkontingent für Ihre Cloud Trace API-Anfragen und ein Erfassungskontingent für Spans, die Sie an Trace senden.
Kontingente
In der folgenden Tabelle sind die für Lese- und Schreibvorgänge verfügbaren Kontingenteinheiten sowie das tägliche Kontingent für das Erfassen von Spans für die Trace API zusammengefasst. Sie haben beispielsweise insgesamt 300 Aufrufe pro 60 Sekunden für die drei API-Befehle GetTrace, ListTraces und ListSpan. Hier zwei unterschiedliche Beispiele dafür, wie Sie alle verfügbaren Kontingenteinheiten nutzen könnten:
- 12 API-Aufrufe mit dem Befehl
ListTracespro 60 Sekunden - 10 API-Aufrufe mit dem Befehl
ListTracesund 50 API-Aufrufe mit dem BefehlGetTracepro 60 Sekunden
| Kategorie | Kontingenteinheiten insgesamt |
|---|---|
| Lesevorgänge1 | 300 pro 60 Sekunden |
| Schreibvorgänge2 | 4.800 pro 60 Sekunden |
| Aufgenommene Spannen3,4 | 3.000.000 pro Tag – 5.000.000.000 pro Tag |
1 Zu den Leseoperationen gehören GetTrace, ListTraces und ListSpan. Ein Aufruf von ListTraces verbraucht 25 Kontingenteinheiten. Aufrufe von GetTrace verbrauchen ListSpan 1 Kontingenteinheit. Wenn Sie Traces mit dem Trace Explorer in der Google Cloud Console abfragen und ansehen, wird dieses Kontingent nicht in Anspruch genommen.
2 Schreibvorgänge umfassen PatchTraces, BatchWrite und CreateSpan. Für jeden Schreibvorgang wird eine Kontingenteinheit verbraucht.
3 Dieses Kontingent gilt nur für Spans, die über die Cloud Trace API aufgenommen werden.
Die Aufnahme über die Telemetry API ist uneingeschränkt.
4 Ihr tägliches Kontingent für die Aufnahme von Trace-Spans für die Cloud Trace API richtet sich nach dem Verlauf Ihres Abrechnungskontos und den Anfragen, die Sie für Kontingenterhöhungen gestellt haben.
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 MINIMAL100 in der Ansicht COMPLETE |
| Maximale Länge eines Spannen-Namens | 1.024 Byte |
| Maximale Anzahl von Labels oder Attributen pro Bereich | 1.024 |
| Maximale Größe des Schlüssels für ein Label oder Attribut | 512 Byte |
| Maximale Größe des Werts für ein Label oder Attribut | 65.532 Byte |
| Maximale Anzahl von Ereignissen pro Zeitraum | 256 |
| Maximaler Zeitstempel in der Vergangenheit für die Aufnahme eines Spans | 14 Tage |
| Maximaler zukünftiger Zeitstempel für die Erfassung eines Spans | 3 Tage |
| Maximaler Zeitstempel in der Vergangenheit für das Ereignis relativ zum Zeitstempel des Zeitraums | 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 Bereich zugeordnet sind, 1.024 überschreitet. Stattdessen wird in diesem Szenario in der Cloud Trace API ein nicht deterministischer Algorithmus verwendet, um 1.024 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 Endpunkt batchWrite verwenden, fügen Sie dem Objekt Span Attribute hinzu. Wenn Sie den Endpunkt patchTraces verwenden, fügen Sie dem Objekt TraceSpan 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 sind. Die in diesem Abschnitt aufgeführten Limits gelten nicht für die Cloud Trace API.
| Beschreibung | Wert | Notiz |
|---|---|---|
| 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 |
1024 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*-ObjektEnthä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 |
1024 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 Trace-Aufnahmebytes pro Minute | 2,4 GB für die folgenden Regionen: 300 MB für alle anderen Regionen. |
Kontingent. |
trace.proto.
Limits für Tracebereiche
| Limits für Tracebereiche | Wert |
|---|---|
| Maximale Anzahl von Tracebereichen pro Projekt | 100 |
| Maximale Anzahl von Ansichten pro Tracebereich | 20 |
Aufbewahrungsdauer
| Kategorie | Aufbewahrungsdauer |
|---|---|
Spans, die im Bucket _Trace gespeichert sind |
30 Tage |
Kontingent verwalten
In diesem Abschnitt wird beschrieben, wie Sie eine Änderung eines Kontingents anfordern und die Kontingentnutzung überwachen.
Änderungen an Cloud Trace API-Kontingenten anfordern
Wenn Sie herausfinden möchten, ob Sie über die Google Cloud -Konsole ein höheres oder niedrigeres Cloud Trace API-Limit für das Kontingent beantragen 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. Weitere 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 quotaerhalten, wenden Sie sich an Cloud Customer Care und fordern Sie eine Änderung des Kontingents an. Die Abrechnung muss für dasGoogle Cloud Projekt aktiviert sein, damit Sie Kontingente in der Google Cloud Console bearbeiten können.
Kontingentnutzung im Blick behalten
Damit Ihnen nicht das Kontingent ausgeht und Sie die Beobachtbarkeit der Leistung Ihrer Apps nicht verlieren, sollten Sie Ihre Updates in Batches ausführen 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.
Wenn Sie Ihr Cloud Trace API-Kontingent und Ihr tägliches Kontingent für die Aufnahme von Spans aufrufen möchten, lesen Sie den Abschnitt Kontingente ansehen und verwalten.
Informationen dazu, wie Sie die API-Kontingenteinheiten und die täglichen Kontingenteinheiten für die Aufnahme von Spannen verringern können, finden Sie unter Nutzung einschränken.
Wenn Sie eine Erhöhung Ihres API-Kontingents oder Ihres täglichen Kontingents für die Aufnahme von Spannen beantragen möchten, finden Sie hier weitere Informationen.
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.
Abfragen mit hohem Volumen
Wenn Sie Ihre Tracedaten in großem Umfang abfragen möchten, erstellen Sie ein verknüpftes BigQuery-Dataset und verwenden Sie dann die BigQuery API.
Verwenden Sie die Cloud Trace API nicht für Abfragen mit hohem Volumen, da Aufrufe der Trace API ratenbeschränkt sind.