Partilhar via

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

  • Artigo

Serviços de DevOps do Azure | 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 a duração das pipelines e o número de falhas para todas as pipelines dos projetos.

A imagem a seguir ilustra o resumo dos 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.

Como é mostrado na imagem abaixo, pode selecionar qualquer fluxo de trabalho no Nome do Fluxo de Trabalho do menu suspenso e o relatório altera-se para focar no resumo dos resultados do fluxo de trabalho selecionado.

Captura de tela do relatório que mostra o resumo do resultado apenas 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 geralmente disponíveis para os Serviços de DevOps do Azure e o Azure DevOps Server 2020 e versões posteriores. As consultas de exemplo fornecidas neste artigo são válidas apenas no Azure DevOps Server 2020 e versões posteriores e dependem da versão v3.0-preview ou posterior. Nós encorajamos você a usar essas consultas e nos fornecer feedback.

Categoria Requerimentos
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 Google Analytics e criar modos de exibição. Para obter mais informações sobre outros pré-requisitos relacionados com a ativação de serviços e funcionalidades e atividades gerais de monitorização de dados, consulte Permissões e pré-requisitos para aceder ao Analytics.

Nota

Este artigo pressupõe que tenha lido Visão geral de relatórios de exemplo usando consultas OData e que tenha uma compreensão básica do Power BI.

Consultas de exemplo

Você pode usar as seguintes consultas do conjunto de entidades PipelineRuns pipeline para criar relatórios de resumo de resultados que são diferentes, mas semelhantes.

Nota

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 as suas consultas ou retornar propriedades usando qualquer um dos Property valores sob um EntityType ou valores NavigationPropertyBinding Path disponíveis com um EntitySet. Cada EntitySet corresponde a um EntityType. Para obter mais informações sobre o tipo de dados de cada valor, consulte os metadados fornecidos para o correspondente EntityType.

Copie e cole a seguinte consulta do Power BI diretamente na janela Obter Dados>Consulta em Branco. 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 seguintes cadeias de caracteres por seus valores. Não inclua colchetes {} na sua 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} - O nome do seu projeto de equipa
  • {startdate} - A data para iniciar o seu relatório. Formato: AAAA-MM-DDZ. Exemplo: 2022-09-01Z representa 1 de setembro de 2022. Não coloque entre aspas ou parênteses 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 inicial filter().

CompletedDate ge {startdate}

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

)

Fechar cláusula filter().

/groupby(

Cláusula inicial groupby() /

(Pipeline/PipelineName),

Agrupe os resultados por nome do pipeline.

aggregate(

Cláusula 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 tentativas falhadas 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 ecrã das opções do menu de consulta do Power BI, consulta de mudança de nome.

Expandir coluna Pipeline no Power Query Editor

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 da Pipeline coluna, certifique-se de que PipelineName está selecionado e, em seguida, selecione OK.

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

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

    Captura de ecrã 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 as alterações

Depois de concluir todas as suas transformações de dados, escolha Fechar & Aplicar no menu Início para salvar a consulta e retornar à guia Relatório no Power BI.

Captura de ecrã da opção Fechar e Aplicar do Power Query Editor.

Criar o relatório Gráfico de colunas empilhadas

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

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

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

  3. Adicione os seguintes campos a Valores na ordem indicada, clique com o botão direito do rato em cada campo e certifique-se de que 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 a Campo.
      Captura de ecrã do painel Visualizações, Cortador, Adicionado Nome do pipeline.

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

      Captura de ecrã do painel Visualizações, Segmentação de dados, opções de definições, Lista pendente selecionada.

O relatório é apresentado da seguinte forma.

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