A load testing script in NodeJS that pulls cloudfront logs and replays them.
These instructions will get this script up and running on your local machine.
- node
- yarn
- You need to have the .aws/credentials file locally with the default credentials (See this article for details)
- Install packages:
yarn - Download an hour's worth of logs:
node .\download-cloudfront-logs.js --timestamp <YYYY-dd-mm-hh> --bucketName <cloudfrontLogsBucketName> --cloudfrontId <distribution id> --s3folder <folder where logs are kept>- NOTE: the timestamp is in UTC
- Replay the logs against the host of your choice:
node ./load-test.js --urlHost 'www.<yourHost>.com' --prefix '/<the path subset you want to test>' --maxPings 100- NOTE: if you run out of memory, run node such as with 4gb:
node --max-old-space-size=4096 ....
- NOTE: if you run out of memory, run node such as with 4gb:
| Name | Required | Description | Default Value |
|---|---|---|---|
| timestamp | required | A timestamp in the format of: YYYY-mm-dd-hh. This is used to grab all S3 logs with that file prefix | - |
| bucketName | required | The S3 bucket that contains the Cloudfront logs | - |
| cloudfrontId | required | The ID of the cloudfront distribution in question | - |
| s3folder | required | The folder within S3 to get logs from | - |
| Name | Required | Description | Default Value |
|---|---|---|---|
| urlHost | required | The url host that you want to ping | - |
| prefix | optional | A path prefix for the urls that you want to replay (if you don't want to replay all logs, but instead just a subset) | - |
| maxPings | optional | If you want to limit the load test to a certain number of pings | - |
Please read CONTRIBUTING.md for contributing to the project and submitting pull requests to us. For details on our code of conduct, visit Code of Conduct.
This project is licensed under the Apache 2 License - see the LICENSE file for details