Points de terminaison OTLP - Amazon CloudWatch

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.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.

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 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.