Informe de ejemplo de tendencia de duración de canalización
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
En este artículo se muestra cómo crear un informe que muestra cuánto tiempo tarda normalmente la canalización en completarse correctamente. La tendencia diaria del informe de duración de la canalización es similar al gráfico de tendencias de velocidad de canalización del informe de velocidad de paso de canalización.
En la imagen siguiente se muestra un ejemplo de un informe de tendencias de duración.
Importante
La integración y el acceso de Power BI a la fuente OData del servicio Analytics están disponibles con carácter general para Azure DevOps Services y Azure DevOps Server 2020 y versiones posteriores. Las consultas de ejemplo proporcionadas en este artículo solo son válidas en Azure DevOps Server 2020 y versiones posteriores, y dependen de la versión v3.0-preview o posterior. Le recomendamos que use estas consultas y nos proporcione sus comentarios.
Requisitos previos
- Para ver los datos de Analytics y consultar el servicio, debe ser miembro de un proyecto con acceso básico o superior. De forma predeterminada, a todos los miembros del proyecto se les conceden permisos para consultar Analytics y definir vistas de Analytics.
- Para obtener información sobre otros requisitos previos relacionados con la habilitación de servicios y características y las actividades generales de seguimiento de datos, consulte Permisos y requisitos previos para acceder a Analytics.
Nota:
En este artículo se supone que ha leído Información general de informes de ejemplo mediante consultas de OData y que tiene conocimientos básicos de Power BI.
Consultas de ejemplo
Puede usar las siguientes consultas del PipelineRuns conjunto de entidades para crear informes de tendencias de duración de canalización diferentes pero similares.
Nota:
Para determinar las propiedades disponibles con fines de filtro o informe, consulte Referencia de metadatos para Azure Pipelines. Puede filtrar las consultas o devolver propiedades mediante cualquiera de los Property valores de un EntityType valor o NavigationPropertyBinding Path disponible con .EntitySet Cada EntitySet uno corresponde a un objeto EntityType. Para obtener más información sobre el tipo de datos de cada valor, revise los metadatos proporcionados para el correspondiente EntityType.
Obtención de la tendencia de duración del percentil 80 para una canalización especificada
Puede pegar la consulta de Power BI que se muestra a continuación directamente en la ventana Obtener consulta en blanco de datos>. Para obtener más información, consulte Introducción a los informes de ejemplo mediante consultas de OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
&"$apply=filter( "
&"Pipeline/PipelineName eq '{pipelinename}' "
&"and CompletedDate ge {startdate} "
&"and (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
&") "
&"/compute( "
&"percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds) "
&"/groupby( "
&"(Duration80thPercentileInSeconds, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Cadenas de sustitución y desglose de consultas
Sustituya las cadenas siguientes por sus valores. No incluya corchetes {} con la sustitución. Por ejemplo, si el nombre de la organización es "Fabrikam", reemplace por {organization}Fabrikam, no {Fabrikam}por .
{organization}- El nombre de la organización{project}- El nombre del proyecto de equipo{pipelinename}: el nombre de la canalización. Ejemplo:Fabrikam hourly build pipeline{startdate}- La fecha de inicio del informe. Formato: AAAA-MM-DDZ. Ejemplo:2021-09-01Zrepresenta el 1 de septiembre de 2021. No incluya entre comillas o corchetes y use dos dígitos tanto para el mes como para la fecha.
Desglose de consultas
En la tabla siguiente se describe cada parte de la consulta.
Elemento de consulta
Descripción
$apply=filter(
Cláusula Start filter() .
Pipeline/PipelineName eq '{pipelinename}'
Devuelve ejecuciones de canalización para la canalización especificada.
and CompletedDate ge {startdate}
Devuelve las ejecuciones de canalización en o después de la fecha especificada.
and (SucceededCount eq 1 or PartiallySucceededCount eq 1)
Devuelve solo las ejecuciones correctas o parcialmente correctas.
)
Cláusula Close filter() .
/compute(
Cláusula Start compute() .
percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds)
Calcule el percentil 80 de las duraciones de canalización de todas las ejecuciones de canalización que coincidan con los criterios de filtro.
/groupby(
Iniciar groupby()
(Duration80thPercentileInSeconds, CompletedOn/Date))
Agrupe por fecha de finalización de la ejecución de la canalización y calcule la duración de la canalización del percentil 80.
&$orderby=CompletedOn/Date asc
Ordene la respuesta por fecha de finalización.
Filtrar por identificador de canalización, en lugar de nombre de canalización
Se puede cambiar el nombre de las canalizaciones. Para asegurarse de que los informes de Power BI no se interrumpan cuando se cambia el nombre de la canalización, use el identificador de canalización en lugar del nombre de la canalización. Puede obtener el identificador de canalización de la dirección URL de la página de ejecuciones de canalización.
https://dev.azure.com/{organization}/{project}/_build?definitionId= `{pipelineid}`
Puede pegar la consulta de Power BI que se muestra a continuación directamente en la ventana Obtener consulta en blanco de datos>. Para obtener más información, consulte Introducción a los informes de ejemplo mediante consultas de OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
&"$apply=filter( "
&"PipelineId eq {pipelineId} "
&"and CompletedDate ge {startdate} "
&"and (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
&") "
&"/compute( "
&"percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds) "
&"/groupby( "
&"(Duration80thPercentileInSeconds, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Obtener percentil 50 y 90, junto con la tendencia de duración del percentil 80
Es posible que desee ver la tendencia de duración calculada con otro valor de percentil. Las siguientes consultas proporcionan la duración de la canalización de percentil 50 y 90 junto con el percentil 80.
Puede pegar la consulta de Power BI que se muestra a continuación directamente en la ventana Obtener consulta en blanco de datos>. Para obtener más información, consulte Introducción a los informes de ejemplo mediante consultas de OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
&"$apply=filter( "
&"Pipeline/PipelineName eq '{pipelinename}' "
&"and CompletedDate ge {startdate} "
&"and (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
&") "
&"/compute( "
&"percentile_cont(TotalDurationSeconds, 0.5,CompletedDateSK) as Duration50thPercentileInSeconds, "
&"percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds, "
&"percentile_cont(TotalDurationSeconds, 0.90,CompletedDateSK) as Duration90thPercentileInSeconds) "
&"/groupby( "
&"(Duration50thPercentileInSeconds, Duration80thPercentileInSeconds, Duration90thPercentileInSeconds, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Filtrar por rama
Para ver la tendencia de duración de una canalización solo para una rama determinada, use las siguientes consultas. Para crear el informe, siga estos pasos adicionales junto con lo que se describe en las secciones Cambiar tipo de datos de columna y Crear el informe gráfico de líneas.
- Expanda
BranchenBranch.BranchName. - Seleccione Segmentación de visualización de Power BI y agregue
Branch.BranchNameal campo de la segmentación. - Seleccione la canalización en la segmentación para la que necesita ver la tendencia de duración de la canalización.
Puede pegar la consulta de Power BI que se muestra a continuación directamente en la ventana Obtener consulta en blanco de datos>. Para obtener más información, consulte Introducción a los informes de ejemplo mediante consultas de OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
&"$apply=filter( "
&"Pipeline/PipelineName eq '{pipelinename}' "
&"and CompletedDate ge {startdate} "
&"and (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
&") "
&"/compute( "
&"percentile_cont(TotalDurationSeconds, 0.8,BranchSK, CompletedDateSK) as Duration80thPercentileInSeconds) "
&"/groupby( "
&"(Duration80thPercentileInSeconds, Branch/BranchName, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Tendencia de duración para todas las canalizaciones de proyecto
Es posible que desee ver la tendencia de duración de todas las canalizaciones del proyecto en un único informe. Para crear el informe, siga estos pasos adicionales junto con lo que se describe en las secciones Cambiar tipo de datos de columna y Crear el informe gráfico de líneas.
- Expanda
PipelineenPipeline.PipelineName. - Seleccione Segmentación en el panel Visualizaciones y agregue al
Pipeline.PipelineNamcampo de la segmentación. - Seleccione la canalización en la segmentación de datos para la que necesita ver la tendencia de la velocidad de paso de canalización.
Puede pegar la consulta de Power BI que se muestra a continuación directamente en la ventana Obtener consulta en blanco de datos>. Para obtener más información, consulte Introducción a los informes de ejemplo mediante consultas de OData.
let
Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
&"$apply=filter( "
&"CompletedDate ge {startdate} "
&"and (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
&") "
&"/compute( "
&"percentile_cont(TotalDurationSeconds, 0.8,PipelineId, CompletedDateSK) as Duration80thPercentileInSeconds) "
&"/groupby( "
&"(Duration80thPercentileInSeconds, Pipeline/PipelineName, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
Expandir columnas en Editor de Power Query
Antes de crear el informe, deberá expandir columnas que devuelvan registros que contengan varios campos. En este caso, querrá expandir la CompletedOn columna para aplanarla a CompletedOn.Date.
Para obtener información sobre cómo expandir elementos de trabajo, consulte Transformación de datos de Análisis para generar informes de Power BI.
Cambio del tipo de datos de columna
En el menú Transformar , cambie el tipo de datos de a Duration80thPercentileInSecondsNúmero decimal. Para obtener información sobre cómo hacerlo, consulte Transformación de un tipo de datos de columna.
(Opcional) Cambiar el nombre de los campos de columna
Puede cambiar el nombre de los campos de columna. Por ejemplo, puede cambiar el nombre de la columna Pipeline.PipelineName a Pipeline Nameo TotalCount a Total Count. Para obtener información sobre cómo hacerlo, consulte Cambiar el nombre de los campos de columna.
Cierre la consulta y aplique los cambios
Una vez que haya completado todas las transformaciones de datos, elija Cerrar y aplicar en el menú Inicio para guardar la consulta y volver a la pestaña Informe en Power BI.
Crear el informe gráfico de líneas
En Power BI, en Visualizaciones, elija el informe Gráfico de líneas.
Agregue
CompletedOn.Dateal eje X, haga clic con el botón derecho en él y seleccione CompletedOn.Date, en lugar de Jerarquía de fechas.Agregue
Duration80thPercentileInSecondsal eje Y, haga clic con el botón derecho en él y asegúrese de que suma está seleccionada.
El informe mostrado debe ser similar a la siguiente imagen.
Artículos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de