Relatório de exemplo de tendência de duração da tarefa de pipeline
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
Para visualizar o tempo que as tarefas levam para concluir 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.
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 Servidor de DevOps do Azure 2020 e versões posteriores. As consultas de exemplo fornecidas neste artigo são válidas somente em relação ao Azure DevOps Server 2020 e versões posteriores e dependem da versão v3.0-preview ou posterior. Encorajamos você a usar essas consultas e nos fornecer comentários.
Pré-requisitos
- Para exibir dados do 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 Análise e definir exibições do Analytics.
- Para saber mais sobre outros pré-requisitos relacionados à habilitação de serviço e recursos e atividades gerais de acompanhamento 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 do Power BI.
Consultas de exemplo
Você pode usar as seguintes consultas do conjunto de entidades para criar relatórios de tendência de duração de PipelineRunActivityResults? tarefa diferentes, mas semelhantes.
Observação
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 corresponde a um EntityType. Para saber mais sobre o tipo de dados de cada valor, examine os metadados fornecidos para o correspondente EntityType.
Tendência de duração da tarefa para o nome do 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, examine 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 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 projeto da sua equipe{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 aspas ou colchetes 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 de início filter() .
Pipeline/PipelineName eq '{pipelinename}'
Retornar resultados de tarefas para um pipeline específico.
and TaskDisplayName eq '{taskname}'
Retornar resultados de tarefas para uma tarefa específica.
and PipelineRunCompletedOn/Date ge {startdate}
Retornar resultados de tarefas para que o pipeline seja executado na data especificada ou após ela.
and (PipelineRunOutcome eq 'Succeed' or PipelineRunOutcome eq 'PartiallySucceeded')
Retorne resultados de tarefas para execuções de pipeline 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.
)
Cláusula de fechamento filter() .
/compute(
Cláusula de início 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 de início groupby() .
(TaskDuration80thPercentileInSeconds, PipelineRunCompletedOn/Date))
Agrupe por data de conclusão da execução do pipeline e calcule a duração da tarefa no percentil 80 por dia.
&$orderby=PipelineRunCompletedOn/Date asc
Solicite a resposta por data de conclusão.
Tendência de duração da tarefa para um pipeline, especifique a ID 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 a ID do pipeline na URL da página de execução de pipelines.
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, examine 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 de duração da tarefa nos percentis 50, 80 e 90 para 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 nos percentis 50 e 95 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, examine 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:
- Expanda
BranchparaBranch.BranchName - Alterar o tipo de dados da coluna
- Criar o relatório de gráfico de linhas
- Selecione Segmentação de Dados no painel Visualizações e adicione a
Branch.BranchNameao Campo da segmentação de dados - Selecione a ramificação na segmentação de dados para a qual você precisa ver a tendência de duração da tarefa.
Você pode colar a consulta do Power BI listada abaixo diretamente na janela Obter Consulta em Branco de> Dados . Para obter mais informações, examine 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:
- Alterar o tipo de dados da coluna
- Criar o relatório de gráfico de linhas
- Selecione Segmentação de Dados no painel Visualizações e adicione a
TaskDisplayNameao Campo da segmentação de dados - Selecione a tarefa na segmentação de dados para a qual você precisa ver a tendência de duração da tarefa.
Você pode colar a consulta do Power BI listada abaixo diretamente na janela Obter Consulta em Branco de> Dados . Para obter mais informações, examine 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. Basta inserir um novo nome no painel Configurações de Consulta .
Expandir colunas em Editor do Power Query
Antes de criar o relatório, você precisará expandir colunas que retornam registros que contêm vários campos. Neste caso, convém expandir a PipelineRunCompletedOn coluna para nivelá-la para PipelineRunCompletedOn.Date.
Para saber como expandir itens de trabalho, confira 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
Você pode renomear campos de coluna. Por exemplo, você pode renomear a coluna TaskDuration80thPercentileInSeconds para 80th Percentile. Para saber como, consulte Renomear campos de coluna.
Feche a consulta e aplique suas alterações
Depois de concluir todas as transformações de dados, escolha Fechar & Aplicar no menu Página Inicial 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 Gráfico de linhas.
Adicionar
PipelineRunCompletedOn.Dateao eixo X. Clique com o botão direito do mouse no campo e escolha PipelineRunCompletedOn.Date no lugar de Date Hierarchy.Adicione
TaskDuration80thPercentileInSecondsao Eixo Y e clique com o botão direito do mouse nele para garantir que a opção Soma esteja selecionada.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.
Artigos relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de