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, sowie das Tageskontingent für die Aufnahme von Spans. Beispielsweise haben Sie für die drei API-Befehle GetTrace, ListTraces und ListSpan insgesamt 300 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 Lesevorgänge umfassen GetTrace, ListTraces und ListSpan. Ein Aufruf von ListTraces verbraucht 25 Kontingenteinheiten. GetTrace-Aufrufe verbrauchen ListSpan 1 Kontingenteinheit.
2 Schreibvorgänge umfassen PatchTraces, BatchWrite und CreateSpan. Jeder Schreibvorgang verbraucht 1 Kontingenteinheit.
3 Ihr tägliches Kontingent für die Aufnahme von Trace-Spans hängt vom Verlauf Ihres Rechnungskontos und von Anfragen zur Kontingenterhöhung ab.
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 ROOTSPAN- und MINIMAL-Aufrufen100 in der COMPLETE-Ansicht |
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 Schlüsselgröße für ein Label oder Attribut | 128 Byte |
| Maximale Größe eines Werts für ein Label oder Attribut | 256 Byte |
| Maximale Anzahl von Ereignissen pro Span | 128 |
| Höchster Zeitstempel für die Aufnahme eines Spans in der Vergangenheit | 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 mit Anmerkungen versehen. Dazu erstellen Sie ein labels-Objekt und hängen es an das TraceSpan-Objekt an, wenn Sie die patchTraces-Methode der Cloud Trace API Version 1 verwenden.
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 Änderung eines Kontingents anfordern und die Kontingentnutzung überwachen.
Änderungen am Cloud Trace API-Kontingent anfordern
Über die Google Cloud Console können Sie höhere oder niedrigere Limits für die Cloud Trace API anfordern:
Klicken Sie auf der Seite „Kontingente“ der Google Cloud Console die Kästchen für die Cloud Trace API an und klicken Sie dann auf Kontingente bearbeiten.
Wenn die Fehlermeldung
Edit is not allowed for this quotaausgegeben wird, können Sie den Support kontaktieren, um Änderungen am Kontingent anzufordern. Außerdem muss die Abrechnung für das Google Cloud-Projekt aktiviert sein, damit die Kästchen angeklickt werden können.Wählen Sie im Feld Kontingentänderungen den Dienst aus, um die Ansicht zu maximieren. Füllen Sie dann die Felder Neues Limit und Beschreibung der Anfrage aus. Klicken Sie auf Weiter.
Füllen Sie das Formular im Feld Kontaktdetails aus.
Klicken Sie auf Anfrage senden.
Weitere Informationen finden Sie unter Kontingente aufrufen und verwalten.
Kontingentnutzung überwachen
Damit Sie Ihr Kontingent nicht überschreiten und den Überblick über die Leistung Ihrer Anwendungen behalten, sollten Sie die Aktualisierungen im Batch ausführen und die Kontingentnutzung überwachen. Sie können beispielsweise eine Benachrichtigungsrichtlinie erstellen, durch die Sie benachrichtigt werden, wenn die Nutzung einen Grenzwert überschreitet. Detaillierte Informationen zum Überwachen Ihrer API-Anfragen sowie zu den Antworten darauf finden Sie unter API-Nutzung verfolgen.
Informationen zum Ansehen der Cloud Trace API und Ihres täglichen Kontingents für die Span-Aufnahme finden Sie unter Kontingente ansehen und verwalten.
Informationen zum Verringern der API-Kontingenteinheiten und täglichen Kontingenteinheiten für die Span-Aufnahme finden Sie unter Nutzung einschränken.
Unter Höheres Kontingent anfordern können Sie eine Erhöhung Ihrer API-Kontingenteinheiten oder der täglichen Kontingente für die Span-Aufnahme 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.