Consultar dados de tendência com agregação OData

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

O sistema de análise armazena instantâneos diários de cada item de trabalho em dois conjuntos de entidades: WorkItemSnapshot (rastreia valores de campo como estado e esforço) e WorkItemBoardSnapshot (rastreia posições de coluna de quadro). Como cada entidade contém uma linha por item de trabalho por dia, essas tabelas crescem rapidamente. Use extensões de agregação OData para filtrar por data e agrupar resultados antes de retornar os dados para a ferramenta de cliente.

Este artigo mostra como criar consultas de tendência por intervalo de datas e por iteração, usando $apply com filter, groupbye aggregate.

https://{servername}:{port}/tfs/{OrganizationName}/{ProjectName}/_odata/{version}/

Pré-requisitos

Consultar dados de tendência por intervalo de datas

Ao consultar tabelas de instantâneo, atenda a dois requisitos:

1. Filtrar por data — cada tabela contém uma linha por item de trabalho por dia, portanto, uma consulta não filtrada retorna um conjunto de resultados muito grande.
2. Agrupar por data – se você omitir o agrupamento de datas, a resposta incluirá um aviso.

A consulta a seguir retorna uma contagem diária de bugs por estado para março de 2016:

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItemSnapshot?
  $apply=
    filter(DateValue ge 2016-03-01Z and DateValue le 2016-03-31Z and WorkItemType eq 'Bug')/
    groupby((DateValue, State), aggregate($count as Count))
  &$orderby=DateValue

Retorna:

{
  "value": [
    { "DateValue": "2016-03-01T00:00:00-08:00", "State": "Active", "Count": 2666 },
    { "DateValue": "2016-03-01T00:00:00-08:00", "State": "Closed", "Count": 51408 }
  ]
}

Essa consulta retorna no máximo 31 dias multiplicado pelo número de estados de bug (Ativo, Resolvido, Fechado) – máximo de 93 linhas, independentemente de quantos itens de trabalho existem.

Consultar dados de tendência por iteração

Em vez de datas de codificação rígida, filtre por iteração e referencie suas datas de início e término para que o intervalo de datas seja ajustado automaticamente. A Iteration/EndDate eq null verificação manipula iterações que ainda não têm uma data de término.

https://analytics.dev.azure.com/{OrganizationName}/{ProjectName}/_odata/{version}/WorkItemSnapshot?
  $apply=
    filter(WorkItemType eq 'Bug')/
    filter(Iteration/IterationName eq 'Sprint 99')/
    filter(DateValue ge Iteration/StartDate and (Iteration/EndDate eq null or DateValue le Iteration/EndDate))/
    groupby((DateValue, State), aggregate($count as Count))
  &$orderby=DateValue

Retorna:

{
  "value": [
    { "DateValue": "2016-04-04T00:00:00-07:00", "State": "Active", "Count": 320 },
    { "DateValue": "2016-04-04T00:00:00-07:00", "State": "Closed", "Count": 38 }
  ]
}

Próxima etapa

Conteúdo relacionado

• Agregar dados de acompanhamento de trabalho usando o Analytics
• Definir consultas básicas usando o OData Analytics
• Construir consultas OData para Análise
• Diretrizes de consulta do OData Analytics
• Extensão OData para Agregação de Dados Versão 4.0