Compartilhar via

Relatório de exemplo de duração do pipeline

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

Este artigo mostra como obter a duração do pipeline ou o tempo necessário para executar um pipeline. Este relatório é semelhante à métrica de resumo de duração no gráfico de duração do pipeline do relatório de duração do pipeline.

A imagem a seguir mostra um exemplo de relatório de duração para um pipeline específico.

Captura de tela do relatório de colunas agrupadas do Power BI Pipelines Duration.

Observação

As consultas de exemplo neste artigo exigem versão prévia v3.0 ou posterior do feed OData do Analytics. Compartilhe seus comentários.

Categoria Requirements
Níveis de acesso - Membro do projeto.
- Pelo menos acesso básico .
Permissões Por padrão, os membros do projeto têm permissão para consultar o Analytics e criar visualizações. 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 de Power BI.

Consultas de exemplo

Para criar relatórios de duração de pipeline que sejam diferentes, mas ao mesmo tempo semelhantes, use as consultas a seguir do conjunto de entidades PipelineRuns.

Observação

Para localizar as propriedades disponíveis para filtragem ou relatório, consulte a referência Metadata para Azure Pipelines. Você pode filtrar consultas ou retornar propriedades usando qualquer valor Property definido em um EntityType ou qualquer valor NavigationPropertyBinding Path listado para um EntitySet. Cada EntitySet mapeia para um EntityType, que documenta o tipo de dados de cada propriedade.

Retorne as durações de percentil para um pipeline especificado

Copie e cole a consulta Power BI a seguir diretamente na janela Get Data>Blank Query. Para obter mais informações, consulte 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.5) as Duration50thPercentileInSeconds, "
                &"percentile_cont(TotalDurationSeconds, 0.8) as Duration80thPercentileInSeconds, "
                &"percentile_cont(TotalDurationSeconds, 0.95) as Duration95thPercentileInSeconds) "
            &"/groupby( "
                &"(Duration50thPercentileInSeconds, Duration80thPercentileInSeconds,Duration95thPercentileInSeconds)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

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

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

  • {organization} - Nome da sua organização
  • {project} - Nome do seu projeto de equipe
  • {pipelinename} - O nome do pipeline. Exemplo: Fabrikam hourly build pipeline
  • {startdate} - A data para iniciar seu relatório. Formato: YYYY-MM-DD seguido por Z (indicador UTC). Exemplo: 2026-09-01Z representa 1º de setembro de 2026. Não coloque entre aspas ou colchetes.

Detalhamento da consulta

A tabela a seguir descreve cada parte da consulta.

Parte da consulta

Descrição

$apply=filter(

Iniciar cláusula 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.

)

Fechar cláusula filter().

/compute(

Iniciar cláusula compute().

percentile_cont(TotalDurationSeconds, 0.5) as Duration50thPercentileInSeconds,

Calcula o 50º percentil de durações do pipeline para todas as execuções de pipeline que correspondem aos critérios de filtro.

percentile_cont(TotalDurationSeconds, 0.8) as Duration80thPercentileInSeconds,

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

percentile_cont(TotalDurationSeconds, 0.95) as Duration95thPercentileInSeconds)

Calcula o 95º percentil da duração do pipeline para todas as execuções de pipeline que atendem aos filtros estabelecidos.

/groupby(

Inicia a cláusula groupby().

(Duration50thPercentileInSeconds, Duration80thPercentileInSeconds,Duration95thPercentileInSeconds))

Agrupa a resposta por Duration50thPercentileInSeconds, Duration80thPercentileInSeconds, e Duration95thPercentileInSeconds e termina a cláusula groupby.

Retornar durações de percentil para uma ID de pipeline especificada

Você pode renomear pipelines. Para garantir que os relatórios de Power BI não interrompam quando você alterar o nome do pipeline, use o ID do pipeline em vez do nome do pipeline. Você pode obter o identificador do pipeline a partir da URL da página de execuções do pipeline.

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

