Relatório da amostra da duração do ensaio

Artigo
10/16/2024

Serviços de DevOps do Azure | Azure DevOps Server 2022 | Azure DevOps Server 2020

Os relatórios de duração do teste, semelhantes ao mostrado na imagem a seguir, fornecem informações sobre o número de vezes que um teste é executado e o tempo médio que leva para um determinado teste ser executado durante uma execução de pipeline.

Captura de ecrã do relatório da Tabela de Duração do Teste.

Use as consultas fornecidas neste artigo para gerar os seguintes relatórios:

Duração do teste para o fluxo de trabalho de compilação
Duração do teste para fluxo de trabalho de liberação
Duração do teste para um ramo específico
Duração do teste para um arquivo de teste específico
Duração do teste para um proprietário de teste específico

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.

Pré-requisitos

Acesso: Ser membro de um projeto com pelo menos acesso Básico .
Permissões: por predefinição, os membros do projeto têm permissão para consultar o Analytics e criar vistas.
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 você leia Visão geral de relatórios de exemplo usando consultas OData e tenha uma compreensão básica do Power BI.

Consultas de amostra

Você pode usar as seguintes consultas do conjunto de entidades para criar relatórios de duração de TestResultsDaily teste diferentes, mas semelhantes. O TestResultsDaily conjunto de entidades fornece um instantâneo diário agregado de TestResult execuções, agrupadas por teste.

Nota

Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para Análise de Planos de Teste e 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 um corresponde a um EntityTypearquivo . Para obter mais informações sobre o tipo de dados de cada valor, revise os metadados fornecidos para o .EntityType

Duração do teste para o fluxo de trabalho de compilação

Use as consultas a seguir para exibir o relatório de duração de teste para um pipeline com um fluxo de trabalho de compilação .

Consulta do Power BI
Consulta OData

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/v4.0-preview/TestResultsDaily?"
      &"$apply=filter("
      &"Pipeline/PipelineName eq '{pipelineName}' "
      &"And Date/Date ge {startdate} "
      &"And Workflow eq 'Build'"
      &")/groupby("
      &"(TestSK, Test/TestName),"
      &"aggregate("
      &"ResultCount with sum as TotalCount, "
      &"ResultDurationSeconds with sum as TotalDuration"
      &"))/compute("
      &"TotalDuration div TotalCount as AvgDuration"
      &")",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

Você pode usar o seguinte código de consulta OData 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/v4.0-preview/TestResultsDaily?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}' 
    And Date/Date ge {startdate} 
    And Workflow eq 'Build'
)/groupby(
    (TestSK, Test/TestName),
    aggregate(
        ResultCount with sum as TotalCount,
        ResultDurationSeconds with sum as TotalDuration
    )
)/compute(
    TotalDuration div TotalCount as AvgDuration
)

Duração do teste para o fluxo de trabalho Release

Use as consultas a seguir para exibir o relatório de duração de teste para um pipeline com um fluxo de trabalho de versão .

Consulta do Power BI
Consulta OData

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?"
      &"$apply=filter("
      &"Pipeline/PipelineName eq '{pipelineName}' "
      &"And Date/Date ge {startdate}"
      &")/groupby("
      &"(TestSK, Test/TestName, Workflow),"
      &"aggregate("
      &"ResultCount with sum as TotalCount, "
      &"ResultDurationSeconds with sum as TotalDuration"
      &"))/compute("
      &"TotalDuration div TotalCount as AvgDuration"
      &")",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}' 
    And Date/Date ge {startdate}'
)/groupby(
    (TestSK, Test/TestName, Workflow),
    aggregate(
        ResultCount with sum as TotalCount,
        ResultDurationSeconds with sum as TotalDuration
    )
)/compute(
    TotalDuration div TotalCount as AvgDuration
)

Duração do teste filtrada por ramificação

