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 Open-Source-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 Schreib
vorgä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
ListTracesAPI-Aufrufe und 50GetTraceAPI-Aufrufe pro 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 verbrauchen ListSpan 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 Abrechnungskontoverlauf 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 von Spans pro GetTrace-Aufruf |
10.000 |
Maximale Anzahl von Spans pro PatchTraces-Aufruf |
25.000 |
Maximale Anzahl von Traces pro ListTraces-Aufruf |
1.000 in den ROOTSPAN und MINIMAL Ansichten100 in der COMPLETE Ansicht |
| Maximale Länge eines Spannamens | 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 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 , 32 überschreitet. Stattdessen verwendet die Cloud Trace API in diesem Fall einen nicht deterministischen Algorithmus, um 32 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 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 |
|---|---|
| Maximale Größe von Attributschlüsseln | 512 Byte |
| Maximale Größe von Attributwerten | 64 KiB |
Maximale Größe des Namens eines Span*-Objekts |
1.024 Byte |
Maximale Anzahl von Attributen, die einem Span*-Objekt angehängt sind |
1.024 |
Maximale Anzahl von Ressourcenattributen pro ResourceSpans*-Objekt |
1.024 |
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 |
Maximale Anzahl von Event*-Objekten pro Span*-Objekt |
256 |
Maximale Anzahl von Link*-Objekten pro Span*-Objekt |
128 |
Maximale Größe des Namens eines Event*-Objekts |
1.024 Byte |
Maximale Anzahl von Attributen pro Event*-Objekt |
1.024 |
Maximale Anzahl von Attributen pro Link*-Objekt |
1.024 |
| Maximale Größe von Schema-URLs | 8.192 Byte |
trace.proto Datei.
Limits für Tracebereiche
| Limits für Tracebereiche | Wert |
|---|---|
| Maximale Anzahl von Tracebereichen pro Projekt | 100 |
| Maximale Anzahl von Projekten pro Tracebereich | 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 Ihre Kontingentnutzung im Blick behalten.
Änderungen am Cloud Trace API-Kontingent anfordern
In der Konsole können Sie höhere oder niedrigere Limits für die Cloud Trace API 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 den Überblick über die Leistung Ihrer Anwendungen 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 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 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.