cmd/benchseries: a fresh start commit, because git/gerrit got mad at the old one

This is a squash of all that work, applied using patch.
Testdata in a bit, I intend to rework that.

split defaults into real defaults and bent defaults.
document the defaults
normalize all the times flowing through to UTC.
update time normalization to allow nanosecond time stamps.
add change detection for no-noise benchmarks
tinker around the edges for MK
fixed to be robust with mixed old/new (old = summaries from JSON, DB )
collects residues, per-unit.

The bent defaults ignore a lot of keys to avoid dealing with dirty bent data.

It now has a test of repeatable behavior and order independence.
A few more functions in benchseries have been exported, I added
a convenience function for reading benchmark files.

The floating point code was tweaked to work the same on arm64
and other architectures with fused multiply-add.

Change-Id: I5422ad9454df7577e99492589cec6a68135a4d4a
Trust: David Chase <>
Run-TryBot: David Chase <>
TryBot-Result: Gopher Robot <>
Reviewed-by: Michael Knyszek <>
213 files changed
tree: 84215b4257a9af95cabfd6f1f09f58c082ca56a7
  1. analysis/
  2. benchfmt/
  3. benchmath/
  4. benchproc/
  5. benchstat/
  6. benchunit/
  7. cmd/
  8. influx/
  9. internal/
  10. storage/
  14. go.mod
  15. go.sum

Go performance measurement, storage, and analysis tools

Go Reference

This subrepository holds the source for various packages and tools related to performance measurement, storage, and analysis.

cmd/benchstat contains a command-line tool that computes and compares statistics about benchmarks.

cmd/benchsave contains a command-line tool for publishing benchmark results.

storage contains the benchmark result storage system.

analysis contains the benchmark result analysis system.

Both storage and analysis can be run locally; the following commands will run the complete stack on your machine with an in-memory datastore.

go install
go install
localperfdata -addr=:8081 -view_url_base=http://localhost:8080/search?q=upload: &
localperf -addr=:8080 -storage=http://localhost:8081

The storage system is designed to have a standardized API, and we encourage additional analysis tools to be written against the API. A client can be found in the storage package.


The easiest way to install is to run go install You can also manually git clone the repository and run go install

Report Issues / Send Patches

This repository uses Gerrit for code changes. To learn how to submit changes to this repository, see

The main issue tracker for the perf repository is located at Prefix your issue with “x/perf:” in the subject line, so it is easy to find.