vt-loadtest 2.0.6

dotnet tool install --global vt-loadtest --version 2.0.6
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local vt-loadtest --version 2.0.6
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=vt-loadtest&version=2.0.6
nuke :add-package vt-loadtest --version 2.0.6


License NuGet package MyGet package Build Status Test Coverage

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.


You need the .NET SDK to run this tool.

dotnet tool install --global vt-loadtest

vt-loadtest --help


You need the .NET SDK to build this project.


To install a local build:

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


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.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
2.0.6 154 2/8/2024
2.0.3 169 11/17/2023
1.1.3 139 11/16/2023
1.1.2 126 11/5/2023
1.0.36 228 10/1/2023
1.0.35 247 9/30/2023
1.0.34 222 5/1/2023
1.0.32 194 4/7/2023
1.0.31 277 2/23/2023
1.0.27 304 2/12/2023
1.0.26 411 10/29/2022