AWS Lambda Native Tracing for Node.js

La configurazione di Instana AutoTrace per Node.js consente di tracciare le funzioni Lambda di AWS è di utilizzare il livello Instana Lambda e un gestore di funzioni personalizzato. Questo approccio non richiede la modifica del codice della funzione Lambda e avviene esclusivamente attraverso la configurazione. È anche adatto per essere automatizzato o incluso in una pipeline di distribuzione Lambda.

Per abilitare il tracciamento delle funzioni Lambda di Node.js, eseguire i seguenti passaggi:

1. Aggiungere il livello Instana Lambda alla funzione.

   1. Nella pagina di configurazione della funzione Lambda, clicca sulla Layers casella e poi su Add a layer.
   2. Nella finestra popup che si apre, seleziona Fornisci un ARN della versione del livello e copia e incolla l'ARN per il livello Instana Lambda corrispondente alla tua regione; puoi trovare l'ARN corretto per il livello Instana Lambda nella sezione Livelli Instana Lambda.

2. Configurare il Lambda Handler. Impostare il gestore su instana-aws-lambda-auto-wrap.handler se si utilizza il metodo CommonJS. Impostare il gestore su instana-aws-lambda-auto-wrap-esm.handler se si utilizzano i Moduli ES ( ES6 ) (disponibili dalla versione 223 del layer).

   Per modificare le impostazioni del gestore Lambda, nella pagina di configurazione si trova la sezione "Impostazioni di base".

   

   Fare clic su modifica e inserire instana-aws-lambda-auto-wrap.handler nel campo "Handler".

   

   Il livello Instana Lambda attiva automaticamente il gestore runtime predefinito Node.js index.handler. Se si usa un gestore personalizzato, specificarlo nella variabile d'ambiente LAMBDA_HANDLER per notificarlo al Lambda Layer di Instana. Vedere la sezione successiva per tutte le variabili d'ambiente che devono essere impostate.

   La pagina di configurazione di Lambda potrebbe visualizzare un avviso del tipo Lambda non trova il file instana-aws-lambda-auto-wrap.js. Questo potrebbe essere visualizzato anche in seguito, quando si torna alla pagina di configurazione. Non lasciatevi distrarre da questo avvertimento. Il gestore è contenuto nel livello Instana Lambda, ma la pagina di configurazione di AWS Lambda non ne tiene conto.

3. Configurare le variabili d'ambiente. Aggiungi le seguenti variabili di ambiente:

   • INSTANA_ENDPOINT_URL: Questo è il tuo endpoint di monitoraggio senza server. Assicurarsi di utilizzare il valore corretto per la propria regione che inizia con https://serverless-.
   • INSTANA_AGENT_KEY: La chiave dell'agente.
   • LAMBDA_HANDLER: Impostare il gestore personalizzato. Se il file principale è myModule.js, che esporta la funzione myHandler, impostare la variabile d'ambiente su myModule.myHandler. Il valore predefinito è index.handler.

   Nell'esempio seguente, il gestore Lambda principale originale è index.js, quindi non è necessario impostare la variabile di ambiente LAMBDA_HANDLER.

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

   È possibile ottenere i valori corretti per queste variabili d'ambiente anche accedendo all'installazione di Instana, facendo clic su... Altro -> Agenti -> Installazione degli agenti Instana -> Piattaforma: AWS -> Tecnologia: AWS Lambda.

4. Salva la definizione della funzione Lambda.

Tutte le operazioni descritte in precedenza possono essere eseguite tramite la console web di AWS o uno qualsiasi dei consueti strumenti di gestione di AWS, come ad esempio:

• l' interfaccia a riga di comando aws
• il framework serverless cli
• il kit di sviluppo per il cloud AWS

Ecco un esempio di comando CLI di aws che può servire come punto di partenza se si vuole automatizzare l'integrazione di Instana con i 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=... , ...}""
 

Invece di usare il livello Lambda di Instana, si può anche scegliere di installare manualmente il pacchetto npm @instana/aws-lambda :

1. Aggiungere la dipendenza @instana/aws-lambda al progetto eseguendo npm install -S @instana/aws-lambda (o yarn add @instana/aws-lambda) nella directory del progetto. Questo aggiungerà il pacchetto alla cartella node_modules e salverà la dipendenza nel file package.json .
2. Aggiungere le variabili d'ambiente INSTANA_ENDPOINT_URL e INSTANA_AGENT_KEY con i valori richiesti.
3. Modificare il codice della funzione secondo quanto indicato nella sezione Avvolgimento manuale del gestore.

Se il vostro team utilizza distribuzioni Lambda basate su container, potete usare i nostri container di base su icr.io/instana/aws-lambda-nodejs o includere il seguente snippet nel vostro file Docker e impostare gli argomenti del tempo di compilazione sulle versioni appropriate.

Attualmente Instana supporta solo l'architettura x86_64 .

Questa immagine non è destinata all'uso in ambienti FedRAMP-compliant.

# 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:14

# 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" ]
 

Al posto di icr.io/instana/aws-lambda-nodejs:latest, si può anche usare una versione specifica del modulo npm Instana @instana/aws-lambda maggiore o uguale a 1.137.2 (vedere CHANGELOG ), quindi ad esempio:

FROM icr.io/instana/aws-lambda-nodejs:1.140.1 as instana-layer
 

Oppure si può bloccare solo la versione principale, consentendo però le versioni minori/patch più recenti:

FROM icr.io/instana/aws-lambda-nodejs:1 as instana-layer
 

Modificare il sito serverless.yml per integrare il tracciamento di Instana con il framework Serverless. Seguire i passaggi:

1. Copiare l' ARN del livello dall'elenco e aggiungere l'ARN alla sezione dei livelli della definizione della funzione di destinazione.

2. Aggiungere le variabili d'ambiente INSTANA_AGENT_KEY, INSTANA_ENDPOINT_URL e LAMBDA_HANDLER. Per ulteriori informazioni, vedere Configurazione di Instana AutoTrace.

Si veda il seguente esempio serverless.yml:

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
 

Gli ARN dell'ultima versione dei livelli AWS Lambda per i runtime Lambda elencati in Runtime supportati sono i seguenti, per regione:

Cioè, il modello è arn:aws:lambda:${region}:410797082306:layer:instana-nodejs:${layer-version} (o arn:aws-cn:lambda:${region}:107998019096:layer:instana-nodejs:${layer-version} per le regioni AWS della Cina).

Assicuratevi di utilizzare sempre le versioni più recenti e di aggiornare la versione del layer che state utilizzando a intervalli regolari per beneficiare delle nuove funzionalità e delle correzioni che forniamo quando pubblichiamo una nuova versione del layer.