Bencher 裸机快速入门

什么是 Bencher？

Bencher是一套持续基准测试工具。你是否曾经因为性能回归影响到了你的用户？ Bencher可以防止这种情况的发生。 Bencher让你有能力在性能回归被合并之前就进行检测和预防。

运行: 使用 完全相同 的裸机运行器和你喜爱的基准测试工具，在本地或CI中执行你的基准测试。bencher CLI在裸机上编排你的基准测试运行并存储其结果。
追踪: 追踪你的基准测试结果的趋势。根据源分支、测试床和度量，使用Bencher web控制台来监视、查询和绘制结果图表。
捕获: 使用 完全相同 的裸机硬件，在本地或CI中捕获性能回归。Bencher使用最先进的、可定制的分析技术在它们被合并之前就检测到性能回归。

基于防止功能回归的原因运行单元测试，我们也应该使用Bencher运行基准测试以防止性能回归。性能问题就是错误！

安装 `bencher` CLI

选择您的操作系统并运行提供的命令来安装 bencher CLI。有关更多详细信息，请参阅bencher CLI安装文档。

⠀

现在，让我们检查您是否已安装 bencher CLI。运行：

bencher --version

您应该会看到：

bencher 0.6.2

创建项目

在推送基准测试镜像之前，您需要一个 Bencher 项目。最简单的方法是运行 bencher run CLI 子命令配合 bencher mock 子命令。运行：

bencher run "bencher mock --count 0"

这会在 Bencher Cloud 上创建一个新项目。查看输出中的 View report URL。您的项目 slug 是 URL 中 /perf/ 后面的路径段。例如，如果 URL 是：

https://bencher.dev/perf/my-project-abc1234/reports/709d3476-51a4-4939-9584-75d9a2c04c54

那么您的项目 slug 就是 my-project-abc1234。在后续步骤中您将需要这个项目 slug。

推送您的基准测试镜像

Bencher 裸机在专用硬件上运行打包为 OCI 容器镜像的基准测试。在本快速入门中，我们将使用 bencher CLI Docker 镜像作为基准测试镜像。无需自定义镜像。

首先，从 GitHub Container Registry 拉取 bencher CLI 镜像。运行：

docker pull --platform linux/amd64 ghcr.io/bencherdev/bencher:latest

接下来，为 Bencher OCI 注册表重新标记镜像。将 YOUR_PROJECT_SLUG 替换为上一步中的项目 slug：

docker tag ghcr.io/bencherdev/bencher:latest registry.bencher.dev/YOUR_PROJECT_SLUG:latest

然后，登录 Bencher OCI 注册表并推送镜像：

docker login registry.bencher.dev

docker push registry.bencher.dev/YOUR_PROJECT_SLUG:latest

有关创建自定义镜像的更多详情，请参阅镜像文档。

追踪您的裸机基准测试

您现在可以在专用硬件上追踪基准测试结果了！为此，您将使用 bencher run CLI 子命令来运行基准测试并收集结果。将 YOUR_PROJECT_SLUG 替换为前面步骤中的项目 slug 并运行：

bencher run --project YOUR_PROJECT_SLUG --image YOUR_PROJECT_SLUG:latest noise --format json

我们使用 bencher noise 子命令作为我们的基准测试命令来生成一些样本数据。它测量您的基准测试环境的噪声程度。当我们使用 --format json 选项时，结果会以 Bencher Metric Format (BMF) 格式输出。如果一切正常，输出的末尾应该类似这样：

View report: https://bencher.dev/perf/project-abc4567-wxyz123456789/reports/29d61b7c-5d80-4ac2-a118-f80bc5de431b

View results:
- bencher::noise::cache_jitter (Cache Jitter): https://bencher.dev/perf/project-abc4567-wxyz123456789?branches=88d5192d-5cd1-47c6-a817-056e5968737c&heads=657a8ee9-1f30-49d4-bd9b-ceed02576d7e&testbeds=f3a5db46-a57e-4caf-b96e-f0c1111eaa67&benchmarks=6bed122a-b0d1-42e6-93c1-8736a910ec9c&measures=fdee350f-f53a-44bc-af7c-2f4c51415ea8&start_time=1741390156000&end_time=1743982156000&report=29d61b7c-5d80-4ac2-a118-f80bc5de431b
- bencher::noise::composite (Noise Score): https://bencher.dev/perf/project-abc4567-wxyz123456789?branches=88d5192d-5cd1-47c6-a817-056e5968737c&heads=657a8ee9-1f30-49d4-bd9b-ceed02576d7e&testbeds=f3a5db46-a57e-4caf-b96e-f0c1111eaa67&benchmarks=a5d0aea8-666f-4554-958a-9ad8acf1a20d&measures=995e8a26-58ee-46c4-8ce7-d0162b7d9d86&start_time=1741390156000&end_time=1743982156000&report=29d61b7c-5d80-4ac2-a118-f80bc5de431b
- bencher::noise::compute_jitter (Compute Jitter): https://bencher.dev/perf/project-abc4567-wxyz123456789?branches=88d5192d-5cd1-47c6-a817-056e5968737c&heads=657a8ee9-1f30-49d4-bd9b-ceed02576d7e&testbeds=f3a5db46-a57e-4caf-b96e-f0c1111eaa67&benchmarks=489b1d60-5dbd-43cd-bb96-ba50bcba648a&measures=8b715d47-ed42-4ac5-a380-4fe4143aa159&start_time=1741390156000&end_time=1743982156000&report=29d61b7c-5d80-4ac2-a118-f80bc5de431b
- bencher::noise::io_jitter (I/O Jitter): https://bencher.dev/perf/project-abc4567-wxyz123456789?branches=88d5192d-5cd1-47c6-a817-056e5968737c&heads=657a8ee9-1f30-49d4-bd9b-ceed02576d7e&testbeds=f3a5db46-a57e-4caf-b96e-f0c1111eaa67&benchmarks=0a3da391-2fe3-40ec-8a10-983e81231af8&measures=b34f6fd4-60ff-4866-a7a4-60396aab976a&start_time=1741390156000&end_time=1743982156000&report=29d61b7c-5d80-4ac2-a118-f80bc5de431b

Claim this project: https://bencher.dev/auth/signup?claim=d4b0cd5a-8422-40af-9872-8e18d5d062c4

您现在可以在浏览器中查看每个基准测试的结果。点击或复制粘贴 View results 中的链接。要认领这些结果，请点击或将 Claim this project 链接复制粘贴到您的浏览器中。

🐰 恭喜！您已追踪了您的第一个裸机基准测试结果！ 🎉

继续：如何认领项目 ➡

🤖 该文档由 AI 自动翻译。它可能不准确并且可能包含错误。如果您发现任何错误，请在 GitHub 上提出问题.

Published: Thu, March 26, 2026 at 6:00:00 AM UTC | Last Updated: Sat, April 4, 2026 at 6:00:00 AM UTC