Para exibir a duração do teste de testes de pipeline para uma ramificação específica, use as consultas a seguir. Para criar o relatório, execute as seguintes etapas extras juntamente com o que é especificado posteriormente neste artigo.

Expanda Branch para Branch.BranchName
Selecione a segmentação de dados de visualização do Power BI e adicione o campo Branch.BranchName ao campo da segmentação de dados
Selecione o nome da ramificação na segmentação de dados para a qual você precisa ver o resumo do resultado.

Para obter mais informações sobre como usar segmentações de dados, consulte Segmentações de dados no Power BI.

Consulta do Power BI
Consulta OData

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?"
      &"$apply=filter("
      &"Pipeline/PipelineName eq '{pipelineName}' "
      &"And Date/Date ge {startdate} "
      &"And Workflow eq 'Build'"
      &")/groupby("
      &"(TestSK, Test/TestName, Branch/BranchName),"
      &"aggregate("
      &"ResultCount with sum as TotalCount, "
      &"ResultDurationSeconds with sum as TotalDuration"
      &"))/compute("
      &"TotalDuration div TotalCount as AvgDuration"
      &")",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}' 
    And Date/Date ge {startdate} 
    And Workflow eq 'Build'
)/groupby(
    (TestSK, Test/TestName, Branch/BranchName),
    aggregate(
        ResultCount with sum as TotalCount,
        ResultDurationSeconds with sum as TotalDuration
    )
)/compute(
    TotalDuration div TotalCount as AvgDuration
)

Duração do teste filtrada pelo arquivo de teste

Para exibir a duração do teste de um pipeline para testes de propriedade de um proprietário de teste específico, use as consultas a seguir. Para criar o relatório, execute as seguintes etapas extras juntamente com o que é definido posteriormente neste artigo.

Expanda Test para Test.ContainerName
Selecione a segmentação de dados de visualização do Power BI e adicione o campo Test.ContainerName ao campo da segmentação de dados
Selecione o arquivo de teste na segmentação de dados para o qual você precisa ver o resumo do resultado.

Consulta do Power BI
Consulta OData

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?"
      &"$apply=filter("
      &"Pipeline/PipelineName eq '{pipelineName}' "
      &"And Date/Date ge {startdate} "
      &"And Workflow eq 'Build'"
      &")/groupby("
      &"(TestSK, Test/TestName, Test/ContainerName),"
      &"aggregate("
      &"ResultCount with sum as TotalCount, "
      &"ResultDurationSeconds with sum as TotalDuration"
      &"))/compute("
      &"TotalDuration div TotalCount as AvgDuration"
      &")",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}' 
    And Date/Date ge {startdate} 
    And Workflow eq 'Build'
)/groupby(
    (TestSK, Test/TestName, Test/ContainerName),
    aggregate(
        ResultCount with sum as TotalCount,
        ResultDurationSeconds with sum as TotalDuration
    )
)/compute(
    TotalDuration div TotalCount as AvgDuration
)

Duração do teste filtrada pelo proprietário do teste

Expanda Test para Test.TestOwner
Selecione a segmentação de dados de visualização do Power BI e adicione o campo Test.TestOwner ao campo da segmentação de dados
Selecione o proprietário do teste na segmentação de dados para a qual você precisa ver o resumo do resultado.

Consulta do Power BI
Consulta OData

let
   Source = OData.Feed (
      "https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?"
      &"$apply=filter("
      &"Pipeline/PipelineName eq '{pipelineName}' "
      &"And Date/Date ge {startdate} "
      &"And Workflow eq 'Build'"
      &")/groupby("
      &"(TestSK, Test/TestName, Test/TestOwner),"
      &"aggregate("
      &"ResultCount with sum as TotalCount, "
      &"ResultDurationSeconds with sum as TotalDuration"
      &"))/compute("
      &"TotalDuration div TotalCount as AvgDuration"
      &")",
      null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
   )
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?
$apply=filter(
    Pipeline/PipelineName eq '{pipelineName}' 
    And Date/Date ge {startdate} 
    And Workflow eq 'Build'
)/groupby(
    (TestSK, Test/TestName, Test/TestOwner),
    aggregate(
        ResultCount with sum as TotalCount,
        ResultDurationSeconds with sum as TotalDuration
    )
)/compute(
    TotalDuration div TotalCount as AvgDuration
)

