Kontingente und Limits

Sie können die Telemetry (OTLP) API oder die Cloud Trace API verwenden, um Trace-Daten an Ihr Google Cloud-Projekt zu senden. Die Telemetry API implementiert die OpenTelemetry OTLP API und bietet eine größere Kompatibilität und Unterstützung für das Open-Source-OpenTelemetry-System. 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 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 ListTraces pro 60 Sekunden
  • 10 API-Aufrufe mit dem Befehl ListTraces und 50 API-Aufrufe mit dem Befehl GetTrace pro 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 Lesevorgänge gehören GetTrace, ListTraces und ListSpan. Ein Aufruf von ListTraces verbraucht 25 Kontingenteinheiten. Aufrufe von GetTrace verbrauchen ListSpan Kontingenteinheiten.
2 Schreibvorgänge umfassen PatchTraces, BatchWrite und CreateSpan. Jeder Schreibvorgang verbraucht eine 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

Beschreibung Wert
Maximale Anzahl Spans pro GetTrace-Aufruf 1.000
Maximale Anzahl Spans pro PatchTraces-Aufruf 25.000
Maximale Anzahl von Traces pro ListTraces-Aufruf 1.000 in den Ansichten ROOTSPAN und MINIMAL
100 in der Ansicht COMPLETE
Maximale Anzahl Spans pro Trace 1.000
Maximale Größe von Traces 50 MB
Maximale Länge eines Span-Namens 128 Byte
Maximale Anzahl von Labels oder Attributen pro Span 32
Maximale Größe eines 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 vergangener Zeitstempel für eine zu übernehmende Spanne 14 Tage
Maximaler zukünftiger Zeitstempel für einen zu ingestierenden Span 3 Tage
Höchster vergangener Zeitstempel für das Ereignis relativ zum Span-Zeitstempel 365 Tage

Sie können Spans annotieren, indem Sie ein attributes-Objekt erstellen und an das Span-Objekt anhängen, wenn Sie die Trace API v2 batchWrite verwenden. Wenn Sie die Trace API v1 patchTraces-Methode verwenden, können Sie Spans auch annotieren, indem Sie ein labels-Objekt erstellen und an das TraceSpan-Objekt anhängen.

Limits der Telemetry API

In diesem Abschnitt sind 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
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 sind 1.024
Maximale Anzahl von Ressourcenattributen pro ResourceSpans*-Objekt 1.024
Maximale Anzahl von Attributen pro ResourceSpan*-Objekt
Beinhaltet 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
*  Eine Definition dieser Struktur finden Sie in der OpenTelemetry-trace.proto.

Limits für Trace-Bereiche

Limits für Trace-Bereiche Wert
Maximale Anzahl von Trace-Scopes pro Projekt 100
Maximale Anzahl von Projekten pro Tracebereich 20

Aufbewahrungsdauer

Kategorie Aufbewahrungsdauer
Von Cloud Trace gespeicherte Span-Daten 30 Tage
Analyseberichte 30 Tage

Kontingent verwalten

In diesem Abschnitt wird beschrieben, wie Sie eine Änderung eines Kontingents beantragen und die Kontingentnutzung überwachen.

Änderungen am Cloud Trace API-Kontingent anfordern

In der Google 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 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 einem Batch ausführen 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 Ihres Kontingents für die Cloud Trace API und Ihres täglichen Kontingents für die Span-Aufnahme finden Sie unter Kontingente aufrufen und verwalten.

  • Unter Nutzung einschränken finden Sie Informationen zum Verringern Ihrer API-Kontingenteinheiten und täglichen Kontingenteinheiten für die Span-Aufnahme.

  • 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.