nbomberdocker/nbomber-studio repository overview

⁠Overview

NBomber Studio - is a powerful management tool designed by NBomber for managing and interacting with NBomber load tests. The tool provides the following capabilities:

• Real-time data visibility - allows to monitor ongoing load tests while also analyzing historical test runs. Think of it as a native alternative to Grafana, specifically designed for NBomber load tests.

• Running load tests in the cloud - enables to schedule and execute load tests in popular cloud environments (AWS, Azure, Google Cloud, Digital Ocean). This functionality is currently in development.

⁠License

NBomber Studio is FREE only for personal use. You can't use FREE version for an organization.

For organization usage, a minimum NBomber Business license is required.

⁠Installation and usage

NBomber Studio is provided as a Docker image and requires a PostgreSQL database with the TimescaleDB extension. Below is an example of a Docker compose file that sets up both NBomber Studio and TimescaleDB.

services:

    timescaledb:
        image: timescale/timescaledb:2.14.2-pg16
        command: postgres -c 'max_connections=500'
        restart: always
        ports:
            - "5432:5432"
        volumes:
            - nb_studio_data:/var/lib/postgresql/data
        environment:
            POSTGRES_DB: nb_studio_db
            POSTGRES_USER: timescaledb
            POSTGRES_PASSWORD: timescaledb
        healthcheck:
            test: [ "CMD-SHELL", "pg_isready -d 'user=timescaledb dbname=nb_studio_db'" ]
            interval: 5s
            timeout: 10s
            retries: 5
            start_period: 5s

    nbomber-studio:
        image: nbomberdocker/nbomber-studio:latest
        ports:
            - "5333:8080"
        depends_on:
            timescaledb:
                condition: service_healthy
        environment:
            DBSETTINGS:CONNECTIONSTRING: "Host=timescaledb;Port=5432;Username=timescaledb;Password=timescaledb;Database=nb_studio_db;Pooling=true;"

volumes:
    nb_studio_data:
        driver: local

For production use, it’s important to specify the exact version of the NBomber Studio image rather than using latest.

image: nbomberdocker/nbomber-studio:0.1.0