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 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.
. 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. Consultez Mise en route pour démarrer.
Endpoint de log
Le point de terminaison des logs suit le modèlehttps://logs.
. Par exemple, pour leRégion AWS
.amazonaws.com/v1/logsUS 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.
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 |
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 autorisé de spans dans une requête 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. |
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. |
Nombre maximum d'événements/demande |
10 000 journaux |
Le nombre maximum autorisé de spans dans une requête 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. |
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 |
Note
Les limites de compte pour les journaux sont partagées entre le SDK et le nouveau point de terminaison Logs.