Le plug-in Serverless Datadog configure vos fonctions afin qu’elles envoient des métriques, traces et logs à Datadog via l’extension Lambda Datadog.

Pour installer et configurer le plug-in Serverless Datadog, suivez les étapes suivantes :

1. Pour installer le plug-in Serverless Datadog :

   serverless plugin install --name serverless-plugin-datadog
   

2. Modifiez votre fichier serverless.yml :

   custom:
     datadog:
       site: <DATADOG_SITE>
       apiKeySecretArn: <DATADOG_API_KEY_SECRET_ARN>
   

   Copy

   Renseignez les paramètres fictifs comme suit :

   • Remplacez <SITE_DATADOG> par datadoghq.com (assurez-vous que le SITE sélectionné à droite est correct).
   • Remplacez <DATADOG_API_KEY_SECRET_ARN> par l’ARN du secret AWS où votre clé d’API Datadog est stockée en toute sécurité. La clé doit être stockée sous forme de chaîne de texte brut (et non en tant que blob JSON). L’autorisation secretsmanager:GetSecretValue est requise. Pour effectuer un test rapide, vous pouvez également utiliser apiKey et définir la clé d’API Datadog sous forme de texte brut.

   Pour obtenir plus de détails ainsi que des paramètres supplémentaires, consultez la documentation relative au plug-in.

La macro CloudFormation Datadog transforme automatiquement votre modèle d’application SAM dans le but d’installer Datadog sur vos fonctions à l’aide des couches Lambda. De plus, elle configure vos fonctions afin qu’elles envoient des métriques, traces et logs à Datadog via l’extension Lambda Datadog.

1. Installer la macro CloudFormation Datadog

   Exécutez la commande suivante avec vos identifiants AWS pour déployer une pile CloudFormation qui installe la ressource AWS de la macro. Vous ne devez installer la macro qu’une seule fois par région de votre compte. Remplacez create-stack par update-stack pour installer la dernière version de la macro.

   aws cloudformation create-stack \
     --stack-name datadog-serverless-macro \
     --template-url https://datadog-cloudformation-template.s3.amazonaws.com/aws/serverless-macro/latest.yml \
     --capabilities CAPABILITY_AUTO_EXPAND CAPABILITY_IAM
   

   La macro est désormais déployée et utilisable.

2. Instrumenter vos fonctions Lambda

   Ajoutez la transformation DatadogServerless après la transformation AWS::Serverless sous la section Transform de votre fichier template.yml pour SAM.

   Transform:
     - AWS::Serverless-2016-10-31
     - Name: DatadogServerless
       Parameters:
         stackName: !Ref "AWS::StackName"
         javaLayerVersion: 19
         extensionLayerVersion: 75
         site: "<DATADOG_SITE>"
         apiKeySecretArn: "<DATADOG_API_KEY_SECRET_ARN>"
   

   Copy

   Renseignez les paramètres fictifs comme suit :

   • Remplacez <SITE_DATADOG> par datadoghq.com (assurez-vous que le SITE sélectionné à droite est correct).
   • Remplacez <DATADOG_API_KEY_SECRET_ARN> par l’ARN du secret AWS où votre clé d’API Datadog est stockée en toute sécurité. La clé doit être stockée sous forme de chaîne de texte brut (et non en tant que blob JSON). L’autorisation secretsmanager:GetSecretValue est requise. Pour effectuer un test rapide, vous pouvez utiliser apiKey et définir la clé d’API Datadog sous forme de texte brut.

   Pour obtenir plus de détails ainsi que des paramètres supplémentaires, consultez la documentation relative à la macro.

La bibliothèque CDK Construct Datadog installe automatiquement Datadog sur vos fonctions à l’aide des couches Lambda. Elle configure vos fonctions afin qu’elles envoient des métriques, traces et logs à Datadog via l’extension Lambda Datadog.

1. Installer la bibliothèque CDK Construct Datadog

   Node.js :

   # For AWS CDK v1
   npm install datadog-cdk-constructs --save-dev
   
   # For AWS CDK v2
   npm install datadog-cdk-constructs-v2 --save-dev
   

   Python :

   # For AWS CDK v1
   pip install datadog-cdk-constructs
   
   # For AWS CDK v2
   pip install datadog-cdk-constructs-v2
   

2. Instrumenter vos fonctions Lambda

   Node.js :

   // For AWS CDK v1
   import { Datadog } from "datadog-cdk-constructs";
   
   // For AWS CDK v2
   import { Datadog } from "datadog-cdk-constructs-v2";
   
   const datadog = new Datadog(this, "Datadog", {
       javaLayerVersion: 19,
       extensionLayerVersion: 75,
       site: "<DATADOG_SITE>",
       apiKeySecretArn: "<DATADOG_API_KEY_SECRET_ARN>"
   });
   datadog.addLambdaFunctions([<LAMBDA_FUNCTIONS>])
   

   Python :

   # For AWS CDK v1
   from datadog_cdk_constructs import Datadog
   
   # For AWS CDK v2
   from datadog_cdk_constructs_v2 import Datadog
   
   datadog = Datadog(self, "Datadog",
       java_layer_version=19,
       extension_layer_version=75,
       site="<DATADOG_SITE>",
       api_key_secret_arn="<DATADOG_API_KEY_SECRET_ARN>",
     )
   datadog.add_lambda_functions([<LAMBDA_FUNCTIONS>])
   

   Renseignez les paramètres fictifs comme suit :

   • Remplacez <SITE_DATADOG> par datadoghq.com (assurez-vous que le SITE sélectionné à droite est correct).
   • Remplacez <DATADOG_API_KEY_SECRET_ARN> par l’ARN du secret AWS où votre clé d’API Datadog est stockée de façon sécurisée. La clé doit être stockée sous forme de chaîne de texte brut (et non en tant que blob JSON). Assurez-vous que le rôle d’exécution de votre fonction Lambda dispose de l’autorisation IAM secretsmanager:GetSecretValue pour lire la valeur du secret. Pour effectuer un test rapide, vous pouvez utiliser apiKey et définir la clé d’API Datadog sous forme de texte brut.

   Pour obtenir plus de détails ainsi que des paramètres supplémentaires, consultez la documentation relative à la bibliothèque CDK Datadog.

1. Installer l’extension Lambda Datadog

   COPY --from=public.ecr.aws/datadog/lambda-extension:<TAG> /opt/. /opt/
   

   Remplacez <TAG> par un numéro de version spécifique (par exemple, 75) ou par latest. Il en va de même pour Alpine : indiquez un numéro de version spécifique (par exemple, 75-alpine) ou latest-alpine. Consultez le référentiel Amazon ECR pour découvrir la liste complète des tags autorisés.

2. Installer le client APM Java Datadog

   RUN yum -y install tar wget gzip
   RUN wget -O /opt/java/lib/dd-java-agent.jar 'https://dtdg.co/latest-java-tracer'
   

3. Définir les variables d’environnement requises

   • Définissez AWS_LAMBDA_EXEC_WRAPPER sur /opt/datadog_wrapper.
   • Définissez DD_SITE sur datadoghq.com (assurez-vous que le SITE sélectionné à droite est correct).
   • Définissez DD_API_KEY_SECRET_ARN sur l’ARN du secret AWS où votre clé d’API Datadog est stockée de façon sécurisée. La clé doit être stockée sous forme de chaîne de texte brut (et non en tant que blob JSON). L’autorisation secretsmanager:GetSecretValue est requise. Pour effectuer un test rapide, vous pouvez également utiliser DD_API_KEY et définir la clé d’API Datadog sous forme de texte brut.

Le module Terraform lambda-datadog enveloppe la ressource aws_lambda_function et configure automatiquement votre fonction Lambda pour la surveillance sans serveur Datadog en :

• Ajoutant les couches Lambda Datadog
• Redirigeant le gestionnaire Lambda
• Activant la collecte et l’envoi de métriques, traces, et logs à Datadog

module "lambda-datadog" {
  source  = "DataDog/lambda-datadog/aws"
  version = "2.0.0"

  environment_variables = {
    "DD_API_KEY_SECRET_ARN" : "<ARN_SECRET_CLÉ_API_DATADOG>"
    "DD_ENV" : "<ENVIRONNEMENT>"
    "DD_SERVICE" : "<NOM_SERVICE>"
    "DD_SITE": "<SITE_DATADOG>"
    "DD_VERSION" : "<VERSION>"
  }

  datadog_extension_layer_version = 67
  datadog_java_layer_version = 15

