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
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 Lesevorgängen 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 für Traces
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 von Traces pro ListTraces-Aufruf |
1.000 in den Ansichten ROOTSPAN und MINIMAL100 in der Ansicht COMPLETE |
Einschränkungen 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 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 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.
Einschränkungen für Traces
| Einschränkungen für Traces | Wert |
|---|---|
| Maximale Anzahl Spans pro Trace | 1.000 |
| Maximale Größe von Traces | 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 Ä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 Batches 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.