Serverless Inquisitor

A simple app for testing request latency over API Gateway and Lambda functions.

The easiest way to deploy is directly from the Serverless App Repository. Check out the stack outputs after deployment for the web site URL, and open that URL in the browser to run your tests.

For manual deployment, without the Serverless App repository, and customisation options, see below:

Manual deployment Prerequisites

• npm
• make

Manual deployment

1. deploy the stack using make deploy

Here are the parameters you can pass to it. All parameters are optional:

• STACK_NAME: name of the stack; default is sls-inquisitor-test
• DEPLOYMENT_BUCKET: name of the bucket for cloudformation packaging; the bucket will be created if it does not exist; the default name is based on the stack name and deployment region
• AWS_REGION: the region where to deploy
• AWS_PROFILE: the AWS cli profile to use for deployment
• PROVISIONED_INSTANCES: the number of Lambda instances to set up as provisioned concurrency for the testing function. By default, no instances are provisioned. AWS Charges you for provisioned instances even when you are not using them, so make sure to undeploy stacks with provisioned instances when done with testing
• MEMORY_SIZE: Memory size allocated to the testing lambda function

for example:

make deploy STACK_NAME=perf-test AWS_PROFILE=claudia-test AWS_REGION=eu-west-2 PROVISIONED_INSTANCES=5

Upon successful deployment, the command will print out the URL of a web site you can open to trigger tests. The web site will also show a link to read out the API key value for tests involving the API Authorizers. (CloudFormation does not support reading out this value directly).

Clean up

You can delete temporarily generated files using make clean;

You can remove the deployed stack using make undeploy (make sure to add STACK_NAME, AWS_PROFILE and AWS_REGION if you used those arguments during deployment)

Customising

• modify sync-test-function/lambda.js to change the Lambda function source code
• modify template.yml to change the Lambda function settings
• modify web-site/index.html to change the web site landing page

License

MIT, see LICENSE.txt.