AWS Lambda Native Tracing for Node.js

La configurazione di Instana AutoTrace per Node.js consente di tracciare le funzioni AWS Lambda utilizzando il livello Lambda di Instana e un gestore di funzioni personalizzato.

Questo approccio non richiede alcuna modifica al codice della funzione Lambda; si attua esclusivamente tramite la configurazione. È anche adatto per essere automatizzato o incluso in una pipeline di distribuzione Lambda.

Per abilitare la traccia delle funzioni Lambda Node.js , effettuare le seguenti operazioni:

1. Aggiungi il livello Lambda " Instana " alla tua funzione.
   1. Nella pagina di configurazione della tua funzione Lambda, fai clic sulla casella Layers , quindi fai clic su Add a layer.

      

   2. Nella finestra pop-up che si apre, seleziona "Fornisci un ARN della versione del layer" e copia e incolla l'ARN del layer Lambda " Instana " corrispondente alla tua regione. È possibile trovare l'ARN corretto nella sezione "Lambda Layers" all'indirizzo Instana.

      

2. Configurare il gestore Lambda.

   Imposta il gestore su instana-aws-lambda-auto-wrap.handler se utilizzi CommonJS.

   Imposta il gestore su instana-aws-lambda-auto-wrap-esm.handler se utilizzi i moduli ES ( ES6 ) (disponibile a partire dalla versione 223 del layer).

   Per modificare l'impostazione del gestore Lambda, trovare la sezione "Impostazioni di base" nella pagina di configurazione.

   

   Fai clic su "Modifica" e inserisci instana-aws-lambda-auto-wrap.handler nel campo denominato "Handler".

   

   Il livello Lambda di Instana attiva automaticamente il gestore di runtime predefinito Node.jsindex.handler. Se si utilizza un gestore personalizzato, specificarlo nella variabile d'ambiente LAMBDA_HANDLER per avvisare il Lambda Layer di Instana. Consultare la sezione successiva per tutte le variabili di ambiente che devono essere impostate.

   Nota:

   La pagina di configurazione di Lambda potrebbe visualizzare un avviso del tipo “Lambda non riesce a trovare il file instana-aws-lambda-auto-wrap.js ”. Questo avviso potrebbe comparire anche in un secondo momento, quando si torna alla pagina di configurazione. Non lasciare che questo avvertimento ti distragga. L'handler è contenuto nel livello Lambda " Instana ", ma la pagina di configurazione " AWS Lambda " non ne tiene conto.
3. Configura variabili di ambiente.

   Aggiungi le seguenti variabili di ambiente:

   • INSTANA_ENDPOINT_URL: Questa variabile rappresenta il tuo endpoint di monitoraggio serverless. Assicurati di utilizzare il valore corretto per la tua regione che inizia con https://serverless-.
   • INSTANA_AGENT_KEY: la tua chiave agent.
   • LAMBDA_HANDLER: impostare il gestore personalizzato. Se il file principale è myModule.js, che esporta la funzione myHandler, impostare la variabile di ambiente su myModule.myHandler. Il valore predefinito è index.handler.

   Nell'esempio seguente, il gestore Lambda principale predefinito è index.js, pertanto non è necessario impostare la variabile d'ambiente LAMBDA_HANDLER.

   

   Nell'esempio seguente, il gestore Lambda principale originale è server.js, pertanto è necessario impostare la variabile d'ambiente LAMBDA_HANDLER su server.handler.

   

   È inoltre possibile ottenere i valori corretti per queste variabili d'ambiente accedendo all'installazione di Instana, facendo clic su "Agents & collectors " > " Instana agents " > "Install agents " > " AWS Lambda ".

4. Salva la definizione della funzione Lambda.

   

È possibile eseguire tutte le operazioni descritte in precedenza utilizzando la console web AWS o uno qualsiasi dei consueti strumenti di gestione AWS, quali:

• l' interfaccia a riga aws di comando (CLI di AWS Lambda )
• la CLI del framework senza server
• AWS Cloud Development Kit

Ecco un esempio di comando aws CLI che potrebbe fungere da punto di partenza se desideri automatizzare l'integrazione di Instana nelle tue funzioni Lambda di 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 \
  --handler instana-aws-lambda-auto-wrap.handler \
  --environment "Variables={INSTANA_ENDPOINT_URL=... , INSTANA_AGENT_KEY=... , ...}"

