/NBomber

Modern and flexible load testing framework for Pull and Push scenarios, designed to test any system regardless a protocol (HTTP/WebSockets/AMQP etc) or a semantic model (Pull/Push).

Primary LanguageF#Apache License 2.0Apache-2.0

NBomber logo

Build status NuGet Gitter

Very simple load testing framework for Pull and Push scenarios. It's 100% written in F# and targeting .NET Core and full .NET Framework.

How to install

To install NBomber via NuGet, run this command in NuGet package manager console:

PM> Install-Package NBomber

Documentation

Documentation is located here.

Run test scenario

how to run a scenario gif

View report

view report

Analyze trends

analyze trends

Why we build NBomber and what you can do with it?

  1. The main reason behind NBomber is to provide a lightweight framework for writing load tests which you can use to test literally any system and simulate any production workload. We wanted to provide only a few abstractions so that we could describe any type of load and still have a simple, intuitive API.
  2. Another goal is to provide building blocks to validate your POC (proof of concept) projects by applying any complex load distribution.
  3. With NBomber you can test any PULL or PUSH system (HTTP, WebSockets, GraphQl, gRPC, SQL Databse, MongoDb, Redis etc).

NBomber as a modern framework provides:

  • Zero dependencies on protocol (HTTP/WebSockets/AMQP/SQL)
  • Zero dependencies on semantic model (Pull/Push)
  • Very flexible configuration and dead simple API
  • Cluster support
  • Reporting sinks
  • CI/CD integration
  • Plugins/extensions support
  • Data feed support

What makes it very simple?

NBomber is a foundation of building blocks which you can use to describe your test scenario, run it and get reports.

// FSharp example

let step = Step.create("step", fun context -> task {

    // you can do any logic here: go to http, websocket etc
    do! Task.Delay(seconds 1)
    return Response.Ok()
})

Scenario.create "scenario" [step]
|> NBomberRunner.registerScenario
|> NBomberRunner.run
// CSharp example

var step = Step.Create("step", async context =>
{
    // you can do any logic here: go to http, websocket etc

    await Task.Delay(TimeSpan.FromSeconds(1));
    return Response.Ok();
});

var scenario = ScenarioBuilder.CreateScenario("scenario", step);

NBomberRunner
    .RegisterScenarios(scenario)
    .Run();

Examples

Language Example
F# link
C# link

Contributing

Would you like to help make NBomber even better? We keep a list of issues that are approachable for newcomers under the good-first-issue label.