Skip to content

Latest commit

 

History

History
 
 

lambda-extensions-demo

README.md

Lambda Extensions Demo

This is a demo of a sample logging functionality available with AWS Lambda Extensions to send logs directly from Lambda to Amazon Simple Storage Service (S3).

Using AWS Lambda Extensions, you can get granular insights into your Lambda function's performance and receive log streams directly from within the Lambda execution environment, making it easier to perform diagnostics and troubleshooting. In this example, you will attach a Lambda extension delivered as a layer to your sample Lambda function. The example creates two S3 buckets to store the logs, one to store only function errors and another to store all other logs. This allows you to query and troubleshoot all your function errors from a dedicated S3 bucket. You can configure SNS on the S3 bucket to receive notifications.

For more information on the extensions logs functionality, see the blog post Using AWS Lambda extensions to send logs to custom destinations

Reference Architecture Diagram

Reference Architecture

Requirements

Project Deployment

  1. Create an AWS account if you do not already have one and login.

  2. Clone the repo onto your local development machine:

git clone https://github.com/aws-samples/appmod-partners-serverless
  1. Access the directory
cd lambda-extensions-demo
  1. Run the following command for AWS SAM to deploy the components as specified in the template.yml file:
sam build
# If you receive build errors or don't have 'Python' or 'make' installed, you can use the option to build using a container which uses a python3.8 Docker container image.  
# sam build --use-container
sam deploy --stack-name lambda-extensions-demo --guided
  1. During the prompts:
  • Accept the default Stack Name lambda-extension-demo.
  • Enter your preferred Region
  • Accept the defaults for the remaining questions.

AWS SAM deploys the application stack which includes the Lambda function and an IAM Role. AWS SAM creates a layer for the runtime, a layer for the extension, and adds them to the function.

Note the names of outputted S3 Buckets.

Invoke the Lambda function

You can now invoke the Lambda function. Navigate to the AWS Lambda console and find the Lambda function logs-extension-demo-function. Scroll down and find the Test button. Click on Test and create the following test event

{
  "key": "failure"
}

Click on Save and invoke the function a few times. The function should return an error. For successful invocations of the function, simply replace the key value in the test event with "success" as follows:

{
  "key": "success"
}

Browse to the Amazon S3 Console. You will find 2 buckets created, one with the name successlogextensionsbucket and another with failedlogextensionsbucket. Navigate to the failedlogextensionsbucket S3 bucket.

Download the file object containing the copied log stream. The log contains the function logs with the respective function errors.

Note: If you receive a permission denied Extension.LaunchError in the logs, the extension does not have the neccesary permissions. Run chmod +x logs_api_http_extension.py and build and deploy the AWS SAM application again.