Cómo Reclamar Resultados de Referencia con Bencher

La mayoría de los resultados de referencia son efímeros. Desaparecen tan pronto como tu terminal alcanza su límite de desplazamiento. Algunos frameworks de pruebas de rendimiento te permiten almacenar en caché los resultados, pero la mayoría solo lo hace localmente. Bencher te permite seguir tus benchmarks tanto de ejecuciones locales como de CI y comparar los resultados, mientras sigues utilizando tu framework de pruebas de rendimiento favorito. Bencher tiene algunas características que facilitan el seguimiento de tus resultados de referencia locales que deben tenerse en cuenta al cambiar a seguir benchmarks en CI.

Proyectos unclaimed

Bencher te permite rastrear resultados de benchmarks sin crear una cuenta. Cuando invocas el subcomando CLI bencher run sin establecer la opción --token, Bencher creará un nuevo Proyecto unclaimed al vuelo para tus resultados de benchmarks. Si seguiste los tutoriales de Inicio Rápido o Inicio Rápido Autohospedado, estabas aprovechando esta funcionalidad.

Cualquiera puede ver y publicar resultados de benchmarks en un Proyecto unclaimed. Para reclamar un Proyecto unclaimed, necesitarás crear una cuenta. Si sigues el enlace de registro Claim this project al final de tu salida de bencher run, reclamarás automáticamente el Proyecto cuando se cree tu cuenta.

Si ya tienes una cuenta de Bencher, entonces puedes navegar a la página pública de rendimiento del Proyecto y hacer clic en el botón Claim this project en la parte superior de la página. De manera similar, si ya tienes un token de API, puedes usar el token de API con la opción --token la próxima vez que invoques bencher run para reclamar el Proyecto.

🐰 IMPORTANTE: Una vez que un Proyecto está claimed, no se puede publicar en él de forma anónima. Debes usar un token de API con la opción --token.

Crear un Token de API

Para usar el bencher run subcomando de CLI con la opción --token, necesitarás crear un token de API.

Haz clic para añadir un Token de API

Pasos:

1. Navega a la Consola de Bencher.
2. Pasa el cursor sobre tu nombre en la esquina superior derecha.
3. Debería aparecer un menú desplegable. Selecciona Tokens.
4. Una vez en la página de Tokens de API, haz clic en el botón ➕ Add.

Proyectos sobre la marcha

Bencher permite crear Proyectos claimed y unclaimed sobre la marcha. Cuando invocas el subcomando de CLI bencher run sin indicar la opción --project o si el slug especificado no coincide con un Proyecto existente, Bencher creará un nuevo Proyecto sobre la marcha para tus resultados de benchmark. Si seguiste los tutoriales de Inicio rápido o Inicio rápido autoalojado, estabas aprovechando esta funcionalidad.

Si no se especifica la opción --project, se generará automáticamente un slug para el Proyecto sobre la marcha basado en:

1. El nombre del directorio padre del repositorio git, si está disponible.
2. El hash corto hexadecimal de 7 caracteres del commit inicial del repositorio git, si está disponible.
3. Una huella alfanumérica de 13 caracteres del equipo local, para sistemas operativos compatibles.

Por ejemplo, un slug de Proyecto sobre la marcha generado podría verse así: project-abc4567-wxyz123456789

Si dependes de un slug de Proyecto sobre la marcha y quieres rastrear resultados de benchmark entre diferentes máquinas, debes usar la opción --project para especificar el Proyecto. De lo contrario, puede crearse un nuevo Proyecto sobre la marcha por cada máquina distinta.

🐰 IMPORTANTE: Si la variable de entorno CI está establecida en true, entonces necesitas usar la opción --project para especificar el Proyecto o establecer la bandera --ci-on-the-fly.

🐰 ¡Felicidades! ¡Has aprendido cómo reclamar tus resultados de referencia! 🎉

Continuar: Seguir Referencias en CI ➡