Per installare manualmente il collector Instana Node.js, eseguire il seguente comando:

npm install --save @instana/aws-lambda@latest

Modifica il codice della funzione seguendo le istruzioni riportate nella sezione "Avvolgimento manuale dell'handler".

Se il tuo team utilizza distribuzioni Lambda basate su container, puoi utilizzare i container di base disponibili all'indirizzo Instanaicr.io/instana/aws-lambda-nodejs oppure includere il seguente snippet nel tuo Dockerfile e impostare gli argomenti di compilazione sulle versioni appropriate.

Instana attualmente supporta solo x86_64 l'architettura.

# This is the container image that delivers Instana's monitoring capabilities.
# It will not become the base image for your Lambda container image, it just provides a few files.
FROM icr.io/instana/aws-lambda-nodejs:latest as instana-layer

# This is the actual base image for your Lambda container image. You can also use any other base image that is suitable
# for container image based Lambda functions.
FROM public.ecr.aws/lambda/nodejs:22

# Copy Instana's Node.js monitoring components into your Lambda container image.
COPY --from=instana-layer /opt/extensions/ /opt/extensions/
COPY --from=instana-layer /opt/nodejs/ /opt/nodejs/

# The remainder of your Dockerfile, as it was without adding the Instana layer. The following is just an example:
COPY index.js package.json package-lock.json /var/task/
WORKDIR /var/task
RUN npm install

# Override the CMD. This can also be done as a parameter override outside of the Dockerfile, for example in the AWS console.
# If you use ES modules, use CMD [ "instana-aws-lambda-auto-wrap-esm.handler" ] instead.
CMD [ "instana-aws-lambda-auto-wrap.handler" ]

curl -s https://icr.io/v2/instana/aws-lambda-nodejs/tags/list | jq .

Modifica il file serverless.yml per integrare il tracciamento di Instana e con Serverless Framework. Seguire i passi:

1. Copiare l' ARN di livello dall'elenco e aggiungere l'ARN alla sezione livelli della definizione della funzione di destinazione.
2. Aggiungere le variabili di ambiente INSTANA_AGENT_KEY, INSTANA_ENDPOINT_URL e LAMBDA_HANDLER. Per ulteriori informazioni, consultare Instana AutoTrace setup.

Consultare il seguente serverless.ymldi esempio:

service: service-a

provider:
  name: aws
  runtime: nodejs16.x
  stage: dev
  region: us-east-2

functions:
  with-layer:
    environment:
      INSTANA_ENDPOINT_URL: INSTANA_ENDPOINT_URL
      INSTANA_AGENT_KEY: INSTANA_AGENT_KEY
      LAMBDA_HANDLER: src/index.handler
    layers:
      - arn:aws:lambda:us-east-2:410797082306:layer:instana-nodejs:111
    handler: instana-aws-lambda-auto-wrap.handler

service: service-b

provider:
  name: aws
  runtime: nodejs12.x
  stage: dev
  region: us-east-2

plugins:
  - serverless-offline

custom:
  serverless-offline:
    useDocker: true

functions:
  with-serverless-offline:
    environment:
      NODE_PATH: $NODE_PATH:/opt/nodejs/node_modules
      INSTANA_ENDPOINT_URL: INSTANA_ENDPOINT_URL
      INSTANA_AGENT_KEY: INSTANA_AGENT_KEY
      LAMBDA_HANDLER: src/index.handler
    layers:
      - arn:aws:lambda:us-east-2:410797082306:layer:instana-nodejs:111
    handler: instana-aws-lambda-auto-wrap.handler

service: service-c

provider:
  name: aws
  runtime: nodejs12.x
  stage: dev
  region: us-east-2

plugins:
  - serverless-webpack

package:
  individually: true

functions:
  with-serverless-webpack:
    environment:
      INSTANA_ENDPOINT_URL: INSTANA_ENDPOINT_URL
      INSTANA_AGENT_KEY: INSTANA_AGENT_KEY
      LAMBDA_HANDLER: src/index.handler
    layers:
      - arn:aws:lambda:us-east-2:410797082306:layer:instana-nodejs:110
    handler: instana-aws-lambda-auto-wrap.handler
    entrypoint: src/index.handler