Points de terminaison OTLP

OpenTelemetry Le protocole (OTLP) est un protocole de fourniture de données de télémétrie à usage général conçu pour le. OpenTelemetry CloudWatch OpenTelemetry les points de terminaison sont des points de terminaison HTTP 1.1. Vous devez configurer votre OpenTelemetry collecteur pour qu'il commence à envoyer des données de télémétrie ouvertes à. CloudWatch Pour de plus amples informations, veuillez consulter Mise en route. Le point de terminaison authentifie les appelants à l'aide de l'authentification Signature 4. Pour plus d'informations, consultez AWS la version 4 de Signature pour les demandes d'API.

Point de terminaison du

Le point de terminaison des traces suit le modèlehttps://xray.AWS Region.amazonaws.com/v1/traces. Par exemple, pour la région USA Ouest (Oregon) (us-west-2), le point de terminaison sera. https://xray.us-west-2.amazonaws.com/v1/traces

Vous devez configurer votre OpenTelemetry collecteur pour qu'il commence à envoyer des traces à CloudWatch. Consultez Mise en route pour démarrer.

Endpoint de log

Le point de terminaison des logs suit le modèlehttps://logs.Région AWS.amazonaws.com/v1/logs. Par exemple, pour leUS West (Oregon) (us-west-2) Region, le point de terminaison serahttps://logs.us-west-2.amazonaws.com/v1/logs. Vous pouvez utiliser le point de terminaison ci-dessus pour transférer les journaux vers un LogGroup et existantLogStream. Pour plus d'informations sur la configuration de LogGroup l'ingestion des données de journal, consultez les concepts d'Amazon CloudWatch Logs.

Vous devez configurer LogGroup et LogStream quand vous appelez le point de OpenTelemetry terminaison CloudWatch Logs en définissant les en-têtes x-aws-log-stream HTTP x-aws-log-group LogGroup et en les LogStream nommant respectivement. Pour de plus amples informations, veuillez consulter Mise en route.

Lorsque la taille des événements du journal dépasse 1 Mo, CloudWatch Logs tronque automatiquement jusqu'à 10 champs, en commençant par les plus grands. Chaque champ est tronqué selon les besoins pour que la taille totale de l'événement soit aussi proche que possible de 1 Mo. Les parties excédentaires sont stockées sous forme de Large Log Objects (LLOs) et les champs du système de référence LLO sont ajoutés. Vous pouvez éventuellement spécifier les chemins de champs qui doivent être tronqués en définissant l'en-tête x-aws-truncatable-fields HTTP. Ils LLOs peuvent être récupérés et retransmis à l'aide de l'GetLogObjectAPI. Pour de plus amples informations, veuillez consulter GetLogObject. Support pour les événements de log supérieurs à 1 Mo et l'expérience LLO sont disponibles dans l'est des États-Unis (Virginie du Nord), dans l'ouest des États-Unis (Oregon), en Europe (Francfort) et en Asie-Pacifique (Sydney).

Limites et restrictions relatives aux terminaux

Le tableau répertorie les limites et restrictions courantes des terminaux pour les traces et les journaux.

Limite	Point de terminaison	Informations supplémentaires
Extension de collecteur requise	extension sigv4auth	Pour envoyer des traces au point de terminaison OTLP, vous devez utiliser sigv4authextension
Protocole pris en charge	HTTP	Le point de terminaison prend uniquement en charge le HTTP et ne prend pas en charge le gRPC
Versions OTLP prises en charge	OTLP 1.x
Format de charge utile	binaire, json	Le point de terminaison accepte les demandes utilisant les formats binaire et json
Méthodes de compression	gzip, aucun	Le point de terminaison ne prend en charge que les méthodes de compression gzip et aucune méthode de compression

Le tableau répertorie les limites des terminaux et les restrictions relatives aux traces.

Limite	Point de terminaison du	Informations supplémentaires
Nombre maximal d'octets non compressés par demande	5 Mo	Le point de terminaison OTLP rejettera les demandes supérieures à 5 Mo lorsque la charge utile n'est pas compressée.
Nombre maximum d'événements/demande	10 000 travées	Le nombre maximum de travées par lot est de 10 000. Le dépassement de cette limite entraînera le rejet de l'appel d'API.
Ressource unique et taille du champ d'application	16 Ko	Chaque ressource unique et l'étendue correspondante ne doivent pas dépasser 16 Ko de taille. Le dépassement de cette limite pour n'importe quelle ressource entraînera le rejet de l'intégralité de l'appel d'API.
Taille maximale d'une seule travée	200 Ko	Les étendues supérieures à 200 Ko seront rejetées par le point de terminaison.
Span a créé les horodatages	2 heures dans le futur et 14 jours dans le passé	Aucune des durées du lot ne peut dépasser deux heures dans le futur ou plus de 14 jours dans le passé.
Intervalle de temps maximal entre les événements et les demandes	24 heures

Le tableau répertorie les limites et les restrictions relatives aux terminaux pour les journaux.

Limite	Endpoint de log	Informations supplémentaires
Nombre maximal d'octets non compressés par demande	1 Mo	Le point de terminaison OTLP rejettera les demandes supérieures à 1 Mo lorsque la charge utile n'est pas compressée. La taille maximale des demandes est de 1 048 576 octets après décompression et désérialisation des données binaires sérialisées par les tampons du protocole. Cette taille est calculée comme la somme de tous les messages d'événements en UTF-8, plus 26 octets pour chaque enregistrement de journal.
	20 Mo Disponible uniquement dans l'est des États-Unis (Virginie du Nord), dans l'ouest des États-Unis (Oregon), en Europe (Francfort) et en Asie-Pacifique (Sydney).	La taille maximale de la demande est de 20 Mo (20 971 520 octets) une fois la charge utile OTLP décompressée et décodée à partir du format JSON. Pour les journaux jusqu'à 1 Mo : ces journaux ont un accès complet à toutes les fonctionnalités CloudWatch des journaux, y compris les requêtes et le live tail. Pour les journaux supérieurs à 1 Mo, la partie excédentaire est traitée comme de grands objets de journal (LLOs).
Demande par seconde	5000	5000 transactions par seconde, par compte et par région Vous pouvez demander une augmentation du quota de limitation par seconde en utilisant le service Service Quotas.
Ressource unique et taille du champ d'application	16 Ko	Chaque ressource unique et l'étendue correspondante ne doivent pas dépasser 16 Ko de taille. Le dépassement de cette limite pour n'importe quelle ressource entraînera le rejet de l'intégralité de l'appel d'API.
LogEvent Taille unique	1 Mo	LogEvent la taille est calculée comme la somme des tailles pour chacune LogRecord, portée et ressource. Ce quota ne peut pas être modifié.
Les journaux ont créé des horodatages	2 heures dans le futur et 14 jours	Il n'est pas nécessaire que les enregistrements du journal du lot soient classés par ordre chronologique. Cependant, les enregistrements du lot ne peuvent pas être enregistrés plus de 2 heures dans le futur et ne peuvent pas dater de plus de 14 jours dans le passé. En outre, aucun enregistrement de journal ne peut être antérieur à la période de conservation du groupe de journaux.
Intervalle de temps maximal entre les événements et les demandes	24 heures
Nombre maximum d'événements/demande	10 000 journaux	Le nombre maximum d'événements de journal par lot est de 10 000. Le dépassement de cette limite entraînera le rejet de l'appel d'API.
Nombre maximum d'objets de journalisation par demande	1 enregistrement de journal Disponible dans l'est des États-Unis (Virginie du Nord), dans l'ouest des États-Unis (Oregon), en Europe (Francfort) et en Asie-Pacifique (Sydney).	Pour le contenu supérieur à 1 Mo dans un événement de journal, le contenu excédentaire est stocké sous LLOs le nom. Limité à 1 enregistrement de journal par demande.
Nombre maximum d'objets de journalisation par enregistrement	10  LLOs Disponible dans l'est des États-Unis (Virginie du Nord), dans l'ouest des États-Unis (Oregon), en Europe (Francfort) et en Asie-Pacifique (Sydney).	Un seul enregistrement de journal peut en contenir jusqu'à 10 LLOs.

Note

Les limites de compte pour les journaux sont partagées entre le SDK et le nouveau point de terminaison Logs.