Exemplo de relatório de duração de 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 Duração do pipeline do Relatório de duração de 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 diferentes, mas 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 um EntityType, que documenta o tipo de dados de cada propriedade.

Retornar 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} - 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}'

Retorne execuções de pipeline para o pipeline especificado.

and CompletedDate ge {startdate}

Retorne execuções de pipeline 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 das durações de pipeline de todas as execuções de pipeline que correspondem aos critérios de filtro.

percentile_cont(TotalDurationSeconds, 0.8) as Duration80thPercentileInSeconds,

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

percentile_cont(TotalDurationSeconds, 0.95) as Duration95thPercentileInSeconds)

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

/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 um ID de pipeline especificado

Você pode renomear pipelines. Para garantir que os relatórios do Power BI não se corrompam quando você alterar o nome do pipeline, use o ID do pipeline em vez do nome do pipeline. Você pode obter o ID do pipeline no URL da página de execuções de 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 durações de percentil para um pipeline especificado, filtrar 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 de percentil 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 de gráfico de colunas clusterizado.

  • 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 exemplo de relatório de coluna clusterizada Duração de pipelines do Power BI.

Conteúdo relacionado

  • Last updated on