Relatório de amostra de tendência de duração do pipeline
Serviços de DevOps do Azure | Azure DevOps Server 2022 | Azure DevOps Server 2020
Este artigo mostra como criar um relatório que mostra quanto tempo o pipeline normalmente leva para ser concluído com êxito. A tendência diária do relatório de duração do pipeline é semelhante ao gráfico de tendência da taxa de pipeline do relatório de taxa de passagem do pipeline.
A imagem a seguir mostra um exemplo de um relatório de tendência de duração.
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
- Para visualizar dados do Google Analytics e consultar o serviço, você precisa ser membro de um projeto com acesso Básico ou superior. Por padrão, todos os membros do projeto recebem permissões para consultar o Google Analytics e definir exibições do Google Analytics.
- Para saber mais sobre outros pré-requisitos relacionados à ativação de serviços e recursos e atividades gerais de controle de dados, consulte Permissões e pré-requisitos para acessar o Google Analytics.
Nota
Este artigo pressupõe que você leu Visão geral de relatórios de exemplo usando consultas OData e tem uma compreensão básica do Power BI.
Consultas de amostra
Você pode usar as seguintes consultas do PipelineRuns conjunto de entidades para criar relatórios de tendência de duração de 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 saber mais sobre o tipo de dados de cada valor, revise os metadados fornecidos para o .EntityType
Obter tendência de duração do percentil 80 para um pipeline especificado
Você pode colar a consulta do Power BI listada abaixo 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.8,CompletedDateSK) as Duration80thPercentileInSeconds) "
&"/groupby( "
&"(Duration80thPercentileInSeconds, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,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.8,CompletedDateSK) 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.
/groupby(
Iniciar groupby()
(Duration80thPercentileInSeconds, CompletedOn/Date))
Agrupe por data de conclusão da execução do pipeline e calcule a duração do pipeline do percentil 80 no dia.
&$orderby=CompletedOn/Date asc
Encomende a resposta até à 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 o ID do pipeline na URL da página de execução do pipeline.
https://dev.azure.com/{organization}/{project}/_build?definitionId= `{pipelineid}`
Você pode colar a consulta do Power BI listada abaixo 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.8,CompletedDateSK) as Duration80thPercentileInSeconds) "
&"/groupby( "
&"(Duration80thPercentileInSeconds, CompletedOn/Date)) "
&"&$orderby=CompletedOn/Date asc "
,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4])
in
Source
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 do percentil 50 e 90, juntamente com o percentil 80.
Você pode colar a consulta do Power BI listada abaixo 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,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 ramo
Para exibir a tendência de 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 linhas.
- Expanda
BranchparaBranch.BranchName. - Selecione Segmentação de Dados de Visualização do Power BI e adicione
Branch.BranchNameao 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.
Você pode colar a consulta do Power BI listada abaixo 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.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
Tendência de duração para todas as reservas de projetos
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 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 linhas.
- Expanda
PipelineparaPipeline.PipelineName. - Selecione Segmentação de Dados no painel Visualizações e adicione o
Pipeline.PipelineNamao Campo da segmentação de dados. - Selecione o pipeline na segmentação de dados para o qual você precisa ver a tendência da taxa de aprovação do pipeline.
Você pode colar a consulta do Power BI listada abaixo 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.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 colunas no Power Query Editor
Antes de criar o relatório, você precisará expandir as colunas que retornam registros contendo vários campos. Nesse caso, você desejará expandir a CompletedOn coluna para nivelá-la para CompletedOn.Date.
Para saber como expandir itens de trabalho, consulte 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 o Duration80thPercentileInSecondsNú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 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 de gráfico de linhas
No Power BI, em Visualizações, escolha o relatório de gráfico de linhas.
Adicione
CompletedOn.Dateao X-Axis, clique com o botão direito do mouse nele e selecione CompletedOn.Date, em vez de Date Hierarchy.Adicionar
Duration80thPercentileInSecondsao eixo Y Clique com o botão direito do mouse nele e verifique se Soma está selecionado.
O relatório exibido deve ser semelhante à imagem a seguir.
Artigos relacionados
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários