OTLP-Endpunkte

OpenTelemetry Protocol (OTLP) ist ein Allzweckprotokoll zur Übertragung von Telemetriedaten, das für die entwickelt wurde. OpenTelemetry CloudWatch OpenTelemetry Endpunkte sind HTTP 1.1-Endpunkte. Sie müssen Ihren OpenTelemetry Collector so konfigurieren, dass er beginnt, offene Telemetriedaten an zu senden. CloudWatch Weitere Informationen finden Sie unter Erste Schritte. Der Endpunkt authentifiziert Anrufer mithilfe der Signature 4-Authentifizierung. Weitere Informationen finden Sie unter AWS Signature Version 4 für API-Anfragen.

Verfolgt den Endpunkt

Der Traces-Endpunkt folgt dem Musterhttps://xray.AWS Region.amazonaws.com/v1/traces. Für die Region USA West (Oregon) (us-west-2) lautet der Endpunkt beispielsweise. https://xray.us-west-2.amazonaws.com/v1/traces

Sie müssen Ihren OpenTelemetry Collector so konfigurieren, dass er mit dem Senden von Traces beginnt. CloudWatch Um zu beginnen, sehen Sie sich Erste Schritte an.

Protokolliert den Endpunkt

Der Endpunkt der Protokolle folgt dem Musterhttps://logs.AWS-Region.amazonaws.com/v1/logs. Für den wird der US West (Oregon) (us-west-2) Region Endpunkt beispielsweise seinhttps://logs.us-west-2.amazonaws.com/v1/logs. Sie können den obigen Endpunkt verwenden, um Protokolle an ein vorhandenes LogGroup und weiterzuleitenLogStream. Weitere Informationen LogGroup zur Einrichtung der Erfassung von Protokolldaten finden Sie unter Konzepte von Amazon CloudWatch Logs.

Sie müssen den CloudWatch OpenTelemetry Logs-Endpunkt konfigurieren LogGroup und LogStream wann Sie ihn aufrufen, indem Sie x-aws-log-group jeweils x-aws-log-stream HTTP-Header LogGroup und LogStream Namen festlegen. Weitere Informationen finden Sie unter Erste Schritte.

Wenn die Größe des Protokollereignisses 1 MB überschreitet, kürzt CloudWatch Logs automatisch bis zu 10 Felder, beginnend mit den größten Feldern. Jedes Feld wird nach Bedarf gekürzt, um die Gesamtgröße des Ereignisses so nah wie möglich an 1 MB zu halten. Die überschüssigen Teile werden als Large Log Objects (LLOs) gespeichert und Felder des LLO-Referenzsystems werden hinzugefügt. Optional können Sie die Feldpfade angeben, die gekürzt werden müssen, indem Sie den x-aws-truncatable-fields HTTP-Header festlegen. LLOs Sie können mithilfe der API abgerufen und zurückgestreamt werden. GetLogObject Weitere Informationen finden Sie unter GetLogObject. Support von Protokollereignissen mit mehr als 1 MB und LLO-Erfahrung ist in den Ländern USA Ost (Nord-Virginia), USA West (Oregon), Europa (Frankfurt) und Asien-Pazifik (Sydney) verfügbar.

Grenzwerte und Einschränkungen für Endgeräte

In der Tabelle sind die allgemeinen Endpunktgrenzwerte und -einschränkungen für Traces und Logs aufgeführt.

Limit	Endpunkt	Zusätzliche Informationen
Erforderliche Collector-Erweiterung	sigv4auth-Erweiterung	Um Traces an den OTLP-Endpunkt zu senden, müssen Sie sigv4authextension verwenden
Unterstützte Protokolle	HTTP	Der Endpunkt unterstützt nur HTTP und kein gRPC
Unterstützte OTLP-Versionen	OTLP 1.x
Nutzdatenformat	binär, json	Der Endpunkt akzeptiert Anfragen im Binär- und JSON-Format
Methoden zur Komprimierung	gzip, keiner	Der Endpunkt unterstützt nur Gzip- und keine Komprimierungsmethoden

In der Tabelle sind die Endpunktgrenzwerte und Einschränkungen für Traces aufgeführt.

