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.
Utiliser un SDK
Utilisez un SDK si vous souhaitez utiliser une interface de ligne de commande ou si vous avez besoin de fonctionnalités de suivi, de surveillance ou de journalisation plus personnalisées que celles disponibles dans un AWS Management Console. Vous pouvez également utiliser an AWS SDK pour développer des programmes utilisant le X-RayAPIs. Vous pouvez utiliser le AWS Distro for OpenTelemetry (ADOT) SDK ou le X-RaySDK.
Si vous utilisez unSDK, vous pouvez ajouter des personnalisations à votre flux de travail à la fois lorsque vous instrumentez votre application et lorsque vous configurez votre collecteur ou votre agent. Vous pouvez utiliser un SDK pour effectuer les tâches suivantes que vous ne pouvez pas effectuer avec un AWS Management Console :
-
Publiez des métriques personnalisées : échantillonnez des métriques à des résolutions élevées (jusqu'à 1 seconde), utilisez plusieurs dimensions pour ajouter des informations sur une métrique et agréger des points de données dans un ensemble de statistiques.
-
Personnalisez votre collecteur : personnalisez la configuration de n'importe quelle partie d'un collecteur, y compris le récepteur, le processeur, l'exportateur et le connecteur.
-
Personnalisez votre instrumentation : personnalisez les segments et les sous-segments, ajoutez des paires clé-valeur personnalisées en tant qu'attributs et créez des métriques personnalisées.
-
Créez et mettez à jour des règles d'échantillonnage par programmation.
Utilisez le ADOT SDK si vous souhaitez bénéficier de la flexibilité d'une solution standardisée OpenTelemetry SDK avec des couches supplémentaires de AWS sécurité et d'optimisation. The AWS Distro for OpenTelemetry (ADOT) SDK est un package indépendant du fournisseur qui permet l'intégration avec les backends d'autres fournisseurs et AWS non-services sans avoir à réinstrumenter votre code.
Utilisez le X-Ray SDK si vous utilisez déjà le X-RaySDK, si vous l'intégrez uniquement aux AWS backends et si vous ne voulez pas changer la façon dont vous interagissez avec X-Ray ou le code de votre application.
Pour plus d'informations sur chaque fonctionnalité, consultezChoisir entre The AWS Distro for OpenTelemetry et X-Ray SDKs.
Utilisez le ADOT SDK
ADOTSDKIl s'agit d'un ensemble d'open sourceAPIs, de bibliothèques et d'agents qui envoient des données aux services principaux. ADOTest pris en charge par AWS, s'intègre à plusieurs backends et agents et fournit un grand nombre de bibliothèques open source gérées par la OpenTelemetry communauté. Utilisez-le ADOT SDK pour instrumenter votre application et collecter des journaux, des métadonnées, des métriques et des traces. Vous pouvez également l'utiliser ADOT pour surveiller les services et définir une alarme en fonction de vos indicateurs CloudWatch.
Si vous utilisez le ADOTSDK, vous disposez des options suivantes, en association avec un agent :
-
Utiliser le ADOT SDK avec l'CloudWatch agent, c'est recommandé.
-
Utilisez le ADOT SDK avec le ADOTcollecteur
: recommandé si vous souhaitez utiliser un logiciel indépendant du fournisseur avec AWS plusieurs niveaux de sécurité et d'optimisation.
Pour utiliser le ADOTSDK, procédez comme suit :
-
Instrumentez votre application à l'aide du ADOTSDK. Pour plus d'informations, consultez la documentation de votre langage de programmation dans la documentation ADOT technique
. -
Configurez un ADOT collecteur pour lui indiquer où envoyer les données qu'il collecte.
Une fois que le ADOT collecteur a reçu vos données, il les envoie au backend que vous spécifiez dans la ADOT configuration. ADOTpeut envoyer des données à plusieurs backends, y compris à des fournisseurs extérieurs AWS, comme le montre le schéma suivant :
AWS mises à jour régulières ADOT pour ajouter des fonctionnalités et s'aligner sur le OpenTelemetry
-
Go
-
Java
-
JavaScript
-
Python
-
.NET
-
Ruby
-
PHP
Si vous utilisez Python, vous ADOT pouvez automatiquement instrumenter votre application. Pour commencer à utiliserADOT, consultez Introduction
Utilisez le X-Ray SDK
Le X-Ray SDK est un ensemble AWS APIs de bibliothèques qui envoient des données aux AWS services principaux. Utilisez le X-Ray SDK pour instrumenter votre application et collecter des données de trace. Vous ne pouvez pas utiliser le X-Ray SDK pour collecter des données de log ou de métrique.
Si vous utilisez le X-RaySDK, vous disposez des options suivantes, en association avec un agent :
-
Utilisez le X-Ray SDK avec le AWS X-Ray daemon — Utilisez-le si vous ne souhaitez pas mettre à jour le code de votre application.
-
Utiliser le X-Ray SDK avec l' CloudWatch agent — (recommandé) L' CloudWatch agent est compatible avec le X-RaySDK.
Pour utiliser le X-RaySDK, procédez comme suit :
-
Instrumentez votre application à l'aide du X-RaySDK.
-
Configurez un collecteur pour lui indiquer où envoyer les données qu'il collecte. Vous pouvez utiliser l' CloudWatch agent ou le daemon X-Ray pour collecter vos informations de suivi.
Une fois que le collecteur ou l'agent a reçu vos données, il les envoie à un AWS backend que vous spécifiez dans la configuration de l'agent. Le X-Ray SDK peut uniquement envoyer des données à un AWS backend, comme le montre le schéma suivant :
Si vous utilisezJava, vous pouvez utiliser le X-Ray SDK pour instrumenter automatiquement votre application. Pour commencer à utiliser le X-RaySDK, consultez les bibliothèques associées aux langages de programmation suivants :
