Wenn Sie Tracedaten 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 das OpenTelemetry-Ökosystem. Die Trace API ist eine proprietäre Google Cloud API, die vor der Unterstützung der Telemetry API entwickelt 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
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 und
ListSpan. Ein Aufruf von ListTraces verbraucht 25 Kontingenteinheiten. Aufrufe von GetTrace und ListSpan verbrauchen jeweils 1 Kontingenteinheit.
2 Schreibvorgänge umfassen PatchTraces, BatchWrite,
und CreateSpan. Jeder Schreibvorgang verbraucht 1 Kontingenteinheit.
3 Dieses Kontingent gilt nur für Spans, die mit der Cloud Trace API aufgenommen wurden.
Die Aufnahme über die Telemetry API ist unbegrenzt.
4 Ihr tägliches Kontingent für die Aufnahme von Trace-Spans für die Cloud Trace API wird durch Ihren Rechnungskontoverlauf und Anfragen bestimmt, 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 ROOTSPAN und MINIMAL Ansichten100 in der COMPLETE Ansicht |
| Maximale Länge eines Spannamens | 1.024 Byte |
| Maximale Anzahl Labels oder Attribute 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 Ereignisse pro Span | 256 |
| Maximaler Zeitstempel in der Vergangenheit für die Aufnahme eines Spans | 14 Tage |
| Maximaler Zeitstempel in der Zukunft für die Aufnahme eines Spans | 3 Tage |
| Maximaler Zeitstempel in der Vergangenheit für ein Ereignis relativ zum Zeitstempel des Spans | 365 Tage |
Wenn ein Limit überschritten wird, führt dies 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 angehängt sind, 1.024 übersteigt. Stattdessen verwendet die Cloud Trace API in diesem Fall einen nicht deterministischen Algorithmus, um 1.024 Attribute für die Aufnahme auszuwählen. Die restlichen Attribute werden verworfen.
Die Cloud Trace API enthält Details zu den
GetTrace, PatchTraces und
ListTraces Endpunkten.
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 sind die Limits aufgeführt, die nur gelten, wenn die Telemetry API zum Aufnehmen 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 der OpenTelemetry SDKs instrumentiert wurden. Die in diesem Abschnitt aufgeführten Limits gelten nicht für die Cloud Trace API.
| Beschreibung | Wert | Community-Anmerkung |
|---|---|---|
| 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 Attribute, die einem Span*-Objekt angehängt sind |
1.024 | Limit. |
Maximale Anzahl Ressourcenattribute pro ResourceSpans*-Objekt |
1.024 | Limit. |
Maximale Anzahl Attribute 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 Event*-Objekte pro Span*-Objekt |
256 | Limit. |
Maximale Anzahl Link*-Objekte pro Span*-Objekt |
128 | Limit. |
Maximale Größe des Namens eines Event*-Objekts |
1.024 Byte | Limit. |
Maximale Anzahl Attribute pro Event*-Objekt |
1.024 | Limit. |
Maximale Anzahl Attribute pro Link*-Objekt |
1.024 | Limit. |
| Maximale Größe von Schema-URLs | 8.192 Byte | Limit. |
| Maximale Anzahl Byte für die Trace-Aufnahme pro Minute | 2,4 GB für die folgenden Regionen: 300 MB für alle anderen Regionen. |
Kontingent. |
trace.proto Datei.
Limits für Tracebereiche
| Limits für Tracebereiche | Wert |
|---|---|
| Maximale Anzahl Tracebereiche pro Projekt | 100 |
| Maximale Anzahl Ansichten pro Tracebereich | 20 |
Aufbewahrungsdauer
| Kategorie | Aufbewahrungsdauer |
|---|---|
Spans, die im
_Trace Bucket gespeichert sind |
30 Tage |
Kontingent verwalten
In diesem Abschnitt wird beschrieben, wie Sie eine Änderung an einem Kontingent anfordern und wie Sie Ihre Kontingentnutzung überwachen.
Änderungen am Cloud Trace API-Kontingent anfordern
In der Konsole können Sie höhere oder niedrigere Cloud Trace API-Limits anfordern. Google Cloud 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 an
dem Kontingent anzufordern. Beachten Sie auch, dass die Abrechnung für das
Google Cloud Projekt aktiviert sein muss, damit die Kästchen angeklickt werden können.
Kontingentnutzung im Blick behalten
Damit Sie Ihr Kontingent nicht überschreiten und die Beobachtbarkeit der Leistung Ihrer Anwendungen nicht verlieren, 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 bestimmten Schwellenwert überschreitet. Detaillierte Informationen zum Überwachen Ihrer API-Anfragen sowie zu den Antworten darauf finden Sie unter API-Nutzung verfolgen.
Unter Kontingente aufrufen und verwalten erfahren Sie, wie Sie das Kontingent für die Cloud Trace API und Ihr tägliches Kontingent für die Span Aufnahme einsehen können.
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 erfahren Sie, wie Sie eine Erhöhung Ihrer API-Kontingent einheiten und der täglichen Kontingente für die Span-Aufnahme anfordern.
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.