Relatório de exemplo de tendência de duração do pipeline

Artigo
07/17/2024

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Este artigo mostra como criar um relatório que mostra quanto tempo seu pipeline normalmente leva para ser concluído com êxito. O relatório de tendência diária da duração do pipeline é semelhante ao gráfico de tendência da taxa de pipeline do relatório de taxa de aprovação do pipeline.

A imagem a seguir mostra um exemplo de um relatório de tendência de duração.

Captura de tela do relatório de tendência de duração do Power BI Pipelines.

Importante

A integração do Power BI e o acesso ao feed OData do Serviço de Análise estão em disponibilidade geral para Azure DevOps Services e Azure DevOps Server 2020 e versões posteriores. As consultas de exemplo fornecidas neste artigo são válidas somente em Azure DevOps Server 2020 e versões posteriores e dependem da versão prévia v3.0 ou posterior. Incentivamos você a usar essas consultas e nos fornecer comentários.

Pré-requisitos

Nível de acesso: você deve ser membro de um projeto com acesso básico ou superior.
Permissão: por padrão, os membros do projeto têm permissão para consultar o Analytics e criar vistas da propriedade.
Para obter mais informações sobre outros pré-requisitos relacionados à ativação de serviços e recursos e atividades gerais de rastreamento de dados, consulte Permissões e pré-requisitos para acessar o Analytics.

Observação

Este artigo pressupõe que você tenha lido Visão geral de relatórios de exemplo usando consultas OData e tenha uma compreensão básica do Power BI.

Consultas de exemplo

Você pode usar as consultas a seguir do PipelineRuns conjunto de entidades para criar relatórios de tendências de duração de pipeline diferentes, mas semelhantes.

Observação

Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para Azure Pipelines. Você pode filtrar suas consultas ou retornar propriedades usando qualquer um dos Property valores em um EntityType ou NavigationPropertyBinding Path valores disponíveis com um EntitySet. Cada EntitySet corresponde a um EntityType. Para obter mais informações sobre o tipo de dados de cada valor, examine os metadados fornecidos para o EntityType.

Obter tendência de duração do 80º percentil para um pipeline especificado

Consulta do Power BI
Consulta OData

Você pode colar a consulta do Power BI listada abaixo diretamente na janela Obter Consulta em Branco de> Dados . Para obter mais informações, examine Visão geral de relatórios de exemplo usando consultas 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

Você pode usar o código de consulta OData a seguir para modificar ou testar a consulta antes de usá-la no Power BI. Para obter mais informações, consulte Conectar-se usando consultas do Power BI e OData.

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

Cadeias de caracteres de substituição e detalhamento de consulta

Substitua as cadeias de caracteres a seguir pelos valores. Não inclua colchetes {} com sua substituição. Por exemplo, se o nome da sua organização for "Fabrikam", substitua por {organization}Fabrikam, não {Fabrikam}.

{organization} - Nome da sua organização
{project} - Nome do seu projeto de equipe
{pipelinename} - Nome do pipeline. Exemplo: Fabrikam hourly build pipeline
{startdate} - A data para iniciar seu relatório. Formato: AAAA-MM-DDZ. Exemplo: 2021-09-01Z representa 1º de setembro de 2021. Não coloque entre aspas ou colchetes e use dois dígitos para mês e data.

Detalhamento da consulta

A tabela a seguir descreve cada parte da consulta.

Parte da consulta

Descrição

$apply=filter(

Cláusula de início filter() .

Pipeline/PipelineName eq '{pipelinename}'

O pipeline de retorno é executado para o pipeline especificado.

and CompletedDate ge {startdate}

O pipeline de retorno é executado na data especificada ou após ela.

and (SucceededCount eq 1 or PartiallySucceededCount eq 1)

Retorne apenas as execuções bem-sucedidas ou parcialmente bem-sucedidas.

)

Cláusula de fechamento filter() .

/compute(

Cláusula de início compute() .

percentile_cont(TotalDurationSeconds, 0.8,CompletedDateSK) as Duration80thPercentileInSeconds)

Calcule o 80º percentil das durações de pipeline de todas as execuções de pipeline que correspondem aos critérios de filtro.

/groupby(

Iniciar groupby()

(Duration80thPercentileInSeconds, CompletedOn/Date))

Agrupe por data de conclusão da execução do pipeline e duração do pipeline de 80º percentil calculada no dia.

&$orderby=CompletedOn/Date asc

Ordene a resposta por data de conclusão.

Filtrar por ID do pipeline, em vez de Nome do pipeline

Os pipelines podem ser renomeados. Para garantir que os relatórios do Power BI não sejam interrompidos quando o nome do pipeline for alterado, use a ID do pipeline em vez do nome do pipeline. Você pode obter a ID do pipeline na URL da página de execuções de pipeline.

https://dev.azure.com/{organization}/{project}/_build?definitionId= `{pipelineid}`