  # aws_lambda_function arguments
}

1. Remplacez la ressource aws_lambda_function par le module Terraform lambda-datadog. Indiquez ensuite le source et la version du module.

2. Définissez les arguments de aws_lambda_function :

   Tous les arguments disponibles dans la ressource aws_lambda_function sont disponibles dans ce module Terraform. Les arguments définis comme des blocs dans la ressource aws_lambda_function sont redéfinis comme des variables avec leurs arguments imbriqués.

   Par exemple, dans aws_lambda_function, environment est défini comme un bloc avec un argument variables. Dans le module Terraform lambda-datadog, la valeur de environment_variables est transmise à l’argument environment.variables dans aws_lambda_function. Référez-vous à la section entrées pour une liste complète des variables de ce module.

3. Remplissez les paramètres fictifs de la variable d’environnement :

   • Remplacez <DATADOG_API_KEY_SECRET_ARN> par l’ARN du secret AWS où votre clé d’API Datadog est stockée en toute sécurité. La clé doit être stockée sous forme de chaîne de texte brut (et non en tant que blob JSON). L’autorisation secretsmanager:GetSecretValue est requise. Pour effectuer un test rapide, vous pouvez également utiliser la variable d’environnement DD_API_KEY et définir votre clé d’API Datadog sous forme de texte brut.
   • Remplacez <ENVIRONMENT> par l’environnement de la fonction Lambda, comme prod ou staging
   • Remplacez <NOM_SERVICE> par le nom du service de la fonction Lambda
   • Remplacez <SITE_DATADOG> par datadoghq.com (assurez-vous que le site Datadog est sélectionné sur cette page).
   • Remplacez <VERSION> par le numéro de version de la fonction Lambda

4. Sélectionnez les versions de la couche de l’extension Lambda Datadog et de la couche Datadog Lambda Java à utiliser. Si rien n’est indiqué, les dernières versions de la couche seront utilisées.

  datadog_extension_layer_version = 67
  datadog_java_layer_version = 15

1. Installer le traceur Datadog

   Configurez les couches pour votre fonction Lambda à l’aide de l’ARN, en respectant le format suivant :

   # Use this format for Lambda deployed in AWS commercial regions
   arn:aws:lambda:<AWS_REGION>:464622532012:layer:dd-trace-java:19
   
   # Use this format for Lambda deployed in AWS GovCloud regions
   arn:aws-us-gov:lambda:<AWS_REGION>:002406178527:layer:dd-trace-java:19
   

   Remplacez <AWS_REGION> par une région AWS valide, telle que us-east-1.

2. Installer l’extension Lambda Datadog

   Configurez les couches pour votre fonction Lambda à l’aide de l’ARN, en respectant le format suivant :

   # Use this format for x86-based Lambda deployed in AWS commercial regions
   arn:aws:lambda:<AWS_REGION>:464622532012:layer:Datadog-Extension:75
   
   # Use this format for arm64-based Lambda deployed in AWS commercial regions
   arn:aws:lambda:<AWS_REGION>:464622532012:layer:Datadog-Extension-ARM:75
   
   # Use this format for x86-based Lambda deployed in AWS GovCloud regions
   arn:aws-us-gov:lambda:<AWS_REGION>:002406178527:layer:Datadog-Extension:75
   
   # Use this format for arm64-based Lambda deployed in AWS GovCloud regions
   arn:aws-us-gov:lambda:<AWS_REGION>:002406178527:layer:Datadog-Extension-ARM:75
   

   Remplacez <AWS_REGION> par une région AWS valide, telle que us-east-1.

3. Définir les variables d’environnement requises

   • Définissez AWS_LAMBDA_EXEC_WRAPPER sur /opt/datadog_wrapper.
   • Définissez DD_SITE sur datadoghq.com (assurez-vous que le SITE sélectionné à droite est correct).
   • Définissez DD_API_KEY_SECRET_ARN sur l’ARN du secret AWS où votre clé d’API Datadog est stockée de façon sécurisée. La clé doit être stockée sous forme de chaîne de texte brut (et non en tant que blob JSON). L’autorisation secretsmanager:GetSecretValue est requise. Pour effectuer un test rapide, vous pouvez également utiliser DD_API_KEY et définir la clé d’API Datadog sous forme de texte brut.