Copie e cole a consulta Power BI a seguir diretamente na janela Get Data>Blank Query. Para obter mais informações, consulte 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( "
                &"PipelineId  eq {pipelineid} "
                &"and CompletedDate ge {startdate} "
                &"and (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
        &") "
        &"/compute( "
            &"percentile_cont(TotalDurationSeconds, 0.5) as Duration50thPercentileInSeconds, "
                &"percentile_cont(TotalDurationSeconds, 0.8) as Duration80thPercentileInSeconds, "
                &"percentile_cont(TotalDurationSeconds, 0.95) as Duration95thPercentileInSeconds) "
            &"/groupby( "
                &"(Duration50thPercentileInSeconds, Duration80thPercentileInSeconds,Duration95thPercentileInSeconds)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Retornar as durações do percentil para um pipeline especificado, filtrando por ramificação

Para exibir a duração de um pipeline somente para uma ramificação específica, use as consultas a seguir. Para criar o relatório, siga estas etapas extras junto com as etapas descritas nas seções Alterar tipo de dados da coluna e Criar o relatório de gráfico de colunas clusterizado.

  • Expanda Branch para Branch.BranchName.
  • Adicione o campo Branch.BranchName ao eixo X.

Copie e cole a consulta Power BI a seguir diretamente na janela Get Data>Blank Query. Para obter mais informações, consulte 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.5, BranchSK) as Duration50thPercentileInSeconds, "
                &"percentile_cont(TotalDurationSeconds, 0.8, BranchSK) as Duration80thPercentileInSeconds, "
                &"percentile_cont(TotalDurationSeconds, 0.95, BranchSK) as Duration95thPercentileInSeconds) "
            &"/groupby( "
                &"(Duration50thPercentileInSeconds, Duration80thPercentileInSeconds,Duration95thPercentileInSeconds, Branch/BranchName)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Retornar durações em percentis para todos os pipelines de projeto

Para exibir a duração de todos os pipelines do projeto em um único relatório, use as consultas a seguir. Para criar o relatório, siga estas etapas extras junto com as etapas descritas nas seções Alterar tipo de dados da coluna e Criar o relatório do gráfico de colunas agrupadas.

  • Expanda Pipeline para Pipeline.PipelineName.
  • Adicione o campo Pipeline.PipelineName ao Eixo X.

Para obter um relatório de exemplo com etapas detalhadas semelhantes, confira o resumo de resultados para todos os pipelines.

Copie e cole a consulta Power BI a seguir diretamente na janela Get Data>Blank Query. Para obter mais informações, consulte 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( "
                &"CompletedDate ge {startdate} "
                &"and (SucceededCount eq 1 or PartiallySucceededCount eq 1) "
                &"    ) "
        &"/compute( "
        &"percentile_cont(TotalDurationSeconds, 0.5, PipelineId) as Duration50thPercentileInSeconds, "
            &"percentile_cont(TotalDurationSeconds, 0.8, PipelineId) as Duration80thPercentileInSeconds, "
                &"percentile_cont(TotalDurationSeconds, 0.95, PipelineId) as Duration95thPercentileInSeconds) "
                &"/groupby( "
            &"(Duration50thPercentileInSeconds, Duration80thPercentileInSeconds,Duration95thPercentileInSeconds, Pipeline/PipelineName)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Alterar o tipo de dados da coluna

No menu Transformar , altere o tipo de dados das colunas a seguir para Número Decimal. Para saber como, consulte Transformar um tipo de dados de coluna.

  • Duration50thPercentileInSeconds
  • Duration80thPercentileInSeconds
  • Duration95thPercentileInSeconds

(Opcional) Renomear campos de coluna

Você pode renomear campos de coluna para serem mais amigáveis. Para saber como, consulte Renomear campos de coluna.

Feche a consulta e aplique suas alterações

Ao concluir todas as transformações de dados, selecione Fechar &Aplicar no menu Página Inicial . Essa ação salva a consulta e retorna você para a guia Report no Power BI.

Captura de tela da opção Fechar e Aplicar do Editor do Power Query.

Criar o relatório de gráfico de colunas clusterizadas

  1. Em Power BI, em Visualizations, selecione o relatório Clustered column chart. O exemplo pressupõe que você não renomeou nenhuma coluna.

    Captura de tela das visualizações de colunas agrupadas e seleções de campo do Power BI Pipelines.

  2. Adicione os campos a seguir ao Eixo Y, clique com o botão direito do mouse em cada campo e verifique se Sum está selecionado.

    • Duration50thPercentileInSeconds
    • Duration80thPercentileInSeconds
    • Duration95thPercentileInSeconds

  3. Para alterar o título, a legenda ou outros componentes visuais do relatório, selecione o ícone de pincel com a legenda "Formatar seu visual" no painel de Visualizações e ajuste uma ou mais configurações.

Seu relatório deve ser semelhante à imagem a seguir.

Captura de tela do relatório de colunas agrupadas de duração de pipelines de exemplo do Power BI.

  • Last updated on