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.
Point de terminaison des traces
Le point de terminaison des traces suit le modèle https://xray.. Par exemple, pour la région USA Ouest (Oregon) (us-west-2), le point de terminaison sera AWS
Region.amazonaws.com/v1/traceshttps://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.
Point de terminaison des journaux
Le point de terminaison des journaux suit le modèle https://logs.. Par exemple, pour Région AWS.amazonaws.com/v1/logsUS 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.
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. 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.
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'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), 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).
Endpoint RUM
Le point de terminaison RUM suit le modèlehttps://dataplane.rum.{AWS
Region}.amazonaws.com/v1/rum. Par exemple, pour la région USA Ouest (Oregon), le point de terminaison esthttps://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 journaleventName) pour les applications RUM. CloudWatch
Pour utiliser ce point de terminaison, vous devez créer un moniteur d'application RUM 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
). -
Applications Android - AWS Distro pour le SDK Android OpenTelemetry (ADOT)
.
Limites et restrictions des points de terminaison
Le tableau répertorie les limites et restrictions courantes des points de terminaison pour les traces et les journaux.
| Limite | Endpoint | Informations supplémentaires |
|---|---|---|
|
Extension de collecteur requise |
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 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 restrictions du point de terminaison pour les journaux.
| Limite | Point de terminaison des journaux | Informations supplémentaires |
|---|---|---|
|
Nombre maximal d’octets non compressés par requête |
1 Mo |
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énement en UTF-8, plus 26 octets pour chaque événement du journal. |
|
20 Mo Disponible uniquement dans l'est des États-Unis (Virginie du Nord), l'ouest des États-Unis (Oregon), l'Europe (Francfort), l'Asie-Pacifique (Sydney), l'Asie-Pacifique (Mumbai), l'est des États-Unis (Ohio), l'Europe (Irlande), l'Asie-Pacifique (Tokyo) et l'Asie-Pacifique (Singapour). |
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 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). |
|
Requête par seconde |
5000 |
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 |
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é. |
|
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é. |
Horodatages de création des journaux |
2 heures dans le futur et 14 jours dans le passé |
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 |
24 heures |
|
|
Nombre maximum d’événements/requête |
10 000 journaux |
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 |
1 enregistrement de journal Disponible dans l'est des États-Unis (Virginie du Nord), l'ouest des États-Unis (Oregon), l'Europe (Francfort), l'Asie-Pacifique (Sydney), l'Asie-Pacifique (Mumbai), l'est des États-Unis (Ohio), l'Europe (Irlande), l'Asie-Pacifique (Tokyo) et l'Asie-Pacifique (Singapour). |
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 journal par requête. |
|
Nombre maximal d’objets de journal volumineux par journal |
10 LLOs Disponible dans l'est des États-Unis (Virginie du Nord), l'ouest des États-Unis (Oregon), l'Europe (Francfort), l'Asie-Pacifique (Sydney), l'Asie-Pacifique (Mumbai), l'est des États-Unis (Ohio), l'Europe (Irlande), l'Asie-Pacifique (Tokyo) et l'Asie-Pacifique (Singapour). |
Un seul enregistrement de journal peut en contenir jusqu'à 10 LLOs. |
Note
Les limites de compte pour les journaux sont partagées entre le kit SDK et le nouveau point de terminaison des journaux.
