commit | 3d08e7980857dfe72b3b5f42f2cb1444ab704e93 | [log] [tgz] |
---|---|---|
author | Michael Anthony Knyszek <mknyszek@google.com> | Thu Mar 24 19:02:53 2022 +0000 |
committer | Michael Knyszek <mknyszek@google.com> | Fri Mar 25 17:02:45 2022 +0000 |
tree | c4aa47cd9cd2588c5269926f2def7e4ba4de5cb5 | |
parent | db1824ac69721bcd9295881a25ee1eb1f1bb63d1 [diff] |
benchseries: make this package public but mark it unstable benchseries' API is currently unstable, so it lives in an internal directory. However, after CL 395175, we're going to want x/build to depend on it. This change moves this package outside of the internal directory, but also adds package documentation marking the API as experimental and unstable. For golang/go#48803. Change-Id: I5811d8f27bfbaa4cdd0e116adccaad5d43c2bcff Reviewed-on: https://go-review.googlesource.com/c/perf/+/395654 Trust: Michael Knyszek <mknyszek@google.com> Run-TryBot: Michael Knyszek <mknyszek@google.com> TryBot-Result: Gopher Robot <gobot@golang.org> Reviewed-by: David Chase <drchase@google.com>
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 https://perfdata.golang.org/ benchmark result storage system.
analysis contains the https://perf.golang.org/ 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 golang.org/x/perf/storage/localperfdata@latest go install golang.org/x/perf/analysis/localperf@latest 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 golang.org/x/perf/cmd/...@latest
. You can also manually git clone the repository and run go install golang.org/x/perf/cmd/...
.
This repository uses Gerrit for code changes. To learn how to submit changes to this repository, see https://golang.org/doc/contribute.html.
The main issue tracker for the perf repository is located at https://github.com/golang/go/issues. Prefix your issue with “x/perf:” in the subject line, so it is easy to find.