Relatório de exemplo de tendência de taxa de aprovação de pipeline

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

Este artigo mostra como criar um relatório com tendência da taxa de aprovação diária de um pipeline. A taxa de aprovação de um pipeline é a porcentagem de execuções de pipeline bem-sucedidas comparada com o total de execuções. É semelhante ao gráfico "Tendência da taxa de aprovação" do relatório de taxa de aprovação do pipeline. A imagem a seguir mostra um exemplo dessa tendência.

Captura de tela do relatório de tendência da taxa de aprovação de execuções de pipelines do Power BI.

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

Para criar relatórios de tendência de taxa de aprovação diferentes, mas semelhantes, use as consultas a seguir do PipelineRuns conjunto de entidades.

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

Tendência de taxa de aprovação para um pipeline nomeado

As consultas a seguir retornam as execuções de pipeline para um pipeline específico com base em uma data de início especificada.

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/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/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 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} - 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}'

Retorne execuções de pipeline para o pipeline especificado.

and CompletedDate ge {startdate}

Retorne execuções de pipeline na data especificada ou após ela.

and CanceledCount ne 1

Omita execuções de pipeline canceladas.

)

Fechar cláusula filter().

/groupby(

Iniciar cláusula groupby().

(CompletedOn/Date),

Agrupe por data de conclusão da execução de pipeline.

aggregate

Inicie a cláusula aggregate para todas as execuções de pipeline que correspondam aos critérios de filtro.

($count as TotalCount,

Conte o número total de execuções como TotalCount.

SucceededCount with sum as SucceededCount ,

Conte o número de execuções bem-sucedidas como SucceededCount.

FailedCount with sum as FailedCount,

Conte o número de execuções com falha como FailedCount.

PartiallySucceededCount with sum as PartiallySucceededCount))

Conte o número de execuções parcialmente bem-sucedidas como PartiallySucceededCount. Fechar cláusulas aggregate() e groupby().

/compute(

Início da cláusula compute().

SucceededCount mul 100.0 div TotalCount as PassRate,

Calcule PassRate para cada dia dividindo o número de execuções bem-sucedidas pelo número total de execuções.

FailedCount mul 100.0 div TotalCount as FailRate,

Calcule FailRate para cada dia dividindo o número de execuções com falha pelo número total de execuções.

PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate)

Calcule PartiallySuccessfulRate para cada dia dividindo o número de execuções parcialmente bem-sucedidas pelo número total de execuções.

&$orderby=CompletedOn/Date asc

Ordene o resultado em ordem crescente com base na data de execução do pipeline.

Tendência de taxa de aprovação para uma ID de pipeline

Você pode renomear pipelines. Para impedir que os relatórios do Power BI não sejam interrompidos quando você alterar o nome de um pipeline, use o ID do pipeline em vez do nome. Você pode obter o ID do pipeline no URL da página de execuções de pipeline.

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

As consultas a seguir retornam as execuções de pipeline para uma ID de pipeline específica com base em uma data de início especificada.

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/PipelineRuns?"
        &"$apply=filter( "
                &"PipelineId eq {pipelineId} "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendência da taxa de aprovação, filtro por ramo

Talvez você queira exibir a tendência da taxa de aprovação de um pipeline somente para uma ramificação específica. Para criar o relatório, siga estas etapas extras, juntamente com as etapas descritas nas seções Alterar Tipo de Dados da Coluna e Criar o Relatório de Gráfico de Linhas.

  • Expanda Branch para Branch.BranchName.
  • Selecione Segmentação de Visualização do Power BI e adicione Branch.BranchName ao Campo de segmentação de dados.
  • Selecione a ramificação da segmentação da qual você precisa ver a tendência da taxa de aprovação.

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/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(Branch/BranchName, CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendência da taxa de aprovação, filtrar por motivo de compilação

Talvez você queira exibir a tendência da taxa de aprovação de um pipeline apenas por Motivos do Build específicos (manual/BatchedCI, Pull Request e assim por diante). Para criar o relatório, siga estas etapas extras, juntamente com as etapas descritas nas seções Alterar Tipo de Dados da Coluna e Criar o Relatório de Gráfico de Linhas.

  • Selecione Segmentador no painel Visualizações e adicione o RunReason ao campo do Segmentador.
  • Selecione o motivo da execução pela segmentação da qual você precisa ver a tendência da taxa de aprovação.

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/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(RunReason, CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendência da taxa de aprovação para todos os pipelines de projeto

Use as consultas a seguir para exibir a tendência de taxa de aprovação de todos os pipelines do projeto em um único relatório. Para criar o relatório, siga estas etapas extras junto com o que está descrito nas seções Alterar tipo de dados da coluna e Criar o relatório do gráfico de linhas.

  • Expanda Pipeline para Pipeline.PipelineName.
  • Selecione Segmentação no painel Visualizações e adicione o campo Pipeline.PipelineName ao Campo da segmentação.
  • Selecione o pipeline de compilação da segmentação da qual você precisa ver a tendência da taxa de aprovação.

Consulte o relatório de exemplo de Resumo de resultados de todos os pipelines, que tem etapas detalhadas semelhantes.

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/PipelineRuns?"
        &"$apply=filter( "
                &"CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
                &") "
        &"/groupby( "
        &"(Pipeline/PipelineName, CompletedOn/Date), "
            &"aggregate "
                &"($count as TotalCount, "
                &"SucceededCount with sum as SucceededCount , "
            &"FailedCount with sum as FailedCount, "
                &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
            &"/compute( "
        &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/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. 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.

Expandir colunas no Editor do Power Query

Antes de criar o relatório, expanda colunas que retornam registros que contêm vários campos. Nesse caso, expanda a coluna CompletedOn para nivelá-la como CompletedOn.Date.
Para saber como expandir itens de trabalho, consulte Transform Analytics para gerar relatórios Power BI.

Alterar o tipo de dados da coluna

No menu Transformar, altere o tipo de dados para as colunas a seguir. Para saber como, consulte Transformar um tipo de dados de coluna.

  • Altere as colunas PassRate, FailRate e PartiallySuccessfulRate para Número Decimal.
  • Altere TotalCount para Número Inteiro.

(Opcional) Renomear campos de coluna

Você pode renomear campos de coluna para serem mais amigáveis. Para saber como, consulte Renomear campos de coluna.

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 relatório de gráfico de linhas

  1. Em Power BI, em Visualizations, selecione o relatório Line chart.

    Captura de tela das seleções de campos de visualização para o relatório do gráfico de linhas de tendência da taxa de aprovação.

  2. Adicione CompletedOn.Date ao eixo X. Clique com o botão direito do mouse no campo e escolha CompletedOn.Date.

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

  4. 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 o relatório resultante.

    Captura de tela do relatório de tendência da taxa de aprovação de execuções de pipelines de exemplo do Power BI.

Conteúdo relacionado

  • Last updated on