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 aufgeführt, die für Lese- und Schreibvorgänge verfügbar sind.
und das tägliche Kontingent für die Aufnahme von Spans. Beispiel:
haben Sie insgesamt 300 pro 60 Sekunden für die drei APIs
GetTrace, ListTraces und ListSpan. 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 |
<ph type="x-smartling-placeholder"></ph>
1 Zu den Lesevorgängen gehören GetTrace, ListTraces,
ListSpan. Ein Aufruf von ListTraces verbraucht 25 Kontingenteinheiten. Anrufe an
GetTrace verbrauchen ListSpan 1 Kontingenteinheit.
2 Zu den Schreibvorgängen gehören PatchTraces, BatchWrite,
und CreateSpan. Jeder Schreibvorgang verbraucht 1 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 MINIMAL100 in der Ansicht COMPLETE |
Limits für Spans
| Limits 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 Wertgröße 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. In ähnlicher Weise können Sie Spans annotieren,
indem Sie ein labels-Objekt erstellen und an das
TraceSpan-Objekt, wenn Sie das Objekt
patchTraces-Methode der Cloud Trace API v1
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. Die Abrechnung muss auf dem
Google Cloud-Projekt, um die Kästchen anzuklicken.
Kontingentnutzung überwachen
Damit Sie Ihr Kontingent nicht überschreiten und Beobachtbarkeit in Ihrem Konto verlieren, Apps sollten Sie alle Updates bündeln und Ihre Kontingentnutzung. 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.
So rufen Sie die Cloud Trace API und Ihren täglichen Span auf: Informationen zu Aufnahmekontingenten finden Sie unter Kontingente ansehen 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.