Configuration du traçage pour les fonctions Lambda d' Ruby

Pour activer le traçage des fonctions Lambda d' Ruby s via la console Web d' AWS, procédez comme suit :

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

   1. Sur la page de configuration de votre fonction Lambda, cliquez sur « Layers ».

      

   2. Dans la zone « Calques », cliquez sur « Ajouter un calque ».

      

   3. Sur la page « Ajouter un calque », sélectionnez l'option « Spécifier un ARN » comme source du calque.

   4. Dans le champ « Spécifier un ARN », copiez-collez l'ARN 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.

   5. Cliquez sur Ajouter.

      

2. Implémentez la fonction de gestion :

   Enveloppez votre fonction lambda « Ruby » dans un Instana.serverless.wrap_aws bloc, en transmettant l'événement et le contexte en tant qu'arguments, comme le montre l'exemple suivant. Cet wrapper crée automatiquement des balises `span` pour votre invocation Lambda et gère le contexte de traçage.

   require 'bundler/setup'
   
   require 'json'
   require 'instana'
   
   def lambda_handler(event:, context:)
     Instana.serverless.wrap_aws(event, context) do
       # Your original Lambda function code goes here
       {
         statusCode: 200,
         body: {
           message: "Hello World!",
         }.to_json
       }
     end
   end
    

   Grâce à l'approche par wrapper, vous pouvez conserver le nom de votre fonction de gestionnaire existante tout en ajoutant des fonctionnalités de traçage d' Instana. Vous n'avez pas besoin de modifier la configuration de votre gestionnaire Lambda dans la console d' AWS.

3. Définissez les variables d'environnement :

   Ajoutez les variables d'environnement suivantes :

   • INSTANA_ENDPOINT_URL: Votre point de terminaison de surveillance sans serveur. Veillez à utiliser la valeur correcte pour votre région qui commence par https://serverless-.
   • INSTANA_AGENT_KEY: Votre clé d'agent.
   • LAMBDA_HANDLER: Votre gestionnaire personnalisé, si vous n'utilisez pas le gestionnaire par défaut lambda_function.lambda_handler.

   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 Sources de données > Installer des agents > AWS Lambda.

L'exemple suivant présente une commande CLI d' AWS qui peut servir de point de départ si vous souhaitez automatiser l'intégration d' Instana à vos fonctions AWS Lambda :

# 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={INSTANA_ENDPOINT_URL=... , INSTANA_AGENT_KEY=... , LAMBDA_HANDLER=...}""