Skip to content

Latest commit

 

History

History
58 lines (43 loc) · 2 KB

README.md

File metadata and controls

58 lines (43 loc) · 2 KB
Raw

measure-cold-start

Version License

This is an AWS Step Functions state machine that helps you measure the initialization time (or Init Duration in the REPORT log messages) of your Lambda functions. The initializatoin time is the time it takes to initialize the function module before Lambda is able to invoke the handler method.

The state machine is language agnostic. You can give it any function as input and the state machine will invoke it multiple times whilst inducing a cold start for each invocation by changing an environment variable value. It will then analyze the function's logs and report the following data points.

{
 "coldStarts": 40,
 "min": 308.3,
 "fstQuartile": 323.86,
 "median": 347.63,
 "trdQuartile": 362.66,
 "p95": 407,
 "max": 422.56,
 "stddev": 29.9653
}

The state machine expects input of the following format:

{
  "functionName": "my-function",
  "count": 100,
  "payload": "{}"
}

Deploying to your account (via the console)

Go to this page and click the Deploy button.

Deploying via SAM/Serverless framework/CloudFormation

To deploy this app via SAM, you need something like this in the CloudFormation template:

PropagateCloudFormationTags:
  Type: AWS::Serverless::Application
  Properties:
    Location:
      ApplicationId: arn:aws:serverlessrepo:us-east-1:374852340823:applications/measure-cold-start
      SemanticVersion: <enter latest version>

To do the same via CloudFormation or the Serverless framework, you need to first add the following Transform:

Transform: AWS::Serverless-2016-10-31

For more details, read this post.