Cadeias de caracteres de substituição e detalhamento de consulta

Substitua as seguintes cadeias de caracteres por seus valores. Não inclua parênteses com a {} 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.
{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 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() .

Pipeline/PipelineName eq '{pipelineName}'

O teste de retorno é executado para o pipeline nomeado.

And Date/Date ge {startdate}

O teste de retorno é executado na data especificada ou após ela.

and Workflow eq 'Build'

O teste de retorno é executado para um Build fluxo de trabalho.

)

Cláusula de fechamento filter() .

/groupby(

Cláusula inicial groupby() .

(TestSK, Test/TestName),

Agrupe pelo nome do teste.

aggregate(

Cláusula Start aggregate para somar diferentes resultados de execução de teste correspondentes aos critérios de filtro.

ResultCount with sum as TotalCount,

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

ResultDurationSeconds with sum as TotalDuration

Somar a duração total de todas as execuções como TotalDuration.

))

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

/compute(

Cláusula inicial compute() .

TotalDuration div TotalCount as AvgDuration

Para todos os testes, calcule a duração média dividindo a duração total pelo número total de corridas.

)

Cláusula de fechamento compute() .

(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 a coluna Teste no Power BI

Expanda a Test coluna para mostrar a entidade Test.TestNameexpandida. A expansão da coluna nivela o registro em campos específicos. Para saber como, consulte Transformar dados do Analytics para gerar relatórios do Power BI, Expandir colunas.

Alterar o tipo de dados da coluna

No Editor do Power Query, selecione a TotalCount coluna, selecione Tipo de Dados no menu Transformar e, em seguida, escolha Número Inteiro.
Selecione as TotalDuration colunas e AvgDuration , selecione Tipo de dados no menu Transformar e, em seguida, escolha Número decimal.

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.

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.

Criar o relatório Tabela

No Power BI, em Visualizações, escolha **Tabela e arraste e solte os campos na área Colunas.
Adicione os seguintes campos à seção Colunas na ordem listada.
- Test.TestName
- TotalCount
- AvgDuration
Selecione com o botão direito do AvgDuration mouse e escolha Média em vez de Soma.

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

Captura de tela do relatório Tabela de Duração do Teste de Amostra.

Partilhar via

Relatório da amostra da duração do ensaio

Pré-requisitos

Consultas de amostra

Duração do teste para o fluxo de trabalho de compilação

Duração do teste para o fluxo de trabalho Release

Duração do teste filtrada por ramificação

Duração do teste filtrada pelo arquivo de teste

Duração do teste filtrada pelo proprietário do teste

Cadeias de caracteres de substituição e detalhamento de consulta

Detalhamento da consulta

(Opcional) Renomear consulta

Expandir a coluna Teste no Power BI

Alterar o tipo de dados da coluna

Feche a consulta e aplique as alterações

Criar o relatório Tabela

Comentários

Recursos adicionais

Partilhar via

Relatório da amostra da duração do ensaio

Pré-requisitos

Consultas de amostra

Duração do teste para o fluxo de trabalho de compilação

Duração do teste para o fluxo de trabalho Release

Duração do teste filtrada por ramificação

Duração do teste filtrada pelo arquivo de teste

Duração do teste filtrada pelo proprietário do teste

Cadeias de caracteres de substituição e detalhamento de consulta

Detalhamento da consulta

(Opcional) Renomear consulta

Expandir a coluna Teste no Power BI

Alterar o tipo de dados da coluna

Feche a consulta e aplique as alterações

Criar o relatório Tabela

Artigos relacionados

Comentários

Recursos adicionais