Consulta do Power BI
Consulta 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

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

Obtenha o percentil 50 e 90, juntamente com a tendência de duração do percentil 80

Você pode querer exibir a tendência de duração calculada usando outro valor de percentil. As consultas a seguir fornecem a duração do pipeline de 50º e 90º percentil, juntamente com o 80º percentil.

Consulta do Power BI
Consulta 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

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

Filtrar por ramificação

Para exibir a tendência de duração de um pipeline somente para uma ramificação específica, use as consultas a seguir. Para criar o relatório, execute as etapas extras a seguir, juntamente com o que está descrito nas seções Alterar tipo de dados de coluna e Criar o relatório Gráfico de linhas.

Expanda Branch para Branch.BranchName.
Selecione Segmentação de Visualização do Power BI e adicione Branch.BranchName ao Campo da segmentação de dados.
Selecione o pipeline na segmentação de dados para o qual você precisa ver a tendência de duração do pipeline.

Consulta do Power BI
Consulta 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

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

Tendência de duração para todos os pipelines de projeto

Talvez você queira exibir a tendência de duração de todos os pipelines do projeto em um único relatório. Para criar o relatório, execute as etapas extras a seguir, juntamente com o que está descrito nas seções Alterar tipo de dados de coluna e Criar o relatório Gráfico de linhas.

Expanda Pipeline para Pipeline.PipelineName.
Selecione Segmentação de Dados no painel Visualizações e adicione o Pipeline.PipelineNam ao Campo da segmentação de dados.
Selecione o pipeline da segmentação de dados para o qual você precisa ver a tendência da taxa de aprovação do pipeline.

Consulta do Power BI
Consulta 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

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

Expandir colunas em Editor do Power Query

Antes de criar o relatório, você precisará expandir colunas que retornam registros que contêm vários campos. Nesse caso, você desejará expandir a CompletedOn coluna para nivelá-la para CompletedOn.Date.
Para saber como expandir itens de trabalho, confira Transformar dados do Analytics para gerar relatórios do Power BI.

Alterar o tipo de dados da coluna

No menu Transformar, altere o tipo de dados para Duration80thPercentileInSeconds Número decimal. Para saber como, consulte Transformar um tipo de dados de coluna.

(Opcional) Renomear campos de coluna

Você pode renomear campos de coluna. Por exemplo, você pode renomear a coluna Pipeline.PipelineName para Pipeline Name, ou TotalCount para Total Count. Para saber como, consulte Renomear campos de coluna.

Feche a consulta e aplique suas alterações

Depois de concluir todas as transformações de dados, escolha Fechar e Aplicar no menu Página Inicial para salvar a consulta e retornar à guia Relatório no Power BI.

Criar o relatório Gráfico de linhas

No Power BI, em Visualizações, escolha o relatório Gráfico de linhas.
Adicione CompletedOn.Date ao eixo X, clique com o botão direito do mouse e selecione CompletedOn.Date, em vez de Hierarquia de datas.
Adicionar Duration80thPercentileInSeconds ao eixo Y, clique com o botão direito do mouse e certifique-se de que a Soma esteja selecionada.

O relatório exibido deve ser semelhante à imagem a seguir.

Captura de tela do relatório de tendência de duração de pipelines de exemplo do Power BI.

Compartilhar via

Relatório de exemplo de tendência de duração do pipeline

Pré-requisitos

Consultas de exemplo

Obter tendência de duração do 80º percentil para um pipeline especificado

Cadeias de caracteres de substituição e detalhamento de consulta

Detalhamento da consulta

Filtrar por ID do pipeline, em vez de Nome do pipeline

Obtenha o percentil 50 e 90, juntamente com a tendência de duração do percentil 80

Filtrar por ramificação

Tendência de duração para todos os pipelines de projeto

Expandir colunas em Editor do Power Query

Alterar o tipo de dados da coluna

(Opcional) Renomear campos de coluna

Feche a consulta e aplique suas alterações

Criar o relatório Gráfico de linhas

Comentários

Recursos adicionais

Compartilhar via

Relatório de exemplo de tendência de duração do pipeline

Pré-requisitos

Consultas de exemplo

Obter tendência de duração do 80º percentil para um pipeline especificado

Cadeias de caracteres de substituição e detalhamento de consulta

Detalhamento da consulta

Filtrar por ID do pipeline, em vez de Nome do pipeline

Obtenha o percentil 50 e 90, juntamente com a tendência de duração do percentil 80

Filtrar por ramificação

Tendência de duração para todos os pipelines de projeto

Expandir colunas em Editor do Power Query

Alterar o tipo de dados da coluna

(Opcional) Renomear campos de coluna

Feche a consulta e aplique suas alterações

Criar o relatório Gráfico de linhas

Artigos relacionados

Comentários

Recursos adicionais