AWS X-Ray

Présentation

AWS X-Ray permet aux développeurs de tracer des applications distribuées qui ont été créées à l’aide de produits AWS. Cette intégration fournit des traces pour les fonctions Lambda dans la page de détails des fonctions sans serveur. Pour en savoir plus, consultez la documentation relative à la surveillance sans serveur.

Implémentation

Installation

Pour commencer, activez l’intégration AWS et assurez-vous que le document de stratégie du rôle de l’intégration Datadog comporte les autorisations suivantes :

xray:BatchGetTraces,
xray:GetTraceSummaries

L’autorisation GetTraceSummaries permet d’obtenir la liste des traces récentes, tandis que BatchGetTraces renvoie la totalité des traces.

Ensuite, activez l’intégration X-Ray dans Datadog.

Si vous utilisez une Customer Master Key (CMK) pour chiffrer les traces, ajoutez la méthode kms:Decrypt à la stratégie au sein de laquelle la ressource correspond à la CMK utilisée pour X-Ray.

Remarque : l’activation de l’intégration AWS X-Ray augmente le nombre de spans indexées. Cela peut avoir une incidence sur votre facturation.

Activer AWS X-Ray pour vos fonctions

1. Suivez les instructions d’AWS pour activer le tracing X-Ray sur vos fonctions Lambda et API Gateways.
2. Pour tirer le meilleur parti de l’intégration AWS X-Ray, installez le SDK X-Ray dans votre fonction Lambda.

Enrichir les traces X-Ray avec Datadog

Datadog peut enrichir les traces X-Ray à l’aide des spans et des métadonnées générées par le client APM Datadog. Il peut aussi les fusionner en une seule trace Datadog pour la même invocation Lambda.

1. Installez la surveillance sans serveur Datadog sur vos fonctions Lambda.
2. Définissez la variable d’environnement DD_MERGE_XRAY_TRACES sur true pour vos fonctions Lambda.

Données collectées

L’intégration AWS X-Ray récupère les données de trace d’AWS et ne recueille aucune métrique ni aucun log.