Utilisez le X-Ray API - AWS X-Ray

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.

Utilisez le X-Ray API

Si le X-Ray SDK ne supporte pas votre langage de programmation, vous pouvez utiliser le X-Ray APIs directement ou le AWS Command Line Interface (AWS CLI) pour appeler API les commandes X-Ray. Suivez les instructions suivantes pour choisir la manière dont vous interagissez avec API :

  • Utilisez le AWS CLI pour une syntaxe plus simple à l'aide de commandes préformatées ou d'options dans votre requête.

  • Utilisez le X-Ray API directement pour un maximum de flexibilité et de personnalisation pour les demandes que vous faites à X-Ray.

Si vous utilisez API directement le X-Ray au lieu du AWS CLI, vous devez paramétrer votre demande dans le bon format de données et vous devrez peut-être également configurer l'authentification et la gestion des erreurs.

Le schéma suivant indique comment choisir le mode d'interaction avec le X-Ray API :

X-Ray affiche des informations détaillées sur les demandes de candidature.

Utilisez le X-Ray API pour envoyer les données de suivi directement à X-Ray. Le X-Ray API prend en charge toutes les fonctions disponibles dans le X-RaySDK, y compris les actions courantes suivantes :

  • PutTraceSegments— Télécharge les documents segmentés sur X-Ray.

  • BatchGetTraces— Récupère une liste de traces dans une liste de tracesIDs. Chaque trace récupérée est une collection de documents segmentés provenant d'une seule demande.

  • GetTraceSummaries— Récupère IDs et annote les traces. Vous pouvez spécifier a FilterExpression pour récupérer un sous-ensemble de résumés de traces.

  • GetTraceGraph— Récupère un graphique de service pour un ID de trace spécifique.

  • GetServiceGraph— Récupère un document JSON formaté qui décrit les services qui traitent les demandes entrantes et appellent les demandes en aval.

Vous pouvez également utiliser le AWS Command Line Interface (AWS CLI) dans le code de votre application pour interagir par programmation avec X-Ray. Il AWS CLI prend en charge toutes les fonctions disponibles dans le X-RaySDK, y compris celles des autres AWS services. Les fonctions suivantes sont des versions des API opérations répertoriées précédemment dans un format plus simple :

  • put-trace-segments— Télécharge les documents segmentés sur X-Ray.

  • batch-get-traces— Récupère une liste de traces dans une liste de tracesIDs. Chaque trace récupérée est une collection de documents segmentés provenant d'une seule demande.

  • get-trace-summaries— Récupère IDs et annote les traces. Vous pouvez spécifier a FilterExpression pour récupérer un sous-ensemble de résumés de traces.

  • get-trace-graph— Récupère un graphique de service pour un ID de trace spécifique.

  • get-service-graph— Récupère un document JSON formaté qui décrit les services qui traitent les demandes entrantes et appellent les demandes en aval.

Pour commencer, vous devez installer le AWS CLIpour votre système d'exploitation. AWS supports Linux macOS et systèmes Windows d'exploitation. Pour plus d'informations sur la liste des commandes X-Ray, consultez le guide AWS CLI Command Reference pour X-Ray.

Rubriques