Compartilhar via

Resumo do resultado do pipeline para todos os relatórios de exemplo de pipelines

  • Artigo

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

Você pode usar as informações fornecidas neste artigo para consultar métricas de pipeline, como taxa de aprovação, número de falhas, duração e assim por diante, para todos os pipelines e criar um único relatório. Consultas adicionais são fornecidas para obter outras métricas, como duração do pipeline e número de falhas para todos os pipelines de projeto.

A imagem a seguir ilustra o resumo de resultados de todos os pipelines definidos para um projeto desde setembro de 2022.

Captura de tela do relatório de resumo de resultados de todos os pipelines.

Conforme mostrado na imagem a seguir, você pode selecionar qualquer pipeline no menu suspenso Nome do Pipeline e o relatório é alterado para se concentrar no resumo do resultado do pipeline selecionado.

Captura de tela do relatório que mostra o resumo do resultado somente para o pipeline selecionado.

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ê pode usar as consultas a seguir do conjunto de entidades para criar relatórios de resumo de resultados de PipelineRuns pipeline diferentes, mas semelhantes.

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/PipelineRuns?"
               &"$apply=filter( "
	       &"CompletedDate ge {startdate} "
	       &")"
                &"/groupby( "
        &"(Pipeline/PipelineName), "
        &"aggregate( "
            &"$count as TotalCount, "
                &"SucceededCount with sum as SucceededCount, "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount, "
                &"CanceledCount with sum as CanceledCount "
            &")) "
    ,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
  • {startdate} - A data para iniciar seu relatório. Formato: AAAA-MM-DDZ. Exemplo: 2022-09-01Z representa 1º de setembro de 2022. 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() .

CompletedDate ge {startdate}

O pipeline de retorno é executado para data maior que a data especificada.

)

Cláusula de fechamento filter() .

/groupby(

Cláusula de início groupby() /

(Pipeline/PipelineName),

Agrupe os resultados de dados por nome do pipeline.

aggregate(

Start aggregate para cada pipeline.

$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.

CanceledCount with sum as CanceledCount

Conte o número de execuções canceladas como CanceledCount.

))

Fechar aggregate() e groupby() cláusulas.

(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.

Expandir a coluna Pipeline no Editor do Power Query

Antes de criar o relatório, expanda a Pipeline coluna que retorna registros que podem conter um ou mais campos.

  1. Feche o Editor Avançado.

  2. No Editor do Power Query, escolha o botão de expansão de Pipeline coluna, verifique se ele PipelineName está selecionado e escolha OK.

    Captura de tela do menu de expansão da coluna Pipelines.

    A tabela agora contém a entidade Pipeline.PipelineNameexpandida .

    Captura de tela da coluna Pipeline.PipelineName.

Alterar o tipo de dados da coluna

No Editor do Power Query, selecione a TotalCount coluna e, em seguida, selecione Tipo de Dados no menu Transformar e escolha Número Inteiro. Para obter mais informações sobre como alterar o tipo de dados, consulte Transformar dados do Analytics para gerar relatórios do Power BI, 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 Pipeline.PipelineName para Pipeline Name, ou TotalCount para Total Count. 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 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 Gráfico de Colunas Empilhadas

  1. No Power BI, em Visualizações, escolha o relatório Gráfico de Colunas Empilhadas .

    Captura de tela das seleções de campos de visualização para todas as execuções de pipeline relatório.

  2. Adicione Pipeline.PipelineName ou a coluna Pipeline Name renomeada para Eixo.

  3. Adicione os seguintes campos a Valores na ordem indicada, clique com o botão direito do mouse em cada campo e verifique se a Soma está selecionada.

    • SucceededCount
    • FailedCount
    • CanceledCount
    • PartiallySucceededCount.

  4. Para adicionar uma segmentação de dados ao relatório, desmarque o relatório e selecione Segmentação de dados no painel Visualizações .

    • Adicione Pipeline.PipelineName ou a coluna Pipeline Name renomeada para Campo.
      Captura de tela do painel Visualizações, Segmentação de Dados, Nome do Pipeline adicionado.

    • Para alterar a segmentação de dados de uma lista para uma opção de menu suspenso, selecione o ícone Formatar seu pincel visual no painel Visualizações e selecione a opção Lista suspensa em vez de Lista.

      Captura de tela do painel Visualizações, Segmentação de dados, opções de configurações, Lista suspensa selecionada.

O relatório aparece da seguinte forma.

Captura de tela do exemplo de Relatório de Resumo de Resultados de Todos os Pipelines.