Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yandex/pandora
A load generator in Go language
https://github.com/yandex/pandora
Last synced: 1 day ago
JSON representation
A load generator in Go language
- Host: GitHub
- URL: https://github.com/yandex/pandora
- Owner: yandex
- License: other
- Created: 2015-11-11T13:05:04.000Z (about 9 years ago)
- Default Branch: dev
- Last Pushed: 2024-05-24T09:51:44.000Z (8 months ago)
- Last Synced: 2024-06-11T17:04:23.066Z (7 months ago)
- Language: Go
- Size: 9.01 MB
- Stars: 389
- Watchers: 18
- Forks: 63
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Authors: AUTHORS
Awesome Lists containing this project
- awesome-observability - Pandora - Pandora is a high-performance load generator in Go language. It has built-in HTTP(S) and HTTP/2 support and you can write your own load scenarios in Go, compiling them just before your test. (4. Load Generators and Synthetic Traffic / Events & Problems)
README
# Pandora
[](https://github.com/yandex/pandora/actions/workflows/release.yml)
[](https://github.com/yandex/pandora/releases)
[](https://github.com/yandex/pandora/actions/workflows/test.yml)
[](https://app.codecov.io/gh/yandex/pandora)
[](https://pkg.go.dev/github.com/yandex/pandora)
[](https://goreportcard.com/report/github.com/yandex/pandora)
[](https://gitter.im/yandex/pandora?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Pandora is a high-performance load generator in Go language. It has built-in HTTP(S) and HTTP/2 support and you can write your own load scenarios in Go, compiling them just before your test.
## Documentation
[Documentation](https://yandex.github.io/pandora/)
## How to start
### Binary releases
[Download](https://github.com/yandex/pandora/releases) available.
### Building from sources
We use go 1.11 modules.
If you build pandora inside $GOPATH, please make sure you have env variable `GO111MODULE` set to `on`.
```bash
git clone https://github.com/yandex/pandora.git
cd pandora
make deps
go install
```
Or let [Yandex.Tank](https://yandextank.readthedocs.io/en/latest/core_and_modules.html#pandora) make it easy for you.
## Extension points
You can write plugins with the next [extension points](https://github.com/progrium/go-extpoints):
You can also cross-compile for other arch/os:
```
GOOS=linux GOARCH=amd64 go build
```
### Running your tests
Run the binary with your config (see config examples at [examples](https://github.com/yandex/pandora/tree/develop/examples)):
```bash
# $GOBIN should be added to $PATH
pandora myconfig.yaml
```
Or use Pandora with [Yandex.Tank](https://yandextank.readthedocs.io/en/latest/core_and_modules.html#pandora) and
[Overload](https://overload.yandex.net).
## Performance tests
These tests are run when a release is created from a tag. See [.github/workflows/yc.yml](.github/workflows/yc.yml)
The scripts used to run are [performance-test/automation](performance-test/automation)
And the tests are in the following directory - [performance-test/test-config](performance-test/test-config).
Where one directory is one test.
Each test has a autostop point configured.
When all tests pass, all their autostop points will be written in the release description.
## Changelog
Install https://github.com/miniscruff/changie
You can add changie completion to you favorite shell https://changie.dev/cli/changie_completion/
### Using
See https://changie.dev/guide/quick-start/
Show current version `changie latest`
Show next minor version `changie next minor`
Add new comments - `changie new` - and follow interface
Create changelog release file - `changie batch v0.5.21`
Same for next version - `changie batch $(changie next patch)`
Merge to main CHANGELOG.md file - `changie merge`