Compartilhar via

Relatório de tendências de bugs: exemplo

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

Os relatórios de tendência de bugs ajudam você a 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 tela do relatório do gráfico de linhas de tendências de defeitos.

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 de Power BI.

Categoria Requirements
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 Analytics e criar exibições. Para obter mais informações sobre outros pré-requisitos relacionados à ativação de serviços e recursos e atividades gerais de rastreamento de dados, consulte Permissões e pré-requisitos para acessar o Analytics.

Consultas de exemplo

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

Observação

Para localizar as propriedades disponíveis para filtragem ou relatório, consulte a referência Metadata para Azure Boards. Você pode filtrar consultas ou retornar propriedades usando qualquer valor Property definido em um EntityType ou qualquer valor NavigationPropertyBinding Path listado para um EntitySet. Cada EntitySet mapeia para um EntityType, que documenta o tipo de dados de cada propriedade.

Tendências de bugs filtradas por Caminho de Área

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

Copie e cole a consulta Power BI a seguir diretamente na janela Get Data>Blank Query. 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 cadeias de caracteres a seguir por seus valores. Não inclua as chaves {} na 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 omita totalmente "/{project}" para uma consulta entre projetos
  • {areapath} - Seu caminho de área. Formato de exemplo: 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 01 de abril de 2022. 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 instrução de filtro.

WorkItemType eq 'Bug'

Bugs de retorno.

and State ne 'Closed'

Omita bugs nos estados Fechados.

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

Retornar itens de trabalho em um caminho de área específico que você definir em '{areapath}'. Para filtrar por nome de equipe, use a instrução filter Teams/any(x:x/TeamName eq '{teamname}').

and DateValue ge {startdate}

Iniciar tendência na data especificada ou após. Exemplo: 2021-04-01Z representa 2021-Abril-01.

)

Fechar cláusula filter().

/groupby(

Iniciar cláusula groupby().

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

Agrupar por DateValue, usado para tendências e quaisquer outros campos sobre os quais você deseja gerar relatórios.

aggregate($count as Count)

Agregue contando bugs que correspondam aos critérios em cada data.

)

Fechar cláusula groupby().

Tendência de bug filtrada por equipes

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

Copie e cole a consulta Power BI a seguir diretamente na janela Get Data>Blank Query. 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 toda sexta-feira

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

Copie e cole a consulta Power BI a seguir diretamente na janela Get Data>Blank Query. 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 falhas com um instantâneo no início de cada mês

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

Copie e cole a consulta Power BI a seguir diretamente na janela Get Data>Blank Query. 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. Insira um novo nome no painel Configurações de Consulta .

Screenshot das opções de menu de consulta do Power BI, opção para renomear a consulta.

Expandir colunas em Power BI

Expanda a coluna Area/AreaPath e a coluna Iteration/IterationPath. A expansão das colunas nivela o registro em campos específicos. Para saber como, consulte Transform Analytics para gerar relatórios Power BI.

(Opcional) Renomear campos de coluna

Você pode renomear campos de coluna para serem mais amigáveis. Para saber como, consulte Renomear campos de coluna.

Feche a consulta e aplique suas alterações

Ao concluir todas as transformações de dados, selecione Fechar &Aplicar no menu Página Inicial . Essa ação salva a consulta e retorna você para a guia Report no Power BI.

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

Criar o relatório de gráfico de linhas

  1. Em Power BI, em Visualizations, selecione o relatório Line chart.

    Captura de tela de Power BI Visualizações e Seleções de Campos para relatório de tendências de bugs.

  2. Adicione DateValue ao eixo X. Clique com o botão direito do mouse DateValue e selecione DateValue em vez de Date Hierarchy.

  3. Adicione Count ao eixo Y. Clique com o botão direito do mouse Count e verifique se Sum está selecionado.

  4. Adicionar State à Legenda.

O relatório de exemplo é exibido.

Captura de tela do relatório do gráfico de linhas de tendências de bugs de amostra.

Modificar os visuais do formato de relatório

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

    Captura de tela das seleções de formato 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.

  • Last updated on