Relatório de amostra de duração do pipeline
Serviços de DevOps do Azure | Azure DevOps Server 2022 | Azure DevOps Server 2020
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 do pipeline.
A imagem a seguir mostra um exemplo de um relatório de duração para um pipeline específico para todas as execuções de pipeline de setembro de 2022 a 15 de dezembro de 2022.
Importante
A integração do Power BI e o acesso ao feed OData do Serviço de Análise estão geralmente disponíveis para os Serviços de DevOps do Azure e o Azure DevOps Server 2020 e versões posteriores. As consultas de exemplo fornecidas neste artigo são válidas apenas no Azure DevOps Server 2020 e versões posteriores e dependem da versão v3.0-preview ou posterior. Nós encorajamos você a usar essas consultas e nos fornecer feedback.
Pré-requisitos
- Acesso: Ser membro de um projeto com pelo menos acesso Básico .
- Permissões: por predefinição, os membros do projeto têm permissão para consultar o Analytics e criar vistas.
- Para obter mais informações sobre outros pré-requisitos relacionados com a ativação de serviços e funcionalidades e atividades gerais de monitorização de dados, consulte Permissões e pré-requisitos para aceder ao Analytics.
Nota
Este artigo pressupõe que você leia Visão geral de relatórios de exemplo usando consultas OData e tenha uma compreensão básica do Power BI.
Consultas de amostra
Você pode usar as seguintes consultas do conjunto de entidades para criar relatórios de duração de PipelineRuns pipeline diferentes, mas semelhantes.
Nota
Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para Pipelines do Azure. 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 um corresponde a um EntityTypearquivo . Para obter mais informações sobre o tipo de dados de cada valor, revise os metadados fornecidos para o .EntityType
Durações de percentil de retorno para um pipeline especificado
Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Consulta em Branco de Dados>. 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 seguintes cadeias de caracteres por seus valores. Não inclua parênteses com a {} sua 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}- O nome do seu projeto de equipa{pipelinename}- O nome do seu pipeline. Exemplo:Fabrikam hourly build pipeline{startdate}- A data para iniciar o seu relatório. Formato: AAAA-MM-DDZ. Exemplo:2021-09-01Zrepresenta 1º de setembro de 2021. Não coloque entre aspas ou parênteses e use dois dígitos para ambos, 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 inicial 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 inicial compute() .
percentile_cont(TotalDurationSeconds, 0.5) as Duration50thPercentileInSeconds,
Calcule o percentil 50 de durações de pipeline de todas as execuções de pipeline que correspondam aos critérios de filtro.
percentile_cont(TotalDurationSeconds, 0.8) as Duration80thPercentileInSeconds,
Calcule o percentil 80 de durações de pipeline de todas as execuções de pipeline que correspondam aos critérios de filtro.
percentile_cont(TotalDurationSeconds, 0.95) as Duration95thPercentileInSeconds)
Calcule o percentil 95 de durações de pipeline de todas as execuções de pipeline que correspondam aos critérios de filtro.
/groupby(
Cláusula inicial groupby() .
(Duration50thPercentileInSeconds, Duration80thPercentileInSeconds,Duration95thPercentileInSeconds))
Agrupe a resposta por Duration50thPercentileInSeconds, Duration80thPercentileInSecondse Duration95thPercentileInSeconds termine a groupby cláusula.
Retornar durações de percentil para um ID de pipeline especificado
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 o ID do pipeline na URL da página de execução do pipeline.
https://dev.azure.com/{organization}/{project}/_build?definitionId= {pipelineid}
Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Consulta em Branco de Dados>. 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 apenas para uma ramificação específica, use as consultas a seguir. Para criar o relatório, execute as etapas adicionais a seguir, juntamente com o que está descrito nas seções de relatório Alterar tipo de dados de coluna e Criar o gráfico de colunas agrupadas.
- Expanda
BranchparaBranch.BranchName. - Adicione o campo Branch.BranchName ao eixo X.
Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Consulta em Branco de Dados>. 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
Durações de percentis de retorno 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, execute as etapas adicionais a seguir, juntamente com o que está descrito nas seções de relatório Alterar tipo de dados de coluna e Criar o gráfico de colunas agrupadas.
- Expanda
PipelineparaPipeline.PipelineName. - Adicione o campo PIpeline.PipelineName ao X-Axis.
Consulte também Resumo dos resultados de todos os pipelines para obter um relatório de exemplo que tenha detalhado etapas semelhantes, conforme exigido aqui.
Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Consulta em Branco de Dados>. 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.
Duration50thPercentileInSecondsDuration80thPercentileInSecondsDuration95thPercentileInSeconds
(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 as alterações
Depois de concluir todas as suas transformações de dados, escolha Fechar & Aplicar no menu Início para salvar a consulta e retornar à guia Relatório no Power BI.
Criar o relatório Gráfico de colunas agrupadas
No Power BI, em Visualizações, escolha o relatório Gráfico de colunas clusterizadas. O exemplo pressupõe que nenhuma coluna foi renomeada.
Adicione os seguintes campos ao Eixo Y, clique com o botão direito do rato em cada campo e certifique-se de que a Soma está selecionada.
Duration50thPercentileInSecondsDuration80thPercentileInSecondsDuration95thPercentileInSeconds
Para alterar o título, a legenda ou outros elementos visuais do relatório, selecione o ícone Formatar o pincel visual no painel Visualizações e ajuste uma ou mais configurações.
Seu relatório deve ser semelhante à imagem a seguir.