command module
v0.5.1 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Mar 28, 2020 License: MIT Imports: 9 Imported by: 0



Build Status View Action GoDoc Demo Demo Benchmarks

a tool for inspecting go test -bench data, and a GitHub Action for continuous benchmarking.



gobenchdata was inspired by the deno.land continuous benchmarks, which aims to display performance improvements and regressions on a continuous basis.

It is available as a GitHub action or a command-line application.

GitHub Action

gobenchdata can be used as GitHub Action for uploading Go benchmark data as JSON to gh-pages and visualizing it with a generated web app (using gobenchdata-web) or your own web application.


For example, in .github/workflows/push.yml, using the new YAML syntax for workflows:

name: Benchmark
    branches: [ master ]

    runs-on: ubuntu-latest
    - name: checkout
      uses: actions/checkout@v1
        fetch-depth: 1
    - name: gobenchdata to gh-pages
      uses: bobheadxi/gobenchdata@v0.3.0
        PRUNE_COUNT: 30
        GO_TEST_FLAGS: -cpu 1,2
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

Learn more about GitHub Actions in the official documentation.


Input variables are configured using jobs.<job_id>.steps.with.

Variable Default Purpose
SUBDIRECTORY . subdirectory of project to run commands from
GO_BENCHMARKS . benchmarks to run (argument for -bench)
GO_TEST_FLAGS additional flags for go test
GO_TEST_PKGS ./... packages to test (argument for go test)
BENCHMARKS_OUT benchmarks.json destination path of benchmark data
PRUNE_COUNT 0 number of past runs to keep (0 keeps everything)
GIT_COMMIT_MESSAGE "add new benchmark run" the commit message for the benchmark update

Environment variables are configured using jobs.<job_id>.steps.env.

Variable Recommended Purpose
GITHUB_TOKEN ${{ secrets.GITHUB_TOKEN }} token to provide access to repository
GITHUB_ACTOR set by GitHub the user to make commits as

The gobenchdata GitHub action eventually generates a JSON file with past benchmarks. You can visualize these continuous benchmarks by creating a web app that reads from the JSON benchmarks file, or by using gobenchdata-web:

go get -u go.bobheadxi.dev/gobenchdata/x/gobenchdata-web
git checkout gh-pages
gobenchdata-web --title "my benchmarks" # generates a web app in your working directory

The generator offers a variety of customization options documented under gobenchdata-web help to configure descriptions, charts, and more. The easiest way to use gobenchdata-web is to set up a Makefile in your gh-pages branch to update the web app using the latest version of gobenchdata-web with your desired configuration - for example:

all: build
	git commit -a -m "regenerate web app"

	gobenchdata-web --title "gobenchdata continuous benchmark demo" --desc "This is a demo for gobenchdata"

You can test the web app locally using a tool like serve:

serve .

The web application generator is a work in progress. An example site published by this repository is available at gobenchdata.bobheaxi.dev (configuration).

Other examples:

gobenchdata CLI

gobenchdata, which the GitHub Action leverages to manage benchmark data, is also available as a CLI:

go get -u go.bobheadxi.dev/gobenchdata
gobenchdata help

The easiest way to use the CLI is by piping the output of go test -bench to it:

go test -bench . -benchmem ./... | gobenchdata --json bench.json

More detailed usage documentation and examples can be found in the godocs or by running gobenchdata help.

Development and Contributions

Please report bugs and requests in the repository issues!

See CONTRIBUTING.md for more detailed development documentation.



Gobenchdata is a tool for inspecting golang benchmark outputs. To install it, you must have Go installed:

go get -u go.bobheadxi.dev/gobenchdata
gobenchdata help

Then pipe your benchmark into the tool:

go test -bench . -benchmem ./... | gobenchdata --json bench.json

You can create a sort of database of benchmarks by appending new benchmarks to an existing file:

go test -benchtime 10000x -bench . -benchmem ./... | gobenchdata --json benchmarks.json --append

You can also merge results:

gobenchdata merge file1.json file2.json file3.json


Path Synopsis
Package bench provides benchmark output parsing capabilities.
Package bench provides benchmark output parsing capabilities.
Gobenchdata-web is a utility for generating a website template to visualize your continuous benchmark.
Gobenchdata-web is a utility for generating a website template to visualize your continuous benchmark.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL