Cloud Trace erzwingt Ratenkontingente, Limits für die Span-Aufnahme und Datenaufbewahrungszeiträume, die davon abhängen, ob Sie Trace-Daten über die Telemetry (OTLP) API oder die Cloud Trace API senden. Wenn Sie diese Grenzwerte kennen, können Sie Ihre Nutzung im Blick behalten, damit Sie die Beobachtbarkeit Ihrer Anwendungen nicht verlieren.
Trace API-Kontingente und -Limits
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 verschiedene Arten von Kontingenten: ein Ratenkontingent für Ihre Cloud Trace API-Anfragen und ein Aufnahmekontingent 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 die Aufnahme von Spans für die Trace API zusammengefasst. Beispiel: Sie haben 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 Spans3,4 | 3.000.000 pro Tag – 5.000.000.000 pro Tag |
1 Lesevorgänge umfassen GetTrace, ListTraces, ListSpan. Ein Aufruf von ListTraces verbraucht 25 Kontingenteinheiten. Aufrufe von GetTrace verbrauchen ListSpan Kontingenteinheit. Das Abfragen und Aufrufen von Traces mit dem Trace Explorer in der Google Cloud Console verbraucht dieses Kontingent nicht.
2 Zu den Schreibvorgängen gehören PatchTraces, BatchWrite und CreateSpan. Jeder Schreibvorgang verbraucht 1 Kontingenteinheit.
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 wird durch den Verlauf Ihres Rechnungskontos und Ihre Anfragen zur Kontingenterhöhung bestimmt.
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 Span-Namens | 1.024 Byte |
| Maximale Anzahl von Labels oder Attributen pro Span | 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 Span | 256 |
| Maximaler Zeitstempel in der Vergangenheit für die Aufnahme eines Spans | 14 Tage |
| Maximaler zukünftiger Zeitstempel für die Aufnahme eines Span | 3 Tage |
| Maximaler vergangener Zeitstempel 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. Beispielsweise wird kein Fehler gemeldet, wenn die Anzahl der an einen Span angehängten Attribute 1.024 überschreitet. Stattdessen verwendet die Cloud Trace API in diesem Szenario einen nicht deterministischen Algorithmus, um 1.024 Attribute für die Aufnahme auszuwählen. Die verbleibenden Attribute werden verworfen.
Die Cloud Trace API bietet 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 Aufnehmen von Trace-Daten 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 |
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*-ObjektUmfasst 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 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 Trace-Bereichen pro Projekt | 100 |
| Maximale Anzahl von Ansichten pro Trace-Bereich | 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 können.
Änderungen an Cloud Trace API-Kontingenten anfordern
Wenn Sie wissen möchten, ob Sie über die Google Cloud Console ein höheres oder niedrigeres Cloud Trace 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 anfordern. 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 das Projekt inGoogle Cloud aktiviert sein, damit Kontingente in der Google Cloud Console bearbeitet werden können.
Kontingentnutzung überwachen
Damit Ihr Kontingent nicht erschöpft wird und Sie die Beobachtbarkeit der Leistung Ihrer Anwendungen nicht verlieren, sollten Sie Ihre Updates im Batchmodus ausführen und die 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 der Cloud Trace API und der täglichen Kontingente für die Span-Aufnahme finden Sie unter Kontingente ansehen und verwalten.
Informationen zum Verringern der API-Kontingenteinheiten und der täglichen Kontingenteinheiten für die Span-Aufnahme finden Sie unter Nutzung einschränken.
Wenn Sie eine Erhöhung Ihrer API-Kontingenteinheiten oder Ihrer täglichen Kontingente für die Span-Aufnahme beantragen möchten, lesen Sie den Abschnitt Höheres Kontingent anfordern.
Ausführliche Informationen zum Erstellen von Benachrichtigungsrichtlinien zum Überwachen Ihres Trace API-Kontingents und der Aufnahmerate von Trace-Spans finden Sie unter Kontingentbenachrichtigung erstellen.
Abfragen mit hohem Volumen
Wenn Sie große Mengen an Trace-Daten 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 die Anzahl der Aufrufe der Trace API begrenzt ist.