CLI Serverless Datadog
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

CLI Serverless Datadog

Cette fonctionnalité est en version bêta ouverte. Si vous avez des questions ou des problèmes, faites-le-nous savoir en créant un ticket dans notre référentiel.

Vous pouvez utiliser l’interface de ligne de commande pour instrumenter vos fonctions AWS Lambda avec Datadog.

Avant de commencer

Exécutez la commande suivante pour faire en sorte que vos identifiants AWS AWS_ACCESS_KEY_ID et AWS_SECRET_ACCESS_KEY soient disponibles dans votre environnement, ou utilisez l’une des méthodes d’authentification prises en charge par le SDK AWS pour JS.


export AWS_ACCESS_KEY_ID="<ID CLÉ ACCÈS>"
export AWS_SECRET_ACCESS_KEY="<CLÉ ACCÈS>"

Téléchargez Datadog CI.

Configuration

La configuration se fait via un fichier JSON. Spécifiez le fichier datadog-ci.json en utilisant l’argument --config et la structure de fichier de configuration suivante :

{
    "lambda": {
        "layerVersion": 10,
        "functions": ["arn:aws:lambda:us-east-1:000000000000:function:autoinstrument"],
        "region": "us-east-1",
        "tracing": true,
        "mergeXrayTraces": true,
        "forwarder": "arn:aws:lambda:us-east-1:000000000000:function:datadog-forwarder"
    }
}

Commandes

Utilisez instrument pour appliquer l’instrumentation Datadog à une fonction Lambda.

L’interface de ligne de commande accepte l’argument --function (ou -f) pour spécifier la fonction à instrumenter. Cette valeur doit être un ARN de fonction.

datadog-ci lambda instrument --function arn:aws:lambda:us-east-1:000000000000:function:autoinstrument --layerVersion 10
# Les arguments peuvent également être utilisés sous forme raccourcie
datadog-ci lambda instrument -f autoinstrument -f another-func -r us-east-1 -v 10
# Dry run de toutes les commandes de mise à jour
datadog-ci lambda instrument -f autoinstrument -r us-east-1 -v 10 --dry

Tous les arguments :

ArgumentRaccourciDescriptionValeur par défaut
–function-fPermet de spécifier une fonction à instrumenter
–region-rRégion par défaut à utiliser, lorsque la région n’est pas spécifiée dans l’ARN de fonction
–layerVersion-vVersion de la couche Datadog à appliquer. La version dépend du runtime utilisé. Pour connaître la version de la couche la plus récente, consultez les notes de version du référentiel datadog-lambda-layer pour JS ou python.
–tracingDéfinit si le tracing dd-trace doit être activé ou non sur votre fonction Lambda.true
–mergeXrayTracesDéfinit si les traces dd-trace doivent être associées ou non aux traces AWS X-Ray. Utile pour le tracing de spans API Gateway.false
–flushMetricsToLogsDéfinit si les métriques doivent être envoyées de façon asynchrone ou non à Datadog via notre Forwardertrue
–forwarderL’ARN du Forwarder Datadog auquel associer le LogGroup de cette fonction.
–dry-dPrévisualiser les modifications que la commande exécutée appliquerait.false