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 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 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. Jeder Schreibvorgang verbraucht 1 Kontingenteinheit.
3 Dieses Kontingent gilt nur für Spans, die über die Cloud Trace API erfasst werden.
Die Aufnahme über die Telemetry API ist uneingeschränkt.
4 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 MINIMAL100 in der Ansicht COMPLETE |
| Maximale Länge eines Spannen-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 Spans | 3 Tage |
| Maximaler vergangener Zeitstempel 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, 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 batchWrite-Endpunkt verwenden, fügen Sie dem Span-Objekt 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 werden. 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*-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 |
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: 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 _Trace-Bucket gespeichert sind |
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
Wenn Sie feststellen möchten, ob Sie über die Google Cloud -Konsole ein höheres oder niedrigeres Cloud Trace API-Limit für das 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. 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 der Fehler
Edit is not allowed for this quotaangezeigt wird, 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 -Konsole bearbeiten können.
Kontingentnutzung im Blick behalten
Damit Sie Ihr Kontingent nicht überschreiten und die Beobachtbarkeit der Leistung Ihrer Apps nicht verlieren, sollten Sie Ihre Updates in Batches zusammenfassen und Ihre Kontingentnutzung überwachen. 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 Ihrer Kontingente für die Cloud Trace API und Ihr tägliches Kontingent für die Span-Aufnahme finden Sie unter Kontingente ansehen und verwalten.
Informationen zum Verringern Ihrer API-Kontingenteinheiten und täglichen Kontingenteinheiten für die Span-Aufnahme finden Sie unter Nutzung einschränken.
Informationen zum Anfordern einer Erhöhung Ihrer API-Kontingenteinheiten und der täglichen Kontingente für die Span-Aufnahme finden Sie unter Höheres Kontingent 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.
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.