vt-loadtest 2.0.6

LoadTest

LoadTest is a simple website load tester packaged in a .NET tool. It's not fully-featured and is just a toy/tool for myself, but feel free to use it.

• Load test a site using a list of URLs or point to the sitemap.
• Save a list of URLs from the sitemap.
• Archive html from pages.
  • Save html source or use --browser to save the JS-rendered page markup.
  • Use --log-browser-errors to capture JS console errors to QA your site.

Install

You need the .NET SDK to run this tool.

dotnet tool install --global vt-loadtest

vt-loadtest --help

Build

You need the .NET SDK to build this project.

./build/build.ps1

To install a local build:

dotnet tool uninstall -g vt-loadtest
dotnet tool install -g vt-loadtest --add-source ./artifacts/dist/pre-release --prerelease

Usage

If running from source, replace vt-loadtest with dotnet run --.

# Load test using a remote sitemap on 2 threads. Works on nested sitemap indexes.
vt-loadtest run --path 'https://developers.google.com/tasks/sitemap.xml' --threads 2

# Load test using a remote sitemap index for 30 seconds and limit the rate of requests.
vt-loadtest run --path 'https://developers.google.com/sitemap.xml' --seconds 30 --delay

# Use a local list of URLs rather than a site map. Force at least 20% chance of 404.
vt-loadtest run --path './samples/sitemapUrls.txt' --chance-404 20

# Crawl a sitemap index and write the URLs to a local file to speed up repeat runs where sitemap retrieval is slow.
vt-loadtest make-list --path 'https://developers.google.com/sitemap.xml' --output './samples/url-list.txt'

See vt-loadtest -h for more.

Known issues

URLs are technically case-sensitive, but some file systems aren't (Windows). This means when archiving pages, you may only get one page or the other in the event that the web server treats them as 2 different URLs. This should be rare as nearly identical URLs are bad for SEO.