Skip to content

Cross platform HTTP/S benchmark tool - Cassowary

homepage-banner

Cassowary is a new cross-platform HTTP/S load testing tool inspired by many classic open source projects such as k6, ab, and httptestat.

Features

  • Two testing modes: standard and custom. URL paths can be selected in custom mode.
  • CI friendly
  • Flexible algorithms: can directly send algorithms to Prometheus PushGateway, or send algorithms in the form of JSON files.
  • Flexible adjustments: can freely choose which HTTP header fields to use.
  • Cross-platform: one binary file can support Linux, Mac OSX, and Windows at the same time.

Installation

Download the binary file from the GitHub Releases page. You can choose to put the Cassowary binary file in PATH so that you can run Cassowary on any page.

Cassowary can be installed on Nix OS.

Usage

Example: 10 users simultaneously send 100 visits to www.example.com.

$ ./cassowary run -u http://www.example.com -c 10 -n 100

Starting Load Test with 100 requests using 10 concurrent users

 100% |████████████████████████████████████████| [1s:0s]            1.256773616s


 TCP Connect.....................: Avg/mean=101.90ms  Median=102.00ms p(95)=105ms
 Server Processing...............: Avg/mean=100.18ms  Median=100.50ms p(95)=103ms
 Content Transfer................: Avg/mean=0.01ms  Median=0.00ms p(95)=0ms

Summary:
 Total Req.......................: 100
 Failed Req......................: 0
 DNS Lookup......................: 115.00ms
 Req/s...........................: 79.57

Example: Access the URL path specified in an external file (which can also be an HTTP path).

$ ./cassowary run -u http://localhost:8000 -c 10 -f urlpath.txt

Starting Load Test with 3925 requests using 10 concurrent users

 100% |████████████████████████████████████████| [0s:0s]            599.467161ms


 TCP Connect.....................: Avg/mean=1.80ms  Median=2.00ms p(95)=3ms
 Server Processing...............: Avg/mean=0.90ms  Median=0.00ms p(95)=3ms
 Content Transfer................: Avg/mean=0.00ms  Median=0.00ms p(95)=0ms

Summary:
 Total Req.......................: 3925
 Failed Req......................: 0
 DNS Lookup......................: 2.00ms
 Req/s...........................: 6547.48

Example: Exporting Cassowary’s Json algorithm

$ ./cassowary run --json-metrics --json-metrics-file=metrics.json -u http://localhost:8000 -c 125 -n 100000

Starting Load Test with 100000 requests using 125 concurrent users

If no export filename is specified for the Json algorithm, the system will use the default filename ‘out.json’.

Example: Specify a Prometheus Pushgateway URL and export Cassowary’s Json algorithm to Prometheus.

$ ./cassowary run -u http://localhost:8000 -c 125 -n 100000 -p http://pushgatway:9091

Starting Load Test with 100000 requests using 125 concurrent users

Example: Adding HTTP Header Fields

$ ./cassowary run -u http://localhost:8000 -c 10 -n 1000 -H 'Host: www.example.com'

Starting Load Test with 1000 requests using 10 concurrent users

Example: Disable http-keep-alive (http-keep-alive is enabled by default)

$ ./cassowary run -u http://localhost:8000 -c 10 -n 1000 --disable-keep-alive

Starting Load Test with 1000 requests using 10 concurrent users

Example: Specifying a Custom CA Certificate

$ ./cassowary run -u http://localhost:8000 -c 10 -n 1000 --ca /path/to/ca.pem

Starting Load Test with 1000 requests using 10 concurrent users

Example: Specify client certificate information

$ ./cassowary run -u http://localhost:8000 -c 10 -n 1000 --cert /path/to/client.pem --key /path/to/client-key.pem

Starting Load Test with 1000 requests using 10 concurrent users

Importing as a module or library

Cassowary can be imported and used in your Go program as a module. We begin by downloading the dependency using go mod:

go mod init test && go get github.com/rogerwelin/cassowary/pkg/client

Here is a simple example of how to run a load test and display the results.

package main

import (
        "encoding/json"
        "fmt"

        "github.com/rogerwelin/cassowary/pkg/client"
)

func main() {
    cass := &client.Cassowary{
        BaseURL:               "http://www.example.com",
        ConcurrencyLevel:      1,
        Requests:              10,
        DisableTerminalOutput: true,
    }
    metrics, err := cass.Coordinate()
    if err != nil {
        panic(err)
    }

        // print results
 fmt.Printf("%+v\n", metrics)

        // or print as json
 jsonMetrics, err := json.Marshal(metrics)
 if err != nil {
  panic(err)
 }

 fmt.Println(string(jsonMetrics))
}

Reference: https://github.com/rogerwelin/cassowary

Small world. Big idea!
  • Welcome to visit the knowledge base of SRE and DevOps!
  • License under CC BY-NC 4.0
  • No personal information is collected
  • Made with Material for MkDocs and generative AI tools
  • Copyright issue feedback me#imzye.com, replace # with @
  • Get latest SRE news and discuss on Discord Channel