Bencherでベンチマーク結果を請求する方法
ほとんどのベンチマーク結果は一時的なものです。 端末がスクロールバックの制限に達するとすぐに消えてしまいます。 ベンチマークハーネスの中には結果をキャッシュできるものもありますが、そのほとんどはローカルにしか保存されません。 Bencherは、ローカルおよびCIランのベンチマークを追跡し、結果を比較することができますが、それでもお気に入りのベンチマークハーネスを使用することができます。 Bencherにはローカルベンチマーク結果を追跡するのを簡単にするいくつかの機能があり、それはCIでベンチマークを追跡する際に考慮される必要があります。
unclaimed プロジェクト
Bencherを使用すると、アカウントを作成せずにベンチマークの結果を追跡できます。bencher run CLIサブコマンドを --tokenオプションを設定せずに呼び出すと、Bencherはベンチマークの結果用に新しいunclaimedオンザフライプロジェクトを作成します。クイックスタートや自社ホストクイックスタートチュートリアルに従った場合、あなたはこの機能を活用していました。
誰でもunclaimedプロジェクトにベンチマークの結果を視聴したり投稿したりできます。unclaimedプロジェクトを主張するには、アカウントを作成する必要があります。bencher runの出力の最後にある Claim this project サインアップリンクに従うと、アカウントが作成されると同時にプロジェクトを自動的に主張します。
すでにBencherアカウントを持っている場合、プロジェクトの公開パフォーマンスページに移動し、ページの上部にある Claim this project ボタンをクリックできます。同様に、すでにAPIトークンを持っている場合、次回bencher runを呼び出す際に --tokenオプションとAPIトークンを使用してプロジェクトを主張できます。
🐰 重要: プロジェクトが
claimedになってしまうと、匿名で投稿することはできなくなります。 必ず--tokenオプションを使用してAPIトークンを使用しなければなりません。
APIトークンを作成する
bencher run CLIサブコマンドを
—tokenオプションで使用するには、
APIトークンを作成する必要があります。
APIトークンを追加するにはここをクリック
手順:
- Bencherコンソールに移動します。
- 右上の自分の名前にマウスを合わせます。
- ドロップダウンメニューが表示されます。
Tokensを選択します。 - APIトークンのページで、
➕ Addボタンをクリックします。
オンザフライプロジェクト
Bencherは、claimedおよびunclaimedプロジェクトをオンザフライで作成することができます。bencher run CLIサブコマンドを実行する際に、the --project optionを設定しないか、指定されたスラッグが既存のプロジェクトと一致しない場合、Bencherは新しいオンザフライプロジェクトをベンチマーク結果用に作成します。クイックスタートまたはセルフホステッドクイックスタートチュートリアルに従った場合、この機能を利用していました。
the --project optionが指定されていない場合、次の基準に基づいてオンザフライプロジェクトのスラッグが生成されます：
- 利用可能な場合、
gitリポジトリの親ディレクトリの名前。 - 利用可能な場合、
gitリポジトリの初回コミットの7桁の16進ショートハッシュ。 - サポートされているオペレーティングシステムの場合、ローカルマシンの13桁のアルファベット数値のフィンガープリント。
たとえば、生成されたオンザフライプロジェクトのスラッグは次のようになります：project-abc4567-wxyz123456789
🐰 重要: オンザフライプロジェクトのスラッグに依存しており、異なるマシン間でベンチマーク結果を追跡したい場合、 the
--projectoptionを使用してプロジェクトスラッグを指定しなければなりません。 そうしないと、異なるマシンごとに新しいオンザフライプロジェクトが作成される可能性があります。
🐰 おめでとうございます！ベンチマーク結果の請求方法を学びました！ 🎉