Relatório de exemplo de falhas no estágio de pipeline

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

Este artigo mostra como criar um relatório de falhas diárias de estágio de um pipeline. Este relatório é semelhante ao gráfico 'Tendência de falha' do relatório de taxa de aprovação do Pipeline.

A imagem a seguir mostra um exemplo de relatório de falhas em estágio para um pipeline específico de outubro de 2022 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

Os relatórios de tendências de estágio, tarefa ou falha de trabalho podem ser criados consultando o conjunto de PipelineRunActivityResults entidades.

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 falha por etapas

Para exibir a tendência de falha em estágio para um pipeline específico a partir de uma data especificada, use as consultas a seguir.

Consulta do Power BI

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 'Failed' "
        &"and TaskOutcome eq 'Failed' "
        &") "
            &"/groupby( "
                &"(PipelineRunCompletedOn/Date, PipelineRunId, PipelineJob/StageName ), "
                &"aggregate (FailedCount with sum as FailedCount)) "
            &"/groupby( "
                &"(PipelineRunCompletedOn/Date, PipelineJob/StageName ), "
            &"aggregate "
        &"(cast(FailedCount gt 0, Edm.Int32) with sum as FailedStageCount)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Consulta OData

Você pode usar o código de consulta OData a seguir para modificar ou testar a consulta antes de usá-la no Power BI. Para obter mais informações, consulte Conectar-se usando consultas do Power BI e OData.

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 'Failed'
    and TaskOutcome eq 'Failed'
    )
/groupby(
    (PipelineRunCompletedOn/Date, PipelineRunId, PipelineJob/StageName ),
    aggregate (FailedCount with sum as FailedCount))
/groupby(
    (PipelineRunCompletedOn/Date, PipelineJob/StageName ),
    aggregate
(cast(FailedCount gt 0, Edm.Int32) with sum as FailedStageCount))

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-01Z representa 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 PipelineRunCompletedOn/Date ge {startdate}

Retornar resultados de tarefas para que o pipeline seja executado na data especificada ou após ela.

and PipelineRunOutcome eq 'Failed'

Retornar resultados de tarefas em que o resultado da compilação falhar.

and TaskOutcome eq 'Failed'

Retornar resultados de tarefas em que o resultado da tarefa falhar.

)

Cláusula de fechamento filter .

/groupby(

Cláusula de início groupby() .

(PipelineRunCompletedOn/Date, PipelineRunId, PipelineJob/StageName ),

Agrupe por data de conclusão da execução do pipeline, ID de compilação e nome do estágio.

aggregate (FailedCount with sum as FailedCount))

Para cada dia, construa ID e estágio; Conte o número total de falhas. Será o número total de falhas de tarefa e não falhas de estágio.

/groupby(

Cláusula de início groupby() .

(PipelineRunCompletedOn/Date, PipelineJob/StageName ),

Grupo por dia e nome artístico.

aggregate

Cláusula de início aggregate .

(cast(FailedCount gt 0, Edm.Int32) with sum as FailedStageCount))

Para cada dia, some o número de vezes que um estágio falhou e, em seguida, feche a aggregate cláusula.

Tendência de falha em termos de tarefas

Para exibir a tendência de falha em tarefas sábio, use as consultas a seguir.

Consulta do Power BI

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 'Failed' "
        &"and TaskOutcome eq 'Failed' "
        &") "
            &"/groupby( "
                &"(PipelineRunCompletedOn/Date, TaskDisplayName), "
                &"aggregate "
            &"(FailedCount with sum as FailedCount)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Consulta OData

Você pode usar o código de consulta OData a seguir para modificar ou testar a consulta antes de usá-la no Power BI. Para obter mais informações, consulte Conectar-se usando consultas do Power BI e OData.

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 'Failed'
    and TaskOutcome eq 'Failed'
    )
/groupby(
    (PipelineRunCompletedOn/Date, TaskDisplayName),
    aggregate
(FailedCount with sum as FailedCount))

Tendência de falha no trabalho

Para exibir a tendência de falha de trabalho, use as consultas a seguir.

Consulta do Power BI

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 'Failed' "
        &"and TaskOutcome eq 'Failed' "
        &") "
            &"/groupby( "
                &"(PipelineRunCompletedOn/Date, PipelineRunId, PipelineJob/JobName ), "
                &"aggregate (FailedCount with sum as FailedCount)) "
            &"/groupby( "
                &"(PipelineRunCompletedOn/Date, PipelineJob/JobName ), "
            &"aggregate "
        &"(cast(FailedCount gt 0, Edm.Int32) with sum as FailedJobCount)) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Consulta OData

Você pode usar o código de consulta OData a seguir para modificar ou testar a consulta antes de usá-la no Power BI. Para obter mais informações, consulte Conectar-se usando consultas do Power BI e OData.

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 'Failed'
    and TaskOutcome eq 'Failed'
    )
/groupby(
    (PipelineRunCompletedOn/Date, PipelineRunId, PipelineJob/JobName ),
    aggregate (FailedCount with sum as FailedCount))
/groupby(
    (PipelineRunCompletedOn/Date, PipelineJob/JobName ),
    aggregate
(cast(FailedCount gt 0, Edm.Int32) with sum as FailedJobCount))

(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 as duas colunas a seguir. Para saber como expandir itens de trabalho, confira Transformar dados do Analytics para gerar relatórios do Power BI.

• Expandir PipelineJob para PipelineJob.StageName
• Expandir PipelineRunCompletedOn para PipelineRunCompletedOn.Date

Alterar o tipo de dados da coluna

No menu Transformar, altere o tipo de dados da FailedStageCount coluna para Número Inteiro. Para saber como, consulte Transformar um tipo de dados de coluna.

(Opcional) Renomear campos de coluna

Você pode renomear campos de coluna para aqueles que são mais fáceis de usar. 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 & 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 colunas empilhadas

1. No Power BI, em Visualizações, escolha o relatório Gráfico de colunas empilhadas. O exemplo a seguir pressupõe que ninguém renomeou nenhuma coluna.

   

2. Adicione PipelineRunCompletedOn.Date ao Eixo X, clique com o botão direito do mouse nele e selecione PipelineRunCompletedOn.Date, em vez de Hierarquia de Data.

3. Adicione FailedStagedCount ao Eixo Y clique com o botão direito do mouse nele e verifique se a opção Soma está selecionada.

4. Adicionar PipelineJob.StageName à Legenda.

5. Para alterar o título do relatório, a legenda ou outros elementos visuais do relatório, selecione o ícone Formatar o pincel visual no painel Visualizações e ajuste uma ou mais configurações.

Seu relatório deve ser semelhante à imagem a seguir.

Artigos relacionados

• Construir consultas OData para Análise
• Conectar-se usando consultas do Power BI e OData
• Referência de metadados para Pipelines do Azure
• Relatórios de exemplo e índice de referência rápida
• Segmentações no Power BI