Limit	Traces-Endpunkt	Zusätzliche Informationen
Maximale Anzahl unkomprimierter Bytes /Anfrage	5 MB	Der OTLP-Endpunkt lehnt Anfragen ab, die größer als 5 MB sind, wenn die Nutzlast unkomprimiert ist.
Maximale Anzahl Ereignisse /Anfrage	10.000 Bereiche	Die maximale Anzahl von Spans in einem Batch beträgt 10.000. Eine Überschreitung dieses Limits führt zur Ablehnung des API-Aufrufs.
Größe einer einzelnen Ressource und eines Bereichs	16 KB	Jede einzelne Ressource und der entsprechende Bereich sollten eine Größe von 16 KB nicht überschreiten. Eine Überschreitung dieses Limits für eine Ressource führt zur Ablehnung des gesamten API-Aufrufs.
Maximale Größe eines einzelnen Bereichs	200 KB	Bereiche mit mehr als 200 KB werden vom Endpunkt zurückgewiesen.
Span hat Zeitstempel erstellt	2 Stunden in der future und 14 Tage in der Vergangenheit	Keiner der Zeiträume in der Charge darf länger als zwei Stunden in der future oder länger als 14 Tage in der Vergangenheit liegen.
Maximaler Zeitabstand zwischen Ereignissen und Anfragen	24 Stunden

In der Tabelle sind die Endpunktgrenzwerte und Einschränkungen für Protokolle aufgeführt.

Limit	Protokolliert den Endpunkt	Zusätzliche Informationen
Maximale Anzahl unkomprimierter Bytes /Anfrage	1 MB	Der OTLP-Endpunkt lehnt Anfragen ab, die größer als 1 MB sind, wenn die Nutzlast unkomprimiert ist. Die maximale Anforderungsgröße beträgt 1.048.576 Byte nach der Dekomprimierung und Deserialisierung von Binärdaten, die durch Protokollpuffer serialisiert wurden. Diese Größe wird als Summe aller Ereignismeldungen in UTF-8 zuzüglich 26 Byte für jeden Protokolleintrag berechnet.
	20 MB Nur in den Ländern USA Ost (Nord-Virginia), USA West (Oregon), Europa (Frankfurt) und Asien-Pazifik (Sydney) verfügbar.	Die maximale Anforderungsgröße beträgt 20 MB (20.971.520 Byte), nachdem die OTLP-Nutzlast dekomprimiert und aus dem JSON-Format dekodiert wurde. Für Logs bis zu 1 MB — Diese Logs haben vollen Zugriff auf alle Logs-Funktionen, einschließlich Abfragen und Live-Tail. CloudWatch Bei Protokollen, die größer als 1 MB sind, wird der überschüssige Teil als große Protokollobjekte () LLOs verarbeitet.
Anfrage pro Sekunde	5000	5000 Transaktionen pro Sekunde pro Konto und Region Sie können eine Erhöhung des Drosselungskontingents pro Sekunde beantragen, indem Sie den Service Quotas Service verwenden.
Größe einer einzelnen Ressource und eines Bereichs	16 KB	Jede einzelne Ressource und der entsprechende Bereich sollten eine Größe von 16 KB nicht überschreiten. Eine Überschreitung dieses Limits für eine Ressource führt zur Ablehnung des gesamten API-Aufrufs.
LogEvent Einheitsgröße	1 MB	LogEvent Die Größe wird als Summe der Größen für jeden LogRecord Bereich und jede Ressource berechnet. Dieses Kontingent kann nicht geändert werden.
Protokolliert die erstellten Zeitstempel	2 Stunden in der future und 14 Tage alt	Die Protokolldatensätze im Stapel müssen nicht in chronologischer Reihenfolge angeordnet sein. Die Protokolldatensätze im Stapel dürfen jedoch nicht mehr als 2 Stunden in der future und nicht länger als 14 Tage in der Vergangenheit liegen. Außerdem darf keiner der Protokolldatensätze vor dem Aufbewahrungszeitraum der Protokollgruppe liegen.
Maximaler Zeitabstand zwischen Ereignissen und Anfrage	24 Stunden
Maximale Anzahl Ereignisse /Anfrage	10.000 Protokolle	Die maximale Anzahl von Protokollereignissen in einem Stapel beträgt 10.000. Eine Überschreitung dieses Limits führt zur Ablehnung des API-Aufrufs.
Höchstzahl an großen Protokollobjekten /Anfrage	1 Protokolldatensatz Verfügbar in USA Ost (Nord-Virginia), USA West (Oregon), Europa (Frankfurt) und Asien-Pazifik (Sydney).	Bei Inhalten, die mehr als 1 MB in einem Protokollereignis enthalten, wird der überschüssige Inhalt als LLOs gespeichert. Beschränkt auf 1 Protokolldatensatz pro Anfrage.
Maximal große Protokollobjekte/Datensatz	10 LLOs Verfügbar in USA Ost (Nord-Virginia), USA West (Oregon), Europa (Frankfurt) und Asien-Pazifik (Sydney).	Ein einzelner Protokolldatensatz kann bis zu 10 enthalten LLOs.

Anmerkung

Die Kontolimits für Logs gelten für das gesamte SDK und den neuen Logs-Endpunkt.