Without using AWS Lambda Layers

If you do not want to use AWS Lambda Layers, you can still easily integrate Thundra to your Node.js Lambda functions. All you have to do is installing @thundra/core package via npm.

Step 1: Install the @thundra/core package

npm install @thundra/core --save

Step 2: Wrap your Lambda handler

After installing the thundra/core module, you will need to wrap your lambda handlers. Thundra will monitor your AWS Lambda functions automatically, supporting callback along with various context functions.

handler.js
const thundra = require("@thundra/core")();
​
exports.handler = thundra((event, context,callback) => {
    callback(null, "Hello Thundra!");
});

Step 3: Deploy your function to AWS Lambda

Bundle your function along with any additional required Node.js packages and upload it to the AWS Lambda console using the 'Upload a.zip file' option for the code entry type option.

Step 4: Configure your function

In the AWS Lambda console, set the thundra_apiKey the environment variable to the api key value you got from the Thundra console.

Step 5: Invoke your function!

Now you can try to invoke your Lambda function and see the details of your invocation in the Thundra console!

Serverless Framework

Step 1: Install Thundra’s serverless plugin to automatically wrap your functions

npm install serverless-plugin-thundra

Step 2: Adding Thundra's Serverless Plugin in serverless.yml File After installing Thundra’s serverless plugin, please specify it as a plugin for your serverless environment by adding it under the plugins section of your serverless.yml file.

serverless.yml
plugins:  
    - serverless-plugin-thundra

Step 3: Add thundra component to custom

Add the thundra component under custom with apiKey under that, as seen below:

serverless.yml
custom:
    thundra:
        apiKey: <YOUR THUNDRA API KEY>

Step 4: Add thundra_apiKey to environment variables under provider section in serverless.yml

serverless.yml
provider: 
    environment:
        thundra_apiKey: <YOUR THUNDRA API KEY>

Step 5: Deploy

serverless deploy

Step 5: Invoke your function!

Now you can try to invoke your Lambda function and see the details of your invocation in the Thundra console!

AWS SAM

Step 1: Add configuration changes on SAM template.yml

• Add thundra_apiKey environment variable with your thundra api key.

Globals:
  Function:
    Environment:
      Variables:
          thundra_apiKey: <your_api_key>

• Add the Thundra layer to Layers in globals section. ThundraAWSAccountNo and ThundraPythonLayerVersion parameters are defined under the Parameters section in the following configuration:

Parameters:
  ThundraAWSAccountNo:
    Type: Number
    Default: 269863060030
​
  ThundraNodeLayerVersion:
    Type: Number
    Default: 24 # Or use any other version
​
Globals:
  	Function:
      Layers:
    	- !Sub arn:aws:lambda:${AWS::Region}:${ThundraAWSAccountNo}:layer:thundra-lambda-node-layer:${ThundraNodeLayerVersion}
​
	…
​

• Change Runtime of your functions to provided

Resources:
  HelloWorldFunction:
    Type: AWS::Serverless::Function
    Properties:
      Runtime: provided
      Handler: handler.hello

An example configuration:

Parameters:
  ThundraAWSAccountNo:
    Type: Number
    Default: 269863060030
  ThundraNodeLayerVersion:
    Type: Number
    Default: 24 # Or use any other version
​
Globals:
  Function:
    Runtime: provided
    Timeout: 5
    Environment:
      Variables:
          thundra_apiKey: <your_api_key>
    Layers:
    	- !Sub arn:aws:lambda:${AWS::Region}:${ThundraAWSAccountNo}:layer:thundra-lambda-node-layer:${ThundraNodeLayerVersion}
​
Resources:
  HelloWorldFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: ./
      Handler: handler.hello
​

Step 2: Test / Deploy

To build & run your functions locally:

sam build && sam local invoke

Then, package and deploy your function using sam.

Step 2: Invoke your function!

Now you can try to invoke your Lambda function and see the details of your invocation in the Thundra console!