Configuration du traçage natif pour les fonctions d' AWS Lambda s basées sur l' Java

Pour activer le traçage des fonctions Lambda exécutées au sein d'un cluster de serveurs ( JVM ), procédez comme suit dans l'interface utilisateur d' AWS Lambda :

1. Ajoutez la couche Lambda « Instana » à votre fonction :

   1. Dans l'onglet Configuration de votre fonction Lambda, cliquez sur Couches > Ajouter une couche.

      

   2. Dans la fenêtre « Ajouter une couche à la fonction », sélectionnez « Fournir un ARN de couche », puis copiez-collez l'ARN (Amazon Resource Name) de la couche Lambda « Instana » correspondant à votre région. Vous trouverez l'ARN correspondant à la couche Lambda « Instana » dans la section « Couches Lambda » du site Instana.

      

   3. Cliquez sur Ajouter.

2. Configurez les variables d'environnement suivantes :

   Variables d'environnement	Valeur
   JAVA_TOOL_OPTIONS	-javaagent:/opt/instana/standalone-collector.jar
   INSTANA_ENDPOINT_URL	<serverless_instana_endpoint> `
   INSTANA_AGENT_KEY	<your_instana_agent_key>

   Remarque : veillez à utiliser la valeur correspondant à votre région, qui commence par https://serverless-. Pour plus d'informations, consultez la section « Points de terminaison pour la surveillance sans serveur ».

   Vous pouvez également obtenir les valeurs correctes de ces variables d'environnement depuis l'interface utilisateur d' Instana. Pour obtenir les valeurs correctes de ces variables d'environnement, cliquez sur Plus > Agents > Installer des agents > Plateforme : AWS > Technologie : AWS Lambda dans l'interface utilisateur d' Instana.

3. Sauvegardez la définition de fonction Lambda.

   

Si vous souhaitez automatiser l'intégration d' Instana s pour vos fonctions Lambda de l' AWS, consultez l'exemple de commande CLI suivant : AWS

# Do not copy and paste this verbatim!
# It will overwrite any previously defined collection of layers and
# environment variables.
aws --region $YOUR_REGION lambda update-function-configuration \
  --function-name $YOUR_LAMBDA_FUNCTION_NAME \
  --layers $INSTANA_LAYER_ARN \
  --environment ""Variables={JAVA_TOOL_OPTIONS=-javaagent:/opt/instana/standalone-collector.jar, INSTANA_ENDPOINT_URL=... , INSTANA_AGENT_KEY=... , ...}""
 

Les ARN de la dernière version des couches de l' AWS Lambda s pour Java, classées par région, sont les suivantes :

Le modèle est arn:aws:lambda:${region}:410797082306:layer:instana-java:${layer-version} (ou arn:aws-cn:lambda:${region}:107998019096:layer:instana-java:${layer-version} pour les régions AWS en Chine).