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 diffusion 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 `LogGroup` pour ingérer les données des journaux, consultez les concepts [ d'](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogsConcepts.html)Amazon CloudWatch Logs.
Vous devez configurer `LogGroup` et `LogStream` quand vous invoquez le point de OpenTelemetry terminaison CloudWatch Logs en définissant `x-aws-log-group` et en `LogStream` nommant les en-têtes `x-aws-log-stream` HTTP `LogGroup` respectivement. Pour de plus amples informations, veuillez consulter [Prise en main](CloudWatch-OTLPGettingStarted.md).
Le terminal prend en charge les méthodes d'authentification suivantes :
+ **AWS Signature Version 4 (Sigv4) ** : recommandée pour les charges de travail exécutées sur. AWS Utilise des informations d'identification à court terme à l'aide de rôles IAM. 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).
+ **Jeton porteur (clé API) ** : pour les charges de travail exécutées à l'extérieur AWS ou les environnements qui ne prennent pas en charge le AWS SDK. Nécessite que l'authentification par jeton du porteur soit activée sur le groupe de journaux cible. Pour plus d'informations, consultez la section [ Configuration de l'authentification par jeton du porteur pour les journaux](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_HTTP_Endpoints_BearerTokenAuth.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 grands objets du journal (LLO) et des champs 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 `. Les LLO peuvent être récupérés et renvoyés en continu à l’aide de l’API `GetLogObject`. Pour de plus amples informations, veuillez consulter [GetLogObject](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogObject.html). La prise en charge des événements de journalisation supérieurs à 1 Mo et l'expérience LLO sont disponibles dans les régions USA Est (Virginie du Nord), USA Ouest (Oregon), Europe (Francfort), Asie-Pacifique (Sydney), Asie-Pacifique (Mumbai), USA Est (Ohio), Europe (Irlande), Asie-Pacifique (Tokyo) et Asie-Pacifique (Singapour).
## Endpoint 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 terminal prend en charge deux méthodes d'authentification :
+ **AWS Signature Version 4 (Sigv4) ** : méthode d'authentification recommandée utilisant des informations d'identification à court terme. 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).
+ **Jeton porteur (clé API) ** : pour les charges de travail exécutées à l'extérieur AWS ou les environnements qui ne prennent pas en charge le AWS SDK. Utilise une clé API de longue durée transmise dans l'`Authorization`en-tête. Pour de plus amples informations, veuillez consulter [Configuration de l'authentification par jeton au porteur pour Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md).
## 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 avec`eventName`) pour les applications RUM. CloudWatch
Pour utiliser ce point de terminaison, vous devez créer un moniteur d'applications [ RUM ](CloudWatch-RUM-get-started-create-app-monitor.md) avec la plate-forme mobile (Android/iOS) et utiliser l'extrait de code généré pour instrumenter vos applications. L'extrait extrait les SDK RUM Mobile configurés avec ce point de terminaison. Vous pouvez configurer davantage les SDK pour que RUM 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 utiliser des politiques basées sur les ressources pour autoriser un accès non authentifié à partir d'applications mobiles.
Pour en savoir plus sur les modèles d'authentification tels que définis dans leurs SDK, consultez les rubriques suivantes :
+ Applications iOS : [AWS distribution 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, des journaux ou des traces aux points de terminaison OTLP, vous devez utiliser sigv4authextension. Pour les points de terminaison des métriques et des journaux, vous pouvez également vous authentifier avec un jeton porteur à l'aide de l'extension bearertokenauth. [https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/extension/bearertokenauthextension](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/extension/bearertokenauthextension) Consultez [Configuration de l'authentification par jeton au porteur pour Metrics](CloudWatch-OTLP-MetricsBearerTokenAuth.md) la section [ Configuration de l'authentification par jeton du porteur pour les journaux](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_HTTP_Endpoints_BearerTokenAuth.html). |
| 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 des points de terminaison pour les métriques.
| Limite | Endpoint 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 maximale non compressée de la demande. | 400 |
| Nombre maximum de points de données | 1 000 | Le nombre maximum de points de données envoyés en une seule demande. Ce nombre est une somme entre ResourceMetrics, ScopeMetrics et Metrics. | 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 maximum d'étiquettes | 150 | Nombre maximum d'étiquettes pour tous 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 |
| Horodatages créés par les métriques | 10 minutes dans le futur et 14 jours dans le passé | Les métriques peuvent être créées avec un horodatage d'au plus 10 minutes dans le futur et d'au plus 14 jours dans le passé. | 400 |
Le tableau répertorie les limites et restrictions du point de terminaison pour les journaux.
- ** Nombre maximal d’octets non compressés par requête**
- **Point de terminaison des journaux:** 1 Mo / **Informations supplémentaires:** Le point de terminaison OTLP rejettera les requêtes supérieures à 1 Mo lorsque les données utiles n’ont pas été compressées.
La taille maximale de la requête est de 1 048 576 octets après décompression et désérialisation des données binaires sérialisées par les tampons de protocole. Cette taille est calculée comme la somme de tous les messages d'événements entrants UTF-8, plus 26 octets pour chaque enregistrement de journal.
- **Point de terminaison des journaux:** 20 Mo
Disponible uniquement dans les régions USA Est (Virginie du Nord), USA Ouest (Oregon), Europe (Francfort), Asie-Pacifique (Sydney), Asie-Pacifique (Mumbai), USA Est (Ohio), Europe (Irlande), Asie-Pacifique (Tokyo) et Asie-Pacifique (Singapour). / **Informations supplémentaires:** La taille maximale de la requête est de 20 Mo (20 971 520 octets) après décompression et décodage des données utiles OTLP à partir du format JSON.
Pour les journaux d'une taille inférieure à 1 Mo : ces journaux offrent un accès complet à toutes les fonctionnalités CloudWatch des journaux, y compris les requêtes et le suivi en temps réel.
Pour les journaux supérieurs à 1 Mo : la partie excédentaire est traitée comme des objets de journal volumineux (LLO).
- **Requête par seconde**
- **Point de terminaison des journaux:** 5000
- **Informations supplémentaires:** 5 000 transactions par seconde et par compte et par région. Vous pouvez faire une requête d’augmentation du quota de limitation par seconde à l’aide du service Service Quotas.
- ** Taille d’une ressource et d’une portée uniques**
- **Point de terminaison des journaux:** 16 Ko
- **Informations supplémentaires:** 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é.
- ** LogEvent Taille unique **
- **Point de terminaison des journaux:** 1 Mo
- **Informations supplémentaires:** LogEvent la taille est calculée comme la somme des tailles pour chacune LogRecord, Scope et Resource. Ce quota ne peut pas être modifié.
- **Horodatages de création des journaux**
- **Point de terminaison des journaux:** 2 heures dans le futur et 14 jours dans le passé
- **Informations supplémentaires:** Les enregistrements de journal dans le lot ne doivent pas nécessairement être classés par ordre chronologique. Cependant, les enregistrements de journal dans le lot ne peuvent pas dater de plus de 2 heures dans le futur et de plus de 14 jours dans le passé. De plus, aucun des enregistrements de journal ne peut être antérieur à la période de conservation du groupe de journaux.
- ** Écart temporel maximal dans les événements par requête**
- **Point de terminaison des journaux:** 24 heures
- **Informations supplémentaires:**
- ** Nombre maximum d’événements/requête**
- **Point de terminaison des journaux:** 10 000 journaux
- **Informations supplémentaires:** Le nombre maximal d’événements du journal dans un lot est de 10 000. Le dépassement de cette limite entraînera le rejet de l’appel d’API.
- ** Nombre maximal d’objets de journalisation volumineux/requête**
- **Point de terminaison des journaux:** 1 enregistrement de journal
Disponible dans les régions USA Est (Virginie du Nord), USA Ouest (Oregon), Europe (Francfort), Asie-Pacifique (Sydney), Asie-Pacifique (Mumbai), USA Est (Ohio), Europe (Irlande), Asie-Pacifique (Tokyo) et Asie-Pacifique (Singapour).
- **Informations supplémentaires:** Pour les contenus dépassant 1 Mo dans un événement du journal, le contenu excédentaire est stocké sous forme de LLO. Limité à 1 journal par requête.
- ** Nombre maximal d’objets de journal volumineux par journal**
- **Point de terminaison des journaux:** 10 LLO
Disponible dans les régions USA Est (Virginie du Nord), USA Ouest (Oregon), Europe (Francfort), Asie-Pacifique (Sydney), Asie-Pacifique (Mumbai), USA Est (Ohio), Europe (Irlande), Asie-Pacifique (Tokyo) et Asie-Pacifique (Singapour).
- **Informations supplémentaires:** Un seul journal peut contenir jusqu’à 10 LLO.
**Note**
Les limites de compte pour les journaux sont partagées entre le kit SDK et le nouveau point de terminaison des journaux.