Compartilhar via

Relatório de exemplo da duração de tarefas do pipeline

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

Quanto tempo leva para diferentes tarefas serem concluídas? Este artigo fornece as consultas que você pode usar para gerar um relatório para um pipeline específico e suas tarefas. Por exemplo, a imagem a seguir lista o 50º, o 80º e o 95º percentil em segundos para todas as tarefas concluídas para um pipeline específico.

Screenshot do relatório de tendência da duração das tarefas nas tabelas do Power BI Pipelines.

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

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

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 para um EntityType, que documenta o tipo de dados de cada propriedade.

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

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, puladas ou abandonadas.

)

Feche a filter() cláusula.

/compute(

Iniciar cláusula 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 cláusula groupby().

(TaskDuration50thPercentileInSeconds, TaskDuration80thPercentileInSeconds,TaskDuration95thPercentileInSeconds, TaskDisplayName))

Agrupar pelo nome da tarefa e os valores de duração da tarefa nos percentis computados de 50º, 80º e 95º.

&$orderby=TaskDuration50thPercentileInSeconds desc

Organize a resposta pela tarefa com a maior duração no percentil 50.

(Opcional) Renomear consulta

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

Screenshot das opções de menu de consulta do Power BI, opção para renomear a consulta.

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.

  • TaskDuration50thPercentileInSeconds
  • 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 amigáveis à exibição. 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 95º Percentil

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 no Editor do Power Query.

Criar o relatório de Tabela

  1. Em Power BI, em Visualizations, selecione o relatório Table. Renomeie campos conforme descrito 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 seguintes campos à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 de duração de tarefa de exemplo na tabela do Power BI Pipelines.

  • Last updated on