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 que diferentes tarefas sejam 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 os percentis 50, 80 e 95 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ê 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 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.
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.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 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}'
O pipeline de retorno é executado para o pipeline especificado.
and PipelineRunCompletedOn/Date ge {startdate}
Retornar resultados de tarefas para um pipeline 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.
)
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 percentil 50 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 percentil 80 de durações de tarefas para todas as tarefas que correspondam aos critérios de filtro.
percentile_cont(ActivityDurationSeconds, 0.95, TaskDisplayName) as TaskDuration95thPercentileInSeconds)
Para cada tarefa, calcule o percentil 95 de durações de tarefas para todas as tarefas que correspondam aos critérios de filtro.
/groupby(
Inicie a groupby() cláusula.
(TaskDuration50thPercentileInSeconds, TaskDuration80thPercentileInSeconds,TaskDuration95thPercentileInSeconds, TaskDisplayName))
Agrupe por tarefa de execução de pipeline e calcule dia a dia duração da tarefa percentil 50, duração da tarefa percentil 80 e duração da tarefa percentil 95.
&$orderby=TaskDuration50thPercentileInSeconds desc
Ordene a resposta por tarefa com maior duração de 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 .
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 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 |
Percentil 80 |
TaskDuration95thPercentileInSeconds |
Percentil 95 |
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 Tabela
No Power BI, em Visualizações, escolha o relatório Tabela . Os campos foram renomeados conforme indicado na seção Renomear campos de coluna.
Adicione os seguintes campos às Colunas na ordem especificada.
- Nome da tarefa
- Percentil 50
- Percentil 80
- Percentil 95
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 uma parte do 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