Atajo: Ctrl/Cmd + K

Documentación de Commitlane

Métricas personalizadas

Métricas con fórmulas propias y plantillas de informe que se ejecutan manualmente.

Para qué sirve esta sección

Define una fórmula con las variables disponibles y combínala con gráficos, tablas o texto en una plantilla. La vista previa usa datos de muestra; una ejecución consulta los datos del equipo y los filtros elegidos.

Cuándo usarla

  • Calcular una métrica que el equipo ya utiliza.
  • Repetir un informe con la misma fórmula y estructura.

Primeros pasos

  1. 1Elige variables, fórmula, tipo de dato y unidad.
  2. 2Comprueba la vista previa y después ejecuta con un periodo conocido.
  3. 3Añade la métrica a una plantilla y revisa el resultado guardado antes de exportarlo.

Configuración

AjustePara qué sirveCómo usarloError frecuente
Fórmula y unidadDefinen el cálculo y su presentación.Revisa el significado de las variables y los posibles divisores iguales a cero.Interpretar datos ausentes o un error de cálculo como un valor cero.
Filtros y periodoDelimitan los datos reales de cada ejecución.Comprueba equipo, fechas, repositorio y usuario cuando corresponda.Confundir el resultado de muestra con los datos del equipo.
Calendario y destinatariosGuardan estos campos en la plantilla.Genera y comparte los informes manualmente.Esperar que guardar un calendario programe ejecuciones o envíe correos.

Ejemplo de uso

Situación: Quieres reutilizar la tasa de fusión de PR en un informe.

  1. 1Define la fórmula con las variables disponibles y revisa qué pasa si no hay PR.
  2. 2Ejecuta un periodo conocido y comprueba el porcentaje.
  3. 3Guarda la plantilla para las siguientes ejecuciones.

Qué permite comprobar: Podrás repetir el cálculo con filtros explícitos y consultar cada resultado guardado.

Preguntas frecuentes

¿Cambiar una fórmula modifica los informes anteriores?

Las ejecuciones completadas guardan una copia de las fórmulas y valores. Si a una ejecución antigua le falta esa copia, vuelve a ejecutarla para obtener un resultado exportable.

¿Qué puedo exportar?

JSON, CSV y una vista de impresión para guardar como PDF. Los gráficos se exportan como tablas de valores.

¿Por qué falla el cálculo?

Comprueba las variables, la sintaxis, los datos disponibles y los divisores. Un fallo o un dato ausente no se convierte automáticamente en cero.

Consejos

  • Documenta qué significa la fórmula y avisa cuando cambie para mantener comparaciones comprensibles.

Secciones relacionadas