Partilhar via


Relatório de exemplo de tendências de erros

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

Os relatórios de tendências de bugs são úteis para ver o quão bem uma equipe está fechando bugs ativos. Este artigo mostra como exibir o número de bugs em um determinado estado durante um período de tempo. A imagem a seguir mostra um exemplo de um relatório de tendências de bugs.

Captura de ecrã do relatório de tendências de bugs em gráfico de linhas.

Nota

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

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.

Exemplos de consultas

As consultas a seguir retornam dados do WorkItemSnapshot conjunto de entidades para dar suporte à geração de relatórios de tendências.

Nota

Para determinar as propriedades disponíveis para fins de filtro ou relatório, consulte Referência de metadados para painéis do Azure. Você pode filtrar as suas consultas ou retornar propriedades usando qualquer um dos Property valores sob 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, consulte os metadados fornecidos para o EntityType correspondente.

Tendência de erros filtrada por caminho da área

As consultas a seguir filtram bugs por área, caminho e data de início.

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/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate}  "
            &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
            &") "
    ,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 parênteses angulares {} 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 equipe, ou omitir "/{project}" completamente, para uma consulta entre projetos
  • {areapath} - Caminho da sua área. Exemplo de formato: Project\Level1\Level2
  • {startdate} - Inicie seu relatório para itens concluídos em ou após uma determinada data com o formato: YYYY-MM-DDZ. Por exemplo: 2022-04-01Z representa 2022-abril-01. Não coloque entre aspas.

Detalhamento da consulta

A tabela a seguir descreve cada parte da consulta.

Parte da consulta

Descrição

$apply=filter(

Início da cláusula de declaração de filtro.

WorkItemType eq 'Bug'

Erros de Retorno.

and State ne 'Closed'

Omitir bugs num estado fechado.

and startswith(Area/AreaPath,'{areapath}')

Retorne itens de trabalho sob um Caminho de Área específico que você especificar em . Para filtrar por nome da equipa, use a declaração de filtro Teams/any(x:x/TeamName eq '{teamname})'.

and DateValue ge {startdate}

Tendência de início na data especificada ou após ela. Exemplo: 2021-04-01Z representa 2021-Abril-01.

)

Fechar cláusula filter().

/groupby(

Cláusula inicial groupby() .

(DateValue, State, WorkItemType, Priority, Severity, Area/AreaPath, Iteration/IterationPath),

Agrupar por DateValue, usado para tendências e quaisquer outros campos sobre os quais você deseja relatar.

aggregate($count as Count)

Agregar, contabilizando os erros que respeitam os critérios em cada data.

)

Fechar cláusula groupby().

Tendência de bugs filtrada pelo Teams

Você pode consultar tendências de bugs pelo nome da equipe em vez de Caminho da área.

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/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}')"
            &"and DateValue ge {startdate}  "
            &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
            &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendência de bug com um instantâneo todas as sextas-feiras

O uso de um instantâneo semanal reduz a quantidade de dados extraídos para o Power BI e aumenta o desempenho da consulta.

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/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate} "
            &"and Date/DayName eq 'Friday'  "
        &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendência de bugs com uma captura instantânea no primeiro de cada mês

O uso de um instantâneo mensal reduz a quantidade de dados extraídos para o Power BI e aumenta o desempenho da consulta.

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/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate} "
            &"and Date/DayOfMonth eq 1  "
        &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
        &") "
    ,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. 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 colunas no Power BI

Expanda a coluna Area/AreaPath e a coluna Iteration/IterationPath. Expandir as colunas nivela o registro em campos específicos. Para saber como, consulte Transformar dados do Google Analytics para gerar relatórios do Power BI.

(Opcional) Renomear campos

Depois de expandir as colunas, convém renomear um ou mais campos. Por exemplo, você pode renomear a coluna AreaPath para Area Path. Para saber como, consulte Renomear colunas de campos.

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

  1. No Power BI, escolha o Gráfico de Linhas sob Visualizações.

    Captura de ecrã das Visualizações e Seleções de Campos do Power BI para o relatório de tendências de bugs.

  2. Adicione DateValue" ao eixo X, clique direito DateValue e selecione Date Hierarchy em vez de .

  3. Adicione Count ao eixo Y, clique com o botão direito Count e verifique se Soma está selecionada.

  4. Adicionar State à legenda.

O relatório de exemplo é exibido.

Captura de ecrã do relatório de gráfico de linhas de tendências de exemplos de bugs.

Modificar elementos visuais do formato do relatório

  • Para modificar os elementos de formato do relatório, escolha o ícone Formatar o visual (pincel) e modifique uma ou mais configurações disponíveis. Por exemplo, você pode modificar as cores de linha usadas no gráfico de tendência.

    Captura de ecrã das opções de formatação visual no Power BI para o relatório de tendências de bugs.

Para obter mais informações, consulte Introdução ao painel de formatação.