Death by 1000 needles

Developed by Bohdan Ivashko (https://github.com/Arriven)

This is a simple distributed load generation client written in go. It is able to fetch simple json config from a local or remote location. The config describes which load generation jobs should be launched in parallel. I do not intend to copy or replace it but rather provide a simple open source option. Feel free to use it in your load tests (wink-wink)

The software is provided as is under no guarantee. I will update both the repo and this readme as I go during following days (date of writing this is 26th of February 2022, third day into russian invasion into Ukraine)

Synflood implementation is taken from https://github.com/bilalcaliskan/syn-flood and slightly patched. I couldn't just import the package as all the functionality code was in an internal package preventing import into other modules. Will figure it out better later (sorry to the owner).

How to install

binary install

go to releases page and install latest version for your os

go install

run command in your terminal

go install github.com/Arriven/db1000n@latest
~/go/bin/db1000n

docker install

how to install docker?

https://docs.docker.com/get-docker/

make sure you've set all available resources to docker

https://docs.docker.com/desktop/windows/#resources https://docs.docker.com/desktop/mac/#resources

run d1000n

docker run ghcr.io/arriven/db1000n:latest

shell install

run install script directly into the shell (useful for install through ssh)

curl https://raw.githubusercontent.com/Arriven/db1000n/main/install.sh | sh

the command above will detect the os and architecture, dowload the archive, validate it, and extract db1000n executable into the working directory. You can then run it via this command

./db1000n

Configuration

Commandline reference

Usage of /tmp/go-build781992389/b001/exe/main:
  -b string
        path to a backup config file in case primary one is unavailable (default "https://raw.githubusercontent.com/db1000n-coordinators/LoadTestConfig/main/config.json")
  -c string
        path to a config file, can be web endpoint (default "https://raw.githubusercontent.com/db1000n-coordinators/LoadTestConfig/main/config.json")
  -h    print help message and exit
  -l int
        logging level. 0 - Debug, 1 - Info, 2 - Warning, 3 - Error (default 1)
  -m string
        path where to dump usage metrics, can be URL or file, empty to disable
  -r duration
        refresh timeout for updating the config (default 1m0s)

Config file reference

The config is expected to be in json format and has following configuration values:

jobs - [array] array of attack job definitions to run, should be defined inside the root object
jobs[*] - [object] single job definition as json object
jobs[*].type - [string] type of the job (determines whhich attack function to launch). Can be http, tcp, udp, syn-flood, or packetgen
jobs[*].count - [number] the amount of instances of the job to be launched, automatically set to 1 if no or invalid value is specified
jobs[*].args - [object] arguments to pass to the job. Depends on jobs[*].type

http args:

method - [string] http method to use (passed directly to go http.NewRequest)
path - [string] url path to use (passed directly to go http.NewRequest)
body - [object] http payload to use (passed directly to go http.NewRequest)
headers - [object] key-value map of http headers
client - [object] http client config for the job
client.tls_config - [object] tls config for transport (InsecureSkipVerify is true by default)
client.proxy_urls - [array] string urls for proxies to use (chosen randomly for each request)
client.timeout - [time.Duration]
client.max_idle_connections - [number]

tcp and udp shared args:

address - [string] network host to connect to, can be either hostname:port or ip:port
body - [object] json data to be repeatedly sent over the network

http, tcp, and udp shared args:

interval_ms - [number] interval between requests in milliseconds. Defaults to 0 (Care, in case of udp job it might generate the data faster than your OS/network card can process it)
count - [number] limit the amount of requests to send with this job invocation. Defaults to 0 (no limit). Note: if config is refreshed before this limit is reached the job will be restarted and the counter will be reset

syn-flood args:

host - [string] host to attack, can be either DNS name or IP
port - [number] port to attack
payload_length - [number] refer to original syn-flood package docs
flood_type - [string] type of flood to send, can be syn, ack, synack, and random

Warning: packetgen requires root privilleges to run

packetgen args:

host - [string] host to attack, can be either DNS name or IP
port - [string] numerical value of port to attack (string to allow template generation)
payload - [string] payload to include into packets
ethernet - [object] ethernet layer configuration
ethernet.src_mac - [string]
ethernet.dst_mac - [string]
ip - [object] ip layer configuration
ip.src_ip - [string]
ip.dst_ip - [string]
udp - [object] udp layer configuration (disables tcp if present)
udp.src_port - [number]
udp.dst_port - [number]
tcp - [object] tcp layer configuration (excluded if udp is present)
tcp.src_port - [number]
tcp.dst_port - [number]
tcp.seq - [number]
tcp.ack - [number]
tcp.window - [number]
tcp.urgent - [number]
tcp.flags - [object] flags for tcp (every flag has it's respective name)

Warning: slow-loris from testconfig.json is not yet finished and may overload the app due to not handling config refreshes

Almost every leaf [string] or [object] parameter can be templated with go template syntax. I've also added couple helper functions (list will be growing):

random_uuid
random_int
random_int_n
random_ip
random_payload
random_mac_addr
random_port
local_ip
local_mac_addr
base64_encode
base64_decode

Please refer to official go documentation and code for these for now

dainiauskas/db1000n