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 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 | 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.
2 Schreibvorgänge umfassen PatchTraces, BatchWrite und CreateSpan. Jeder Schreibvorgang verbraucht 1 Kontingenteinheit.
3 Ihr Tageskontingent für die Aufnahme von Spans in Traces 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 |
1.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 Anzahl Spans pro Trace | 1.000 |
| Maximale Trace-Größe | 50 MB |
| Maximale Länge eines Spannen-Namens | 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 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, 32 überschreitet. Stattdessen verwendet die Cloud Trace API in diesem Szenario einen nicht deterministischen Algorithmus, um 32 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 patchTraces-Endpunkt verwenden, fügen Sie dem TraceSpan-Objekt Labels hinzu.
Telemetry API-Limits
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 |
|---|---|
| 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 an ein Span*-Objekt angehängt werden können |
1.024 |
Maximale Anzahl von Ressourcenattributen pro ResourceSpans*-Objekt |
1.024 |
Maximale Anzahl von Attributen pro ResourceSpan*-ObjektDazu gehören 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 | 8192 Byte |
trace.proto
Limits für Tracebereiche
| Limits für Tracebereiche | Wert |
|---|---|
| Maximale Anzahl von Trace-Bereichen pro Projekt | 100 |
| Maximale Anzahl an Projekten pro Tracebereich | 20 |
Aufbewahrungsdauer
| Kategorie | Aufbewahrungsdauer |
|---|---|
| Von Cloud Trace gespeicherte Spandaten | 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
In derGoogle Cloud console können Sie höhere oder niedrigere Cloud Trace API-Limits anfordern. 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 am Kontingent anzufordern. Beachten Sie auch, dass die Abrechnung für dasGoogle 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 Grenzwert überschreitet. Detaillierte Informationen zum Überwachen Ihrer API-Anfragen sowie zu den Antworten darauf finden Sie unter API-Nutzung verfolgen.
Informationen zum Aufrufen des Kontingents für die Cloud Trace API und Ihres täglichen Kontingents für die Span-Aufnahme finden Sie unter Kontingente ansehen und verwalten.
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 finden Sie Informationen zum Anfordern einer Erhöhung Ihrer API-Kontingenteinheiten und der täglichen Kontingente für die Span-Aufnahme.
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.