Golang跨平台HTTP负载测试工具插件库Cassowary的使用

Cassowary是一个现代HTTP/S、直观且跨平台的负载测试工具，用Go语言编写，适合开发人员、测试人员和系统管理员使用。

主要特性

📌 2种负载测试模式：标准模式和扩展模式（可以从文件中指定URL路径）
📌 CI友好：非常适合作为CI流水线的一部分
📌 灵活的指标输出：支持Cloudwatch指标、Prometheus指标（推送到Prometheus PushGateway）、JSON文件
📌 可配置：能够传递任意HTTP头，能够配置HTTP客户端
📌 支持GET、POST、PUT和PATCH - POST、PUT和PATCH数据可以在文件中定义
📌 跨平台：Linux、Mac OSX和Windows的单一预构建二进制文件
📌 可导入 - 除了CLI工具外，cassowary可以作为模块导入到您的Go应用中
📌 可视化 - Cassowary可以将请求数据导出为png格式的直方图和箱线图

安装方法

常规安装

从GitHub Releases页面获取预构建的二进制文件。

Homebrew (Mac OSX)

$ brew update && brew install cassowary

Docker

$ docker run rogerw/cassowary:v0.14.1 -u http://www.example.com -c 1 -n 10

本地开发

$ GOOS=linux go build -o dist/docker/cassowary cmd/cassowary/*.go
$ docker build -f dist/docker/Dockerfile -t test_cassowary dist/docker
$ docker run test_cassowary -u http://www.example.com -c 1 -n 10

使用示例

常规负载测试

$ ./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

文件模式

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

导出指标到文件

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

导出指标到Prometheus

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

导出指标到Cloudwatch

$ export AWS_REGION=eu-north-1 && ./cassowary run -u http://localhost:8000 -c 125 -n 100000 --cloudwatch

生成直方图

$ ./cassowary run -u http://localhost:8000 -c 10 -n 1000 --histogram

生成箱线图

$ ./cassowary run -u http://localhost:8000 -c 10 -n 1000 --boxplot

带POST数据的测试

$ ./cassowary run -u http://localhost:8000/add-user -c 10 -n 1000 --postfile user.json

指定测试持续时间

$ ./cassowary run -u http://localhost:8000 -n 100 -d 30

添加HTTP头

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

禁用HTTP keep-alive

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

x509认证

$ ./cassowary run -u https://localhost:8443 -c 10 -n 1000 --cert /path/to/client.pem --key /path/to/client-key.pem --ca /path/to/ca.pem --renegotiation once

作为库使用示例

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)
	}

        // 打印结果
	fmt.Printf("%+v\n", metrics)

        // 或以JSON格式打印
	jsonMetrics, err := json.Marshal(metrics)
	if err != nil {
		panic(err)
	}

	fmt.Println(string(jsonMetrics))
}

贡献

欢迎贡献！要请求功能，请创建一个带有feature-request标签的新问题。发现错误？请添加带有bugs标签的问题。也欢迎Pull Request，但请先就请求的功能添加一个issue（除非是简单的错误修复或readme更改）。