Vous pouvez utiliser l’interface de ligne de commande pour instrumenter vos fonctions AWS Lambda avec Datadog. L’interface de ligne de commande permet d’instrumenter vos fonctions Lambda existantes en modifiant leur configuration. De ce fait, elle ne nécessite pas un redéploiement. Il s’agit du moyen le plus rapide de profiter des fonctionnalités de surveillance sans serveur de Datadog.

Vous pouvez également ajouter la commande à vos pipelines de CI/CD pour instrumenter toutes vos applications sans serveur. Exécutez la commande après le déploiement normal de votre application sans serveur, de sorte que les modifications apportées par l’interface de ligne de commande Datadog ne soient pas écrasées.

Installation

Pour instrumenter vos fonctions Lambda à l’aide de la commande datadog-ci lambda instrument, suivez les instructions ci-dessous pour le runtime de votre choix :

• .NET
• Go
• Java
• Node.js
• Python
• Ruby

Commandes

instrument

Exécutez datadog-ci lambda instrument pour appliquer l’instrumentation Datadog à une fonction Lambda. Cette commande ajoute la bibliothèque Lambda Datadog et/ou l’extension Lambda Datadog sous forme de couches Lambda aux fonctions Lambda instrumentées, et modifie la configuration de ces fonctions Lambda.

datadog-ci lambda instrument -f <nom-fonction> -f <autre-nom-fonction> -r us-east-1 -v 46 -e 10

# Instrumenter une ou plusieurs fonctions en mode interactif
datadog-ci lambda instrument -i

# Instrumenter plusieurs fonctions qui correspondent à une expression régulière
datadog-ci lambda instrument --functions-regex <expression-régulière-valide> -r us-east-1 -v 46 -e 10

# Tester toutes les mises à jour
datadog-ci lambda instrument -f <nom-fonction> -f <autre-nom-fonction> -r us-east-1 -v 46 -e 10 --dry

uninstrument

Exécutez datadog-ci lambda uninstrument pour annuler l’instrumentation Datadog dans une fonction Lambda. Cette commande supprime automatiquement la configuration Datadog, comme la bibliothèque Lambda Datadog et les couches de l’extension Lambda Datadog, ainsi que les autres configurations appliquées par datadog-ci.

# Annuler l'instrumentation de plusieurs fonctions dont les noms sont indiqués
datadog-ci lambda uninstrument -f <nom-fonction> -f <autre-nom-fonction> -r us-east-1

# Annuler l'instrumentation d'une ou de plusieurs fonctions en mode interactif
datadog-ci lambda uninstrument -i

# Annuler l'instrumentation de plusieurs fonctions qui correspondent à une expression régulière
datadog-ci lambda uninstrument --functions-regex <expression-régulière-valide> -r us-east-1

# Tester toutes les mises à jour
datadog-ci lambda uninstrument -f <nom-fonction> -f <autre-nom-fonction> -r us-east-1 --dry

Consultez la section Configuration pour obtenir plus de paramètres.

Configuration

Identifiants AWS

Vous devez disposer d’identifiants AWS valides et autorisés à accéder aux services Lambda et CloudWatch dans lesquels vous exécutez les commandes datadog-ci lambda.

Variables d’environnement

Vous devez exposer ces variables d’environnement dans l’environnement où vous exécutez datadog-ci lambda instrument :

Arguments

La configuration peut être effectuée à l’aide d’arguments de ligne de commande ou d’un fichier de configuration JSON (voir la section suivante).

instrument

Vous pouvez transmettre les arguments suivants à instrument pour spécifier son comportement. Ces arguments remplaceront les valeurs définies dans le fichier de configuration, le cas échéant.

uninstrument

Les arguments suivants sont transmis à uninstrument pour spécifier son comportement. Ces arguments remplaceront les valeurs définies dans le fichier de configuration, le cas échéant.

Tout autre argument indiqué dans le tableau instrument, mais pas en dessous, sera ignoré afin de vous permettre d’annuler l’instrumentation plus rapidement, si besoin.

Fichier de configuration

Au lieu de fournir des arguments, vous pouvez créer un fichier de configuration dans votre projet et exécuter simplement la commande datadog-ci lambda {instrument|uninstrument} --config datadog-ci.json sur chaque déploiement. Spécifiez le datadog-ci.json en utilisant l’argument --config et utilisez cette structure de fichier de configuration :

{
    "lambda": {
        "layerVersion": 10,
        "extensionVersion": 8,
        "functions": ["arn:aws:lambda:us-east-1:000000000000:function:autoinstrument"],
        "region": "us-east-1",
        "tracing": true,
        "mergeXrayTraces": true,
        "captureLambdaPayload": true,
        "forwarder": "arn:aws:lambda:us-east-1:000000000000:function:datadog-forwarder",
        "logLevel": "debug",
        "service":"some-service",
        "version":"b17s47h3w1n",
        "environment":"staging",
        "extraTags":"layer:api,team:intake"
    }
}

Communauté

Si vous avez des commentaires ou des questions concernant les fonctionnalités, rejoignez le canal #serverless de la communauté Slack Datadog.