Partilhar via

Relatório de exemplo sobre a tendência da duração das tarefas do pipeline

Azure DevOps Serviços | Azure DevOps Server | Azure DevOps Server 2022

Para visualizar o tempo que as tarefas levam para serem concluídas para um pipeline específico, você pode criar um relatório de tendências. Por exemplo, a imagem a seguir mostra o percentil 80 em segundos para todas as tarefas concluídas para um pipeline específico de 1º de setembro a 15 de dezembro de 2022.

Captura de ecrã do relatório de tendências da duração da tarefa do Power BI Pipelines.

Nota

As consultas de exemplo neste artigo requerem uma versão v3.0-preview ou posterior do feed Analytics OData. Partilhe o seu feedback.

Categoria Requerimentos
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 Google Analytics e criar modos de exibição. 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 assume que lê Visão geral de relatórios de exemplo usando consultas OData e que tem uma compreensão básica de Power BI.

Exemplos de consultas

Você pode usar as seguintes consultas do PipelineRunActivityResults? conjunto de entidades para criar relatórios de tendência de duração de tarefas diferentes, mas semelhantes.

Nota

Para encontrar propriedades disponíveis para filtragem ou relatório, consulte a referência Metadados para Azure Pipelines. Pode filtrar consultas ou devolver propriedades usando qualquer Property valor definido sob um EntityType, ou qualquer NavigationPropertyBinding Path valor listado para um EntitySet. Cada EntitySet corresponde a um EntityType, que documenta o tipo de dados para cada propriedade.

Tendência de duração da tarefa para o nome do pipeline especificado

Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Dados>Consulta em Branco. 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/PipelineRunActivityResults?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelinename}' "
                &"and TaskDisplayName eq '{taskname}' "
                &"and PipelineRunCompletedOn/Date ge {startdate} "
        &"and (PipelineRunOutcome eq 'Succeed' or PipelineRunOutcome eq 'PartiallySucceeded') "
        &"and (CanceledCount ne 1 and SkippedCount ne 1 and AbandonedCount ne 1) "
            &"    ) "
                &"/compute( "
                &"percentile_cont(ActivityDurationSeconds, 0.8, PipelineRunCompletedDateSK) as TaskDuration80thPercentileInSeconds) "
            &"/groupby( "
                &"(TaskDuration80thPercentileInSeconds, PipelineRunCompletedOn/Date)) "
            &"&$orderby=PipelineRunCompletedOn/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 pelos teus valores. Não inclua as chaves {} na 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 projeto da sua equipa.
  • {pipelinename} - O nome do seu pipeline. Exemplo: pipeline de construção horária da Fabrikam.
  • {startdate} - A data para iniciar o seu relatório. Formato: AAAA-MM-DDZ. Exemplo: 2026-09-01Z representa 1 de setembro de 2026. Não coloque entre aspas ou parênteses e use dois dígitos para ambos, mês e data.
  • {taskname} - O nome de exibição da tarefa para a qual se necessita da tendência de duração.

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

Retornar resultados de tarefas para um pipeline específico.

and TaskDisplayName eq '{taskname}'

Retornar os resultados de uma tarefa específica.

and PipelineRunCompletedOn/Date ge {startdate}

Retornar resultados de tarefas para execuções de pipeline realizadas na data especificada ou após essa data.

and (PipelineRunOutcome eq 'Succeed' or PipelineRunOutcome eq 'PartiallySucceeded')

Retornar os resultados de tarefas apenas para execuções de pipelines que foram bem-sucedidas ou parcialmente bem-sucedidas.

and (CanceledCount ne 1 and SkippedCount ne 1 and AbandonedCount ne 1)

Omitir execuções de pipeline que foram canceladas, ignoradas ou abandonadas.

)

Fechar cláusula filter().

/compute(

Cláusula inicial compute() .

percentile_cont(ActivityDurationSeconds, 0.8, PipelineRunCompletedDateSK) as TaskDuration80thPercentileInSeconds)

Para cada dia, calcule o percentil 80 de durações de tarefas de todas as tarefas que correspondem aos critérios de filtro.

/groupby(

Cláusula inicial groupby() .

(TaskDuration80thPercentileInSeconds, PipelineRunCompletedOn/Date))

Agrupe pela data de conclusão da execução do pipeline e calcule a duração da tarefa correspondente ao percentil 80 de forma diária.

&$orderby=PipelineRunCompletedOn/Date asc

Organize a resposta pela data de conclusão.

Tendência de duração da tarefa para um pipeline, especificar ID do pipeline

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

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

Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Dados>Consulta em Branco. 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/PipelineRunActivityResults?"
        &"$apply=filter( "
                &"Pipeline/PipelineId eq {pipelineid} "
                &"and TaskDisplayName eq '{taskname}' "
                &"and PipelineRunCompletedOn/Date ge {startdate} "
        &"and (PipelineRunOutcome eq 'Succeed' or PipelineRunOutcome eq 'PartiallySucceeded') "
        &"and (CanceledCount ne 1 and SkippedCount ne 1 and AbandonedCount ne 1) "
            &") "
                &"/compute( "
                &"percentile_cont(ActivityDurationSeconds, 0.8, PipelineRunCompletedDateSK) as TaskDuration80thPercentileInSeconds) "
            &"/groupby( "
                &"(TaskDuration80thPercentileInSeconds, PipelineRunCompletedOn/Date)) "
            &"&$orderby=PipelineRunCompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendência da duração das tarefas para os percentis 50, 80 e 90 de um pipeline

Para exibir a tendência de duração da tarefa calculada usando outro valor de percentil, use a consulta a seguir que fornece a duração da tarefa dos percentis 50 e 95 juntamente com o percentil 80.

Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Dados>Consulta em Branco. 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/PipelineRunActivityResults?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelinename}' "
                &"and TaskDisplayName eq '{taskname}' "
                &"and PipelineRunCompletedOn/Date ge {startdate} "
        &"and (PipelineRunOutcome eq 'Succeed' or PipelineRunOutcome eq 'PartiallySucceeded') "
        &"and (CanceledCount ne 1 and SkippedCount ne 1 and AbandonedCount ne 1) "
            &") "
                &"/compute( "
                &"percentile_cont(ActivityDurationSeconds, 0.5, PipelineRunCompletedDateSK) as TaskDuration50thPercentileInSeconds, "
            &"percentile_cont(ActivityDurationSeconds, 0.8, PipelineRunCompletedDateSK) as TaskDuration80thPercentileInSeconds, "
                &"percentile_cont(ActivityDurationSeconds, 0.95, PipelineRunCompletedDateSK) as TaskDuration95thPercentileInSeconds) "
            &"/groupby( "
        &"(TaskDuration50thPercentileInSeconds, TaskDuration80thPercentileInSeconds, TaskDuration95thPercentileInSeconds, PipelineRunCompletedOn/Date)) "
    &"&$orderby=PipelineRunCompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendência de duração da tarefa para um pipeline filtrado por ramificação

Para exibir a tendência de duração de uma tarefa para uma ramificação específica, use a consulta a seguir. Para criar o relatório, execute as seguintes etapas:

Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Dados>Consulta em Branco. 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/PipelineRunActivityResults?"
        &"$apply=filter( "
                &" Pipeline/PipelineName eq '{pipelinename}' "
                &" and TaskDisplayName eq '{taskname}' "
                &" and PipelineRunCompletedOn/Date ge {startdate} "
        &" and (PipelineRunOutcome eq 'Succeed' or PipelineRunOutcome eq 'PartiallySucceeded') "
        &" and (CanceledCount ne 1 and SkippedCount ne 1 and AbandonedCount ne 1) "
            &" ) "
                &"/compute( "
                &" percentile_cont(ActivityDurationSeconds, 0.8, BranchSK, PipelineRunCompletedDateSK) as TaskDuration80thPercentileInSeconds) "
            &"/groupby( "
                &" (TaskDuration80thPercentileInSeconds, Branch/BranchName, PipelineRunCompletedOn/Date)) "
            &"&$orderby=PipelineRunCompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendência de duração da tarefa para todas as tarefas de pipeline

Para exibir a tendência de duração da tarefa para todas as tarefas de pipeline em um único relatório, use a consulta a seguir. Para criar o relatório, execute as seguintes etapas:

Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Dados>Consulta em Branco. 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/PipelineRunActivityResults?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelinename}' "
                &"and PipelineRunCompletedOn/Date ge {startdate} "
                &"and (PipelineRunOutcome eq 'Succeed' or PipelineRunOutcome eq 'PartiallySucceeded') "
        &"and (CanceledCount ne 1 and SkippedCount ne 1 and AbandonedCount ne 1) "
        &") "
            &"/compute( "
                &"percentile_cont(ActivityDurationSeconds, 0.8, TaskDisplayName, PipelineRunCompletedDateSK) as TaskDuration80thPercentileInSeconds) "
                &"/groupby( "
            &"(TaskDuration80thPercentileInSeconds, TaskDisplayName, PipelineRunCompletedOn/Date)) "
                &"&$orderby=PipelineRunCompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

(Opcional) Renomear consulta

Você pode renomear o rótulo de consulta padrão, Query1, para algo mais significativo. Introduza um novo nome no painel de Definições de Consulta .

Captura de ecrã das opções do menu de consulta Power BI, renomear a consulta.

Expandir colunas no Editor do Power Query

Antes de criar o relatório, você precisará expandir as colunas que retornam registros contendo vários campos. Nesse caso, você desejará expandir a PipelineRunCompletedOn coluna para nivelá-la para PipelineRunCompletedOn.Date.
Para aprender a 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 da TaskDuration80thPercentileInSeconds coluna para Número decimal. Para saber como, consulte Transformar um tipo de dados de coluna.

(Opcional) Renomear campos de coluna

Pode renomear os campos das colunas para serem mais amigáveis para o utilizador. Para saber como, consulte Renomear campos de coluna.

Feche a consulta e aplique as alterações

Quando terminares todas as transformações de dados, seleciona Fechar e Aplicar no menu Inicial . Esta ação guarda a consulta e devolve-o ao separador Report no Power BI.

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

Criar o relatório do gráfico de linha

  1. No Power BI, em Visualizações, escolha o relatório Diagrama.

    Captura de tela das seleções de campos de visualização para o relatório de gráfico de linha com tendência da duração da tarefa.

  2. Adicionar PipelineRunCompletedOn.Date ao Eixo X. Clique com o botão direito do mouse no campo e escolha PipelineRunCompletedOn.Date no lugar de Date Hierarchy.

  3. Adicione TaskDuration80thPercentileInSeconds ao Eixo Y e clique com o botão direito do mouse nele para garantir que a Soma esteja selecionada.

  4. Para alterar o título do relatório, selecione o ícone Formatar o pincel visual no painel Visualizações , selecione Geral, expanda Título e substitua o texto existente.

A imagem a seguir mostra o relatório resultante.

Captura de ecrã do relatório de tendência da duração das tarefas do Power BI Pipelines.

  • Last updated on