FAQ sur AWS X-Ray

Une trace X-Ray est un ensemble de points de données qui partagent le même identifiant de trace. Par exemple, lorsqu'un client envoie une requête à votre application, un identifiant de trace unique est attribué à cette demande. Lorsque la requête parcourt les différents services dans votre application, les services relaient des informations concernant celle-ci à X-Ray à l'aide de son identifiant de trace unique. L'information relayée par chaque service de votre application à X-Ray est un segment. Une trace est un ensemble de segments.

Un segment X-Ray englobe tous les points de données pour un composant unique (ex. : un service d'autorisation) de l'application distribuée. Les segments incluent des données définies par le système et par les utilisateurs sous la forme d'annotations. Ils sont composés d'un ou plusieurs sous-segments représentant les appels à distance effectués depuis le service. Par exemple, lorsque votre application effectue un appel à une base de données en réponse à une requête, elle crée un segment pour cette requête, ainsi qu'un sous-segment représentant l'appel à la base de données et son résultat. Le sous-segment peut contenir des données comme la requête, la table utilisée, l'horodatage et le statut d'erreur.

Une annotation X-Ray correspond à des données définies par le système ou par l'utilisateur et associées à un segment. Un segment peut contenir plusieurs annotations. Parmi les annotations définies par le système, on trouve notamment les données ajoutées au segment par les services AWS. Les annotations définies par l'utilisateur sont, quant à elles, des métadonnées ajoutées à un segment par un développeur. Par exemple, lorsqu'un segment est créé par votre application, les données de région pour les appels de services AWS peuvent être automatiquement ajoutées à celui-ci. Vous pouvez également choisir d'ajouter les données de région vous-même pour les appels à des services autres que ceux d'AWS.

Les erreurs X-Ray sont des annotations système associées à un segment et correspondant à un appel renvoyant une réponse d'erreur. L'erreur est composée du message d'erreur, de la trace du stack et de toute information supplémentaire (par exemple, version ou ID de validation) permettant d'associer l'erreur à un fichier source.

Pour offrir une expérience performante et économique, X-Ray ne collecte pas les données de toutes les requêtes envoyées à une application. Au lieu de cela, il collecte les données pour un nombre de requêtes significatif d'un point de vue statistique. X-Ray ne doit pas être utilisé comme un outil d'audit ou de conformité, car il ne garantit pas l'exhaustivité des données.

Le démon X-Ray collecte les traces et les envoie au service X-Ray pour agrégation, analyse et stockage. Le démon vous permet d'envoyer plus facilement des données au service X-Ray, au lieu d'utiliser directement les API.

Vous pouvez démarrer avec X-Ray en incluant le kit SDK du langage X-Ray dans votre application et en installant le démon X-Ray. Pour en savoir plus, consultez le guide de l'utilisateur de X-Ray.

X-Ray peut être utilisé avec des applications distribuées de n'importe quelle taille, afin de suivre et de déboguer aussi bien des requêtes synchrones que des événements asynchrones. Par exemple, X-Ray peut être utilisé pour suivre des requêtes Web adressées à une application Web ou des événements asynchrones utilisant les files d'attente Amazon SQS.

Vous pouvez utiliser X-Ray avec les applications exécutées sur EC2, ECS, Lambda, Amazon SQS, Amazon SNS et Elastic Beanstalk. En outre, le kit SDK X-Ray capture automatiquement les métadonnées des appels d'API aux services AWS effectués à l'aide du kit SDK AWS. Le kit SDK de X-Ray fournit également des modules complémentaires pour les pilotes MySQL et PostgreSQL.

Si vous utilisez Elastic Beanstalk, vous devrez inclure les bibliothèques X-Ray propres au langage dans le code de votre application. Pour les applications exécutées sur d'autres services AWS, comme EC2 ou ECS, vous devrez installer le démon X-Ray et instrumenter le code de votre application.

Oui, X-Ray fournit un ensemble d'API pour l'ingestion des données de requête, l'interrogation de traces et la configuration du service. Vous pouvez utiliser l'API X-Ray pour développer des applications d'analyse et de visualisation en plus de celles fournies par X-Ray.

Oui. X-Ray enregistre tous les appels d’API en tant qu’événements de gestion. Il enregistre également les appels sur les traces en tant qu’événements de données, notamment sur PutTraceSegments et GetTimeSeriesServiceStatistics, entre autres API. Les événements liés aux données ne sont pas enregistrés par défaut. Pour enregistrer les événements liés aux données, vous devez configurer votre historique CloudTrail ou votre magasin de données d’événements pour les collecter.

Consultez la section Produits et services régionaux pour en savoir plus.

Oui, vous pouvez utiliser X-Ray pour suivre les requêtes qui circulent dans des applications ou services étalés sur plusieurs régions. Les données X-Ray sont stockées au niveau local pour la région traitée, mais incluent suffisamment d'informations pour permettre aux applications clientes de combiner les données et d'offrir une visualisation globale des traces. L'annotation de région pour les services AWS sera ajoutée automatiquement. Toutefois, les clients devront instrumenter les services personnalisés pour ajouter l'annotation régionale, afin de tirer parti de la prise en charge inter-régions.

Les données de trace envoyées à X-Ray peuvent généralement être récupérées et filtrées dans les 30 secondes suivant leur réception par le service.

X-Ray conserve les données de trace des 30 derniers jours. Vous pouvez donc interroger les données de trace 30 jours en arrière.

X-Ray s'efforce de présenter des informations de trace complètes. Toutefois, dans certaines situations (problèmes de connectivité, retard de réception des segments, etc.), il est possible que les informations de trace fournies par les API de X-Ray soient partielles. Dans ces situations, X-Ray marque ces traces comme incomplètes ou partielles.

Oui, le démon X-Ray peut assumer un rôle afin de publier des données dans un compte différent de celui dans lequel il est exécuté. Ceci vous permet de publier des données issues de différents composants de votre application dans un compte central.