Kontingente und Limits

Cloud Trace erzwingt zwei Arten von Kontingenten: ein Ratenkontingent für Ihre API-Aufrufe und ein Datenaufnahmekontingent für die Spans, die Sie an Trace senden.

Trace-Kontingente

In der folgenden Tabelle sind die Kontingenteinheiten für Lese- und Schreibvorgänge sowie das tägliche Kontingent für die Datenaufnahme 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ängen gehören GetTrace, ListTraces und ListSpan. Ein Aufruf von ListTraces verbraucht 25 Kontingenteinheiten. Anrufe an GetTrace verbrauchen ListSpan 1 Kontingenteinheit.
2 Schreibvorgänge umfassen PatchTraces, BatchWrite und CreateSpan. Jeder Schreibvorgang verbraucht eine Kontingenteinheit.
3 Ihr tägliches Kontingent für die Aufnahme von Trace-Spans hängt von der Anzahl der Verlauf des Rechnungskontos und Anfragen zur Kontingenterhöhung.

Trace-Limits

In diesem Abschnitt sind die Limits aufgeführt, die bei der Verwendung der Cloud Trace API gelten.

Limits für API-Methoden

Limits für API-Methoden Wert
Maximale Anzahl Spans pro GetTrace-Aufruf 1.000
Maximale Anzahl Spans pro PatchTraces-Aufruf 25.000
Maximale Anzahl Traces pro ListTraces-Aufruf 1.000 in den Ansichten ROOTSPAN und MINIMAL
100 in der Ansicht COMPLETE

Limits für Spans

Einschränkungen für Spans Wert
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 einen aufzunehmenden Span 14 Tage
Maximaler zukünftiger Zeitstempel für einen aufzunehmenden Span 3 Tage
Maximaler 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 SpanObjekt anhängen, wenn Sie die Cloud Trace API v2 batchWrite verwenden. Wenn Sie die Cloud Trace API v1-Methode patchTraces verwenden, können Sie Spans auch annotieren, indem Sie ein labels-Objekt erstellen und an das TraceSpan-Objekt anhängen.

Limits für Traces

Limits für Traces Wert
Maximale Anzahl Spans pro Trace 1.000
Maximale Trace-Größe 50 MB

Aufbewahrungsdauer

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

Kontingent verwalten

In diesem Abschnitt wird beschrieben, wie Sie eine Kontingentänderung anfordern und überwachen können. Ihre Kontingentnutzung.

Änderungen am Cloud Trace API-Kontingent anfordern

Sie können höhere oder niedrigere Limits für die Cloud Trace API anfordern mit dem Google Cloud Console 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 Batches ausführen und Ihre Kontingentnutzung im Blick behalten. Sie können z. B. eine Benachrichtigungsrichtlinie erstellen, wenn Ihre Nutzung einen bestimmten 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.

  • Informationen zum Verringern der API-Kontingenteinheiten und der täglichen Zeitspanne Informationen zu Kontingenteinheiten für die Aufnahme finden Sie unter Nutzung einschränken.

  • Um eine Erhöhung Ihres API-Kontingents zu beantragen oder Ihre täglichen Kontingente für die Span-Aufnahme finden Sie unter Fordern Sie ein höheres Kontingent an.

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