Gatling-Kinesis

This project aims at doing performance testing of AWS Kinesis stream
using Gatling

Currently it allows you to putRecords in your kinesis Stream via Gatling.

A typical Kinesis Test will look like the following :

ToDo List:

1. Create a documentation page for contribution
2. Create a sample terraform script so to provision Kinesis and Lambda so that examples can be more concrete

Requirement

1. SBT
2. AWS_CLI
3. SCALA

This project uses SBT 0.13.15, which is available here.

LogIn to AWS_CLI

aws-adfs login --profile default --adfs-host <Your Host> --region <region>

Start SBT

$ sbt

Run all simulations

> gatling:test

Run a single simulation

> gatling:testOnly PutRecordsInKinesisStream

Passing commandLine Arguments

More on Passing command line arguments can be found here

How to Interpret Results:

I would highly recommend using the combination of the following tools to monitor all aspects of performance metrics:

1. Gatling detailed reports. Intergrate with your pipeline
   
2. Create dashboard in AWS cloud watch for Kinesis and Lambda
   1. Kinesis - PutRecords.Records , PutRecords.Latency , PutRecords.Success
   2. Kinesis - GetRecords.IteratorAgeMilliseconds, GetRecords.Latency, IncomingRecords
   3. Lambda- Invocations, Duration, Throttles , IteratorAge
      
      AWS has a very detailed and well written document :
   4. Kinesis Metrics
   5. Lambda Metrics
      1. AWS-XRAY . Documentation here