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 al Vuelo

Bencher te permite crear Proyectos claimed y unclaimed al vuelo. Cuando invocas el subcomando CLI bencher run sin establecer la opción --project o si el identificador especificado no coincide con un Proyecto existente, Bencher creará un nuevo Proyecto al vuelo para tus resultados de benchmarck. Si seguiste los tutoriales de Inicio Rápido o Inicio Rápido Autohospedado, te estabas beneficiando de esta funcionalidad.

Si no se especifica la opción --project, entonces se generará un identificador de Proyecto al vuelo basado en:

1. El nombre del directorio padre del repositorio git, si está disponible.
2. El hash corto hexadecimal de 7 dígitos del commit inicial del repositorio git, si está disponible.
3. Una huella dactilar alfanumérica de 13 dígitos de la máquina local, para sistemas operativos compatibles.

Por ejemplo, un identificador de Proyecto generado al vuelo podría verse así: proyecto-abc4567-wxyz123456789

🐰 IMPORTANTE: Si dependes de un identificador de Proyecto al vuelo y deseas rastrear resultados de benchmark en diferentes máquinas, debes usar la opción --project para especificar el identificador del Proyecto. De lo contrario, se puede crear un nuevo Proyecto al vuelo para cada máquina diferente.

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

Continuar: Seguir Referencias en CI ➡