Datos recopilados de DORA Metrics
Descripción general
DORA Metrics genera eventos que tienen campos y etiquetas asociados.
| Tipo de evento | Descripción |
|---|
| Implementación | Una única implementación de código identificada de forma única por etiquetas de entorno, servicio y versión.
Las implementaciones se pueden marcar como fallidas y se utilizan para calcular la frecuencia de implementación, la tasa de fallas en los cambios y el tiempo de recuperación de implementaciones fallidas. |
| Solicitud de extracción | Una solicitud de extracción incluida en una implementación. Contiene metadatos como el autor, los revisores, las etiquetas y el tiempo dedicado a redactar, revisar y fusionar. Las confirmaciones (commits) están anidadas dentro de su solicitud de extracción asociada.
Las solicitudes de extracción se utilizan para analizar los flujos de trabajo de revisión de código y el tiempo de ciclo a nivel de PR. |
| Confirmación | Un evento generado para cada confirmación individual incluida en una implementación. Contiene metadatos y se vincula automáticamente a la implementación correspondiente. Las confirmaciones (commits) están anidadas dentro de su solicitud de extracción asociada.
Las confirmaciones se utilizan para calcular el tiempo de entrega de cambios. |
Nota: Los eventos de DORA Metrics tienen un período de retención de 2 años.
Todos los eventos contienen las siguientes etiquetas si hay alguna disponible:
serviceteamenvversionsourcerepository_id
Para obtener más información sobre el uso de etiquetas, consulte Primeros pasos con las etiquetas.
Los eventos de implementación se pueden enriquecer con etiquetas personalizadas para filtrar DORA Metrics. Existen dos fuentes potenciales para estas etiquetas:
- Catalog: Si un evento de implementación está asociado con servicios en Catalog, se enriquece automáticamente con la etiqueta
language y las etiquetas personalizadas definidas en Service Definitions. - API de DORA Metrics: Se pueden agregar hasta 100 etiquetas personalizadas proporcionadas por el usuario a los eventos de implementación en la API.
Para obtener más información sobre el uso de etiquetas personalizadas en DORA Metrics, consulte Descripción general de DORA Metrics.
Campos específicos del evento
Campos de implementación
| Campo | Descripción |
|---|
Duration | Duración de la implementación. |
Avg Change Lead Time | La duración promedio del tiempo de entrega de cambios de todas las confirmaciones. |
Avg Time to PR Ready | La duración promedio del tiempo hasta que el PR esté listo de todas las confirmaciones. |
Avg Review Time | La duración promedio del tiempo de revisión de todas las confirmaciones. |
Avg Merge Time | La duración promedio del tiempo de fusión de todas las confirmaciones. |
Avg Time to Deploy | La duración promedio del tiempo hasta la implementación de todas las confirmaciones. |
Number of Commits | Recuento de todas las confirmaciones incluidas en una implementación. |
Deployment Type | Tipo de implementación (standard, rollback o rollforward). |
Change Failure | Booleano que indica si una implementación está marcada como una falla en los cambios. |
Recovery Time | Duración en segundos entre el finished_at de una implementación fallida y el finished_at de su corrección. Solo disponible para implementaciones marcadas como fallas en los cambios. |
Remediation Type | El tipo de corrección aplicada (rollback o rollforward). Solo disponible para implementaciones marcadas como fallas en los cambios. |
Campos de solicitud de extracción
| Campo | Descripción |
|---|
PR Cycle Time | Duración total desde la primera confirmación hasta la fusión. |
Time to PR Ready | Duración desde la primera confirmación hasta que la solicitud de extracción se marca como lista para revisión. |
Review Time | Duración desde que la solicitud de extracción se marca como lista para revisión hasta su aprobación. |
Merge Time | Duración desde la aprobación de la solicitud de extracción hasta su fusión. |
Time to Deploy | Duración desde la fusión hasta el inicio de la implementación. |
Deploy Time | Duración desde el inicio hasta el final de la implementación. |
Number of Commits | Cantidad de confirmaciones incluidas en la solicitud de extracción. |
Number of Reviewers | Cantidad de revisores que revisaron la solicitud de extracción. |
Number of Files Changed | Cantidad de archivos modificados en la solicitud de extracción. Solo disponible para GitHub. |
Number of Lines Added | Cantidad de líneas agregadas en la solicitud de extracción. Solo disponible para GitHub. |
Number of Lines Deleted | Cantidad de líneas eliminadas en la solicitud de extracción. Solo disponible para GitHub. |
Total Number of Lines Changed | Cantidad total de líneas agregadas y eliminadas en la solicitud de extracción. Solo disponible para GitHub. |
Time to First Human Review | Duración hasta que la solicitud de extracción recibe su primera revisión realizada por una persona. Solo disponible para GitHub. |
Number of Comments | Cantidad de comentarios en la solicitud de extracción. Solo disponible para GitHub. |
Number of Human Comments | Cantidad de comentarios en la solicitud de extracción hechos por humanos. Solo disponible para GitHub. |
Fully Automated | Booleano que indica si la solicitud de extracción fue creada y fusionada sin intervención humana. |
Creator Bot Type | Tipo de bot que creó la solicitud de extracción. |
Creator Bot Name | Nombre del bot que creó la solicitud de extracción. |
Time CI Failing | Duración total durante la cual CI permaneció en estado fallido en los commits de la solicitud de extracción. Requiere CI Visibility. |
Test Session Duration | Duración total de las sesiones de prueba para el commit de cabecera o de fusión de la solicitud de extracción. Requiere Test Optimization. |
Test Session Duration After Approval | Duración total de las sesiones de prueba para el commit de cabecera o de fusión de la solicitud de extracción después de que esta fuera aprobada. Requiere Test Optimization. |
Time to Pass | Duración desde el primer intento de CI hasta la primera ejecución exitosa del pipeline para el commit de cabecera o de fusión de la solicitud de extracción. Requiere CI Visibility. |
Time to Pass After Approval | Duración desde el primer intento de CI después de la aprobación de la solicitud de extracción hasta la primera ejecución exitosa del pipeline para el commit de cabecera o de fusión de la solicitud de extracción. Requiere CI Visibility. |
Patch Coverage | Porcentaje de líneas nuevas o modificadas en el commit de cabecera o de fusión de la solicitud de extracción que están cubiertas por pruebas. Requiere Code Coverage. |
Campos de commit
| Campo | Descripción |
|---|
Change Lead Time | Duración que le toma a un commit llegar a producción. |
Time to PR Ready | Duración desde la creación del commit hasta que el PR se marca como listo para revisión. |
Review Time | Duración desde que el PR se marca como listo para revisión hasta su aprobación. |
Merge Time | Duración desde la aprobación del PR hasta su fusión. |
Time to Deploy | Duración desde la fusión hasta el inicio de la implementación. |
Deploy Time | Duración desde el inicio hasta el final de la implementación. |
Has Failed Jobs | Booleano que indica si alguna ejecución de un trabajo de CI falló para el commit, incluidos los casos en que tuvo éxito después de un reintento. Requiere CI Visibility. |
Has Failed Tests | Booleano que indica si alguna ejecución de prueba falló debido a una prueba no inestable en el commit. Requiere Test Optimization. |
Has New Flaky Tests | Booleano que indica si se detectaron nuevas pruebas inestables en las sesiones de prueba del commit. Requiere Test Optimization. |
Lecturas adicionales
Documentación, enlaces y artículos útiles adicionales: