Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# 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 [Prise en main](CloudWatch-OTLPGettingStarted.md).
## Point de terminaison des journaux
Le point de terminaison des journaux suit le modèle `https://logs.Région AWS.amazonaws.com/v1/logs`. Par exemple, pour `US West (Oregon) (us-west-2) Region`, le point de terminaison sera `https://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 un `LogStream` existants. Pour plus d'informations sur la configuration de `LogGroup` l'ingestion des données de journal, consultez les [concepts d'Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogsConcepts.html).
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 [Prise en main](CloudWatch-OTLPGettingStarted.md). Le point de terminaison authentifie les appelants à l’aide de l’authentification Signature 4. Pour plus d’informations, consultez [AWS Signature Version 4 pour les requêtes API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html).
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 afin de maintenir la taille totale de l’événement 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 également spécifier les chemins d’accès aux champs qui doivent être tronqués en définissant l’en-tête HTTP `x-aws-truncatable-fields `. Ils LLOs peuvent être récupérés et retransmis à l'aide de l'`GetLogObject`API. Pour de plus amples informations, veuillez consulter [GetLogObject](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogObject.html). 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), dans l'Asie-Pacifique (Sydney), dans l'Asie-Pacifique (Mumbai), dans l'est des États-Unis (Ohio), en Europe (Irlande), en Asie-Pacifique (Tokyo) et en Asie-Pacifique (Singapour).
## Point final des métriques
Le point de terminaison des métriques suit le modèle`https://monitoring.AWS Region.amazonaws.com/v1/metrics`. Par exemple, pour la région USA Ouest (Oregon) (us-west-2), le point de terminaison sera `https://monitoring.us-west-2.amazonaws.com/v1/metrics`.
Vous devez configurer votre OpenTelemetry collecteur pour qu'il commence à envoyer des métriques à CloudWatch. Le point de terminaison authentifie les appelants à l’aide de l’authentification Signature 4. Pour plus d’informations, consultez [AWS Signature Version 4 pour les requêtes API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html).
## Point de terminaison des traces
Le point de terminaison des traces suit le modèle `https://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. Le point de terminaison authentifie les appelants à l’aide de l’authentification Signature 4. Pour plus d’informations, consultez [AWS Signature Version 4 pour les requêtes API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html).
## Point final RUM
Le point de terminaison RUM suit le modèle`https://dataplane.rum.{AWS Region}.amazonaws.com/v1/rum`. Par exemple, pour la région de l'ouest des États-Unis (Oregon), le point de terminaison est`https://dataplane.rum.us-west-2.amazonaws.com/v1/rum`. Ce point de terminaison gère les *données de télémétrie côté client* (uniquement les traces et les enregistrements de journal`eventName`) pour les applications RUM. CloudWatch
Pour utiliser ce point de terminaison, vous devez créer un [moniteur d'application RUM](CloudWatch-RUM-get-started-create-app-monitor.md) avec une plate-forme mobile (Android/iOS) et utiliser l'extrait de code généré pour instrumenter vos applications. L'extrait extraira les RUM Mobile configurés avec SDKs ce point de terminaison. Vous pouvez SDKs ensuite configurer RUM pour qu'il collecte la télémétrie en conséquence.
Le point de terminaison prend en charge les demandes authentifiées et non authentifiées. Vous pouvez utiliser AWS Signature Version 4 (SigV4) pour les demandes authentifiées, ou des politiques basées sur les ressources pour autoriser l'accès non authentifié à partir d'applications mobiles.
Pour en savoir plus sur les modèles d'authentification tels que définis dans leur manuel SDKs, consultez les rubriques suivantes :
+ Applications iOS - [AWS Distro pour le SDK iOS OpenTelemetry (ADOT](https://github.com/aws-observability/aws-otel-swift)).
+ Applications Android - [AWS Distro pour le SDK Android OpenTelemetry (ADOT)](https://github.com/aws-observability/aws-otel-android).
## Limites et restrictions des points de terminaison
Le tableau répertorie les limites et restrictions courantes des terminaux pour les métriques, les traces et les journaux.
| Limite | Endpoint | Informations supplémentaires |
| --- | --- | --- |
| Extension de collecteur requise | [sigv4authextension](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/extension/sigv4authextension) | Pour envoyer des métriques ou des traces au point de terminaison OTLP, vous devez utiliser sigv4authextension |
| Protocole pris en charge | HTTP | Le point de terminaison prend uniquement en charge HTTP et ne prend pas en charge gRPC |
| Versions OTLP prises en charge | OTLP 1.x | |
| Format de données utiles | binaire, json | Le point de terminaison accepte les requêtes au format binaire et json |
| Méthodes de compression | gzip, aucun | Le point de terminaison prend uniquement en charge les méthodes de compression gzip et none |
Le tableau répertorie les limites et restrictions des points de terminaison pour les traces.
| Limite | Point de terminaison des traces | Informations supplémentaires |
| --- | --- | --- |
| Nombre maximal d’octets non compressés par requête | 5 Mo | Le point de terminaison OTLP rejettera les requêtes supérieures à 5 Mo lorsque les données utiles n’ont pas été compressées. |
| Nombre maximum d’événements/requête | 10 000 portées | Le nombre maximal de portées dans un lot est de 10 000. Le dépassement de cette limite entraînera le rejet de l’appel d’API. |
| Taille d’une ressource et d’une portée uniques | 16 Ko | Chaque ressource unique et la portée correspondante ne doivent pas dépasser 16 Ko. Le dépassement de cette limite pour une ressource entraînera le rejet de l’appel d’API dans son intégralité. |
| Taille maximale d’une portée unique | 200 Ko | Les portées de plus de 200 Ko seront rejetées par le point de terminaison. |
| Horodatages de création des portées | 2 heures dans le futur et 14 jours dans le passé | Aucune des portées du lot ne peut dépasser 2 heures dans le futur ou 14 jours dans le passé. |
| Écart temporel maximal dans les événements par requête | 24 heures | |
Le tableau répertorie les limites et les restrictions relatives aux points de terminaison pour les métriques.
| Limite | Point final des métriques | Informations supplémentaires | Code d’erreur |
| --- | --- | --- | --- |
| TPS maximal | 500 | Le nombre maximum de demandes par seconde autorisées par compte. | 429 |
| Taux maximal de création de nouvelles séries | 1 000 000 | Nombre maximum de nouvelles séries pouvant être créées dans une fenêtre de 10 minutes. Cette limite s'applique uniquement à la création de nouveaux noms de métriques, et non à l'ingestion de points de données pour des métriques existantes. | 429 - toutes les métriques des demandes sont limitées ; 200 - les métriques des demandes sont partiellement limitées |
| Taille maximum d'une requête | 1 Mo | Taille non compressée maximale de la demande. | 400 |
| Nombre maximal de points de données | 1 000 | Le nombre maximum de points de données envoyés dans une seule demande. Ce nombre est une somme entre ResourceMetrics, ScopeMetrics et des métriques. | 400 |
| Taille maximale des métadonnées | 40 Ko | Taille combinée maximale de toutes les étiquettes et valeurs d'étiquette acceptées pour une série par point de données. | 400 - toutes les métriques des demandes ne sont pas valides ; 200 - les métriques des demandes sont partiellement invalides |
| Nombre maximal d'étiquettes | 150 | Nombre maximum d'étiquettes pour les Resource/Scope/Datapoint attributs par point de données. | 400 - toutes les métriques des demandes ne sont pas valides ; 200 - les métriques des demandes sont partiellement invalides |
Le tableau répertorie les limites et restrictions du point de terminaison pour les journaux.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonCloudWatch/latest/monitoring/CloudWatch-OTLPEndpoint.html)
**Note**
Les limites de compte pour les journaux sont partagées entre le kit SDK et le nouveau point de terminaison des journaux.