Wie man Benchmark-Ergebnisse mit Bencher beansprucht

Die meisten Benchmark-Ergebnisse sind flüchtig. Sie verschwinden, sobald Ihr Terminal das Scrollback-Limit erreicht. Einige Benchmark-Tools erlauben das Zwischenspeichern von Ergebnissen, aber die meisten tun dies nur lokal. Bencher ermöglicht es Ihnen, Ihre Benchmarks sowohl von lokalen als auch von CI-Läufen zu verfolgen und die Ergebnisse zu vergleichen, während Sie weiterhin Ihr bevorzugtes Benchmark-Tool verwenden. Bencher hat einige Funktionen, die es einfach machen, Ihre lokalen Benchmark-Ergebnisse zu verfolgen, die berücksichtigt werden müssen, wenn Sie Benchmarks in CI verfolgen.

unclaimed Projekte

Bencher ermöglicht es Ihnen, Benchmark-Ergebnisse zu verfolgen, ohne ein Konto zu erstellen. Wenn Sie den bencher run CLI-Unterbefehl ohne die Einstellung der Option --token aufrufen, erstellt Bencher ein neues unclaimed On-the-Fly Projekt für Ihre Benchmark-Ergebnisse. Wenn Sie den Schnellstart oder die Self-Hosted Schnellstart Tutorials befolgt haben, haben Sie diese Funktionalität genutzt.

Jeder kann Benchmark-Ergebnisse in ein unclaimed Projekt einsehen und posten. Um ein unclaimed Projekt zu beanspruchen, müssen Sie ein Konto erstellen. Wenn Sie dem Claim this project Anmeldelink am Ende Ihrer bencher run Ausgabe folgen, beanspruchen Sie das Projekt automatisch, wenn Ihr Konto erstellt wird.

Wenn Sie bereits ein Bencher-Konto haben, können Sie zur öffentlichen Perf-Seite des Projekts navigieren und den Claim this project Button oben auf der Seite klicken. Ebenso, wenn Sie bereits einen API-Token haben, können Sie den API-Token mit der Option --token das nächste Mal verwenden, wenn Sie bencher run aufrufen, um das Projekt zu beanspruchen.

🐰 WICHTIG: Sobald ein Projekt claimed ist, kann es nicht mehr anonym gepostet werden. Sie müssen einen API-Token mit der Option --token verwenden.

API-Token erstellen

Um den bencher run-CLI-Unterbefehl mit der der --token Option zu verwenden, müssen Sie einen API-Token erstellen.

Klicken Sie hier, um einen API-Token hinzuzufügen

Schritte:

1. Navigieren Sie zur Bencher-Konsole.
2. Bewegen Sie den Mauszeiger über Ihren Namen in der oberen rechten Ecke.
3. Ein Dropdown-Menü sollte erscheinen. Wählen Sie Tokens.
4. Sobald Sie auf der Seite API-Tokens sind, klicken Sie auf die Schaltfläche ➕ Add.

Projekte im Handumdrehen

Bencher ermöglicht es Ihnen, sowohl claimed als auch unclaimed Projekte im Handumdrehen zu erstellen. Wenn Sie den Bencher-Run-CLI-Befehl ohne Einstellung der Option --project ausführen oder wenn der angegebene Slug keinem bestehenden Projekt entspricht, wird Bencher ein neues Projekt im Handumdrehen für Ihre Benchmark-Ergebnisse erstellen. Wenn Sie die Tutorials Schnellstart oder Selbstgehosteter Schnellstart gefolgt sind, haben Sie bereits von dieser Funktionalität Gebrauch gemacht.

Wenn die Option --project nicht angegeben ist, wird ein Projekt-Slug im Handumdrehen für Sie generiert basierend auf:

1. Dem Namen des übergeordneten Verzeichnisses des git-Repositories, falls verfügbar.
2. Dem 7-stelligen hexadezimalen Kurz-Hash des initialen Commits des git-Repositories, falls verfügbar.
3. Dem 13-stelligen alphanumerischen Fingerabdruck der lokalen Maschine, für unterstützte Betriebssysteme.

Zum Beispiel könnte ein generierter Projekt-Slug im Handumdrehen folgendermaßen aussehen: project-abc4567-wxyz123456789

🐰 WICHTIG: Wenn Sie sich auf einen Projekt-Slug im Handumdrehen verlassen und Benchmark-Ergebnisse über verschiedene Maschinen hinweg verfolgen möchten, müssen Sie die Option --project verwenden, um den Projekt-Slug anzugeben. Andernfalls könnte ein neues Projekt im Handumdrehen für jede verschiedene Maschine erstellt werden.

🐰 Glückwunsch! Du hast gelernt, wie du deine Benchmark-Ergebnisse beanspruchen kannst! 🎉

Weitermachen: Benchmarks in CI verfolgen ➡