LoadSurge 1.0.0.56

LoadSurge

High-performance, actor-based load testing framework for .NET.

Installation

dotnet add package LoadSurge

Quick Start

using LoadSurge.Models;
using LoadSurge.Runner;

var plan = new LoadExecutionPlan
{
    Name = "API_Load_Test",
    Settings = new LoadSettings
    {
        Concurrency = 50,
        Duration = TimeSpan.FromSeconds(30),
        Interval = TimeSpan.FromMilliseconds(100)
    },
    Action = async () =>
    {
        var response = await httpClient.GetAsync("https://api.example.com/health");
        return response.IsSuccessStatusCode;
    }
};

var result = await LoadRunner.Run(plan);

Console.WriteLine($"Total: {result.Total}, Success: {result.Success}, Failed: {result.Failure}");
Console.WriteLine($"RPS: {result.RequestsPerSecond:F1}, Avg: {result.AverageLatency:F1}ms, P95: {result.Percentile95Latency:F1}ms");

Examples

Fixed Iteration Count

var plan = new LoadExecutionPlan
{
    Name = "Fixed_100_Requests",
    Settings = new LoadSettings
    {
        Concurrency = 10,
        Duration = TimeSpan.FromMinutes(5),
        Interval = TimeSpan.FromMilliseconds(100),
        MaxIterations = 100  // Stop after exactly 100 requests
    },
    Action = async () => { /* your test */ return true; }
};

Database Testing

var plan = new LoadExecutionPlan
{
    Name = "DB_Pool_Test",
    Settings = new LoadSettings
    {
        Concurrency = 100,
        Duration = TimeSpan.FromMinutes(2),
        Interval = TimeSpan.FromMilliseconds(50)
    },
    Action = async () =>
    {
        using var conn = new SqlConnection(connectionString);
        await conn.OpenAsync();
        using var cmd = conn.CreateCommand();
        cmd.CommandText = "SELECT 1";
        return await cmd.ExecuteScalarAsync() != null;
    }
};

Configuration

Settings

Execution Modes

var config = new LoadWorkerConfiguration { Mode = LoadWorkerMode.Hybrid };
var result = await LoadRunner.Run(plan, config);

• Hybrid (default) - Channel-based, optimized for high throughput (10k+ RPS)
• TaskBased - Task.Run based, suitable for moderate load

Results

result.Total              // Total requests
result.Success            // Successful requests
result.Failure            // Failed requests
result.RequestsPerSecond  // Throughput
result.AverageLatency     // Mean latency (ms)
result.Percentile95Latency // P95 latency (ms)
result.Percentile99Latency // P99 latency (ms)

Requirements

• .NET Standard 2.0+ (.NET Framework 4.7.2+, .NET 6/8/9+)

Related

• xUnitV3LoadFramework - xUnit v3 integration with [Load] attribute

License

MIT