Relatório de exemplo de duração da tarefa de pipeline

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

Quanto tempo leva para diferentes tarefas serem concluídas? Este artigo fornece as consultas a partir das quais você pode gerar um relatório para um pipeline específico e suas tarefas. Por exemplo, a imagem a seguir lista o 50º, 80º e 95º percentil 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 tela do relatório de tendências da tabela de duração da tarefa do Power BI Pipelines.

Importante

A integração do Power BI e o acesso ao feed OData do Serviço de Análise estão em disponibilidade geral para Azure DevOps Services e Azure DevOps Server 2020 e versões posteriores. As consultas de exemplo fornecidas neste artigo são válidas somente em Azure DevOps Server 2020 e versões posteriores e dependem da versão prévia v3.0 ou posterior. Incentivamos você a usar essas consultas e nos fornecer comentários.

Pré-requisitos

Observação

Este artigo pressupõe que você leia Visão geral dos relatórios de exemplo usando consultas OData e tenha uma compreensão básica do Power BI.

Consultas de exemplo

Você consulta o conjunto de entidades para retornar informações de duração da PipelineRunActivityResults? tarefa.

Observação

Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para Azure Pipelines. 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 corresponde a um EntityType. Para obter mais informações sobre o tipo de dados de cada valor, examine os metadados fornecidos para o EntityType.

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/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.5, TaskDisplayName) as TaskDuration50thPercentileInSeconds, "
                &"percentile_cont(ActivityDurationSeconds, 0.8, TaskDisplayName) as TaskDuration80thPercentileInSeconds, "
            &"percentile_cont(ActivityDurationSeconds, 0.95, TaskDisplayName) as TaskDuration95thPercentileInSeconds) "
                &"/groupby( "
            &"(TaskDuration50thPercentileInSeconds, TaskDuration80thPercentileInSeconds,TaskDuration95thPercentileInSeconds, TaskDisplayName)) "
        &"&$orderby=TaskDuration50thPercentileInSeconds desc "
    ,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 pelos valores. Não inclua colchetes {} com sua substituição. Por exemplo, se o nome da sua organização for "Fabrikam", substitua por {organization}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: AAAA-MM-DDZ. Exemplo: 2021-09-01Z representa 1º de setembro de 2021. Não coloque entre aspas ou colchetes e use dois dígitos para 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 de início filter() .

Pipeline/PipelineName eq '{pipelinename}'

O pipeline de retorno é executado para o pipeline especificado.

and PipelineRunCompletedOn/Date ge {startdate}

Retorne os resultados da tarefa para uma execução de pipeline na data especificada ou após ela.

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

Retorne os resultados da tarefa apenas para execuções de pipeline bem-sucedidas ou parcialmente bem-sucedidas.

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

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

)

Feche a filter() cláusula.

/compute(

Cláusula de início compute() .

percentile_cont(ActivityDurationSeconds, 0.5, TaskDisplayName) as TaskDuration50thPercentileInSeconds,

Para cada tarefa, calcule o 50º percentil de durações de tarefas para todas as tarefas que correspondem aos critérios de filtro.

percentile_cont(ActivityDurationSeconds, 0.8, TaskDisplayName) as TaskDuration80thPercentileInSeconds,

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

percentile_cont(ActivityDurationSeconds, 0.95, TaskDisplayName) as TaskDuration95thPercentileInSeconds)

Para cada tarefa, calcule o 95º percentil de durações de tarefas para todas as tarefas que correspondem aos critérios de filtro.

/groupby(

Comece a groupby() cláusula.

(TaskDuration50thPercentileInSeconds, TaskDuration80thPercentileInSeconds,TaskDuration95thPercentileInSeconds, TaskDisplayName))

Agrupe por tarefa da execução do pipeline e calcule a duração da tarefa do percentil 50 do dia, a duração da tarefa do percentil 80 e a duração da tarefa do percentil 95.

&$orderby=TaskDuration50thPercentileInSeconds desc

Ordene a resposta por tarefa com a maior duração do percentil 50.

(Opcional) Renomear consulta

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

Captura de tela das opções de menu de consulta do Power BI, renomear consulta.

Alterar o tipo de dados da coluna

No menu Transformar , altere o tipo de dados das colunas a seguir para Decimal Number**. Para saber como, consulte Transformar um tipo de dados de coluna.
- TaskDuration80thPercentileInSeconds - TaskDuration80thPercentileInSeconds - TaskDuration95thPercentileInSeconds.

(Opcional) Renomear campos de coluna

Você pode renomear campos de coluna. Por exemplo, você pode renomear as colunas a seguir para que elas sejam mais fáceis de exibir. Para saber como, consulte Renomear campos de coluna.

Nome do campo original Campo renomeado
TaskDisplayName Nome da Tarefa
TaskDuration50thPercentileInSeconds Percentil 50
TaskDuration80thPercentileInSeconds 80º Percentil
TaskDuration95thPercentileInSeconds Percentil 95

Feche a consulta e aplique suas alterações

Depois de concluir todas as transformações de dados, escolha Fechar e Aplicar no menu Página Inicial para salvar a consulta e retornar à guia Relatório no Power BI.

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

Criar o relatório Tabela

  1. No Power BI, em Visualizações, escolha o relatório Tabela. Os campos foram renomeados conforme indicado na seção Renomear campos de coluna.

    Captura de tela das seleções de campos de visualização para o relatório da tabela de duração da tarefa.

  2. Adicione os campos a seguir às Colunas na ordem especificada.

    • Nome da tarefa
    • Percentil 50
    • 80º Percentil
    • Percentil 95
  3. Para alterar o título do relatório, selecione o ícone Formatar seu pincel visual no painel Visualizações , selecione Geral, expanda Título e substitua o texto existente.

A imagem a seguir mostra uma parte do relatório resultante.

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