AWS X-Ray

Crawler

Présentation

AWS X-Ray permet aux développeurs de tracer des applications distribuées qui ont été créées grâce à des 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 sur les fonctions sans serveur, consultez la documentation dédiée.

Implémentation

Installation

Pour commencer, activez l’intégration AWS et ajoutez les autorisations suivantes au document de stratégie dans votre rôle AWS/Datadog :

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 clé principale client pour chiffrer les traces, ajoutez la méthode kms:Decrypt à la stratégie au sein de laquelle la ressource correspond à la clé principale client utilisée pour X-Ray.

Activer AWS X-Ray pour vos fonctions

Pour tirer le meilleur parti de l’intégration AWS X-Ray, vous devez l’activer pour vos fonctions Lambda et vos instances d’API Gateway, mais aussi installer les bibliothèques de tracing dans vos fonctions Lambda.

Utilisation du plug-in Serverless Framework (conseillé)

Le plug-in Serverless Framework de Datadog active automatiquement X-Ray pour vos fonctions Lambda et vos instances d’API Gateway. Le plug-in se charge également d’ajouter la couche Lambda Datadog à toutes vos fonctions Node et Python.

Pour apprendre à utiliser le plug-in Serverless Framework, lisez cet article de blog et consultez la documentation (en anglais).

Enfin, installez et importez la bibliothèque client X-Ray dans votre fonction Lambda.

Configuration manuelle

1. Accédez à la fonction Lambda dans la console AWS que vous souhaitez instrumenter. Dans la section « Debugging and error handling », cochez la case Enable active tracing afin d’activer X-Ray pour cette fonction.
2. Accédez à la console API Gateway. Sélectionnez votre API ainsi que l’étape. Ensuite, depuis l’onglet Logs/Tracing sélectionnez Enable X-Ray Tracing. Pour que ces changements prennent effet, accédez à Resources dans le volet de navigation sur la gauche et sélectionnez Actions. Ensuite, cliquez sur Deploy API.

Remarque : la couche Lambda Datadog et les bibliothèques client intègrent le X-Ray SDK en tant que dépendance. Vous n’avez donc pas besoin de l’installer dans vos projets.

Enfin, installez et importez la bibliothèque client X-Ray dans votre fonction Lambda.

Installer les bibliothèques client X-Ray

La bibliothèque client X-Ray vous permet d’analyser vos requêtes HTTP envoyées aux API ainsi que les appels des services DynamoDB, S3, MySQL et PostgreSQL (auto-hébergé, Amazon RDS et Amazon Aurora), SQS et SNS.

Installez la bibliothèque, importez-la dans vos projets Lambda, puis patchez les services que vous souhaitez instrumenter.

$ npm install aws-xray-sdk   # pour les utilisateurs de NPM
$ yarn add aws-xray-sdk      # pour les utilisateurs de Yarn

var AWSXRay = require('aws-xray-sdk-core');
var AWS = AWSXRay.captureAWS(require('aws-sdk'));

var AWSXRay = require('aws-xray-sdk');
AWSXRay.captureHTTPsGlobal(require('http'));
var http = require('http');

var AWSXRay = require('aws-xray-sdk');
var pg = AWSXRay.capturePostgres(require('pg'));
var client = new pg.Client();

var AWSXRay = require('aws-xray-sdk');
var mysql = AWSXRay.captureMySQL(require('mysql'));
...
var connection = mysql.createConnection(config);

$ pip install aws-xray-sdk

from aws_xray_sdk.core import xray_recorder
from aws_xray_sdk.core import patch_all
patch_all()

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.