Representação de dados históricos na Análise

Serviços do Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Especifique conjuntos de entidades específicos para comunicar dados históricos ou criar relatórios de tendência. Compreender como a Análise regista dados históricos é importante para garantir que pode controlar e comunicar os dados de interesse.

Conjuntos de entidades que suportam relatórios históricos

A tabela seguinte descreve os conjuntos de entidades que pode utilizar para criar relatórios históricos ou de tendências.

EntitySet	Descrição	Relatório de exemplo
WorkItemBoardSnapshot	(Composto) O estado de cada item de trabalho em cada data do calendário, incluindo a localização do quadro Kanban.	Relatório de exemplo do Diagrama de Fluxo Cumulativo (CFD)
WorkItemRevisions	Todas as revisões históricas de itens de trabalho, incluindo a revisão atual. Não inclui itens de trabalho eliminados.	Devolver o histórico de um item de trabalho específico
WorkItemSnapshot	(Composto) O estado de cada item de trabalho em cada data do calendário.	Relatório de exemplo de tendências de erros
ParallelPipelineJobsSnapshot	(Composto) Suporta a compreensão do consumo paralelo de pipelines.
TaskAgentPoolSizeSnapshots	(Composto) Suporta a compreensão do tamanho do conjunto, das tarefas de pipeline e da simultaneidade.	Gráfico histórico de conjuntos de agentes
TaskAgentRequestSnapshots	(Composto) Suporta relatórios sobre pedidos do agente de tarefas.
TestPointHistorySnapshot	(Composto) Resultados de execução individuais para um Teste específico associado a uma TestRun.	Relatório de exemplo de tendência de execução de testes manual
TestResultsDaily	Uma agregação diária de instantâneos de execuções testResult , agrupadas por Teste.	Relatório de exemplo de tendência de resumo de teste

Um instantâneo fornece um registo dos valores definidos para o tipo de entidade todos os dias. O registo é escrito no Analytics uma vez por dia ao mesmo tempo todos os dias. Pode utilizar instantâneos quando pretender gerar um relatório de tendência. Por predefinição, todas as tabelas de instantâneos são modeladas como tabelas de factos de instantâneos diários. Se consultar um intervalo de tempo, obterá um valor para cada dia. Intervalos de tempo longos resultam num grande número de registos. Se não precisar de uma precisão tão elevada, pode utilizar instantâneos semanais ou mesmo mensais.

Tabelas de factos de instantâneos periódicos

A análise modela os dados históricos como uma tabela de factos de instantâneo periódico. A tabela de factos contém uma linha criada à meia-noite para cada item de trabalho ou tipo de entidade no final de cada período. Por exemplo, o histórico num período diário é modelado como uma linha à meia-noite para cada dia, enquanto um período semanal seria uma linha à meia-noite do último dia da semana. Se a semana ainda não tiver sido concluída, o valor do instantâneo da semana baseia-se no valor atual.

O grão desta tabela é o ponto final, não o item de trabalho individual. Significa que um único Item de Trabalho será apresentado várias vezes, uma vez para cada período histórico. Selecionar os últimos 30 dias do histórico resultará num único item de trabalho que aparece 30 vezes no modelo de dados. Se o item de trabalho não tiver sido alterado nos últimos 30 dias, a revisão mais recente do item de trabalho é replicada em cada dia.

Ao trabalhar com o Conector de Dados do Power BI e os dados históricos, recomendamos a utilização do Date campo. Se o conjunto de dados contiver dados históricos, mas apenas os valores atuais forem necessários, pode ser configurado ao filtrar Is Current.

Por exemplo, se quiser mostrar uma tabela de itens de trabalho e valores para os campos associados, utilizaria Is Current como um filtro definido como Verdadeiro. Em vez disso, se quisesse mostrar uma tendência de itens de trabalho com base no estado, incluiria a coluna Data no Eixo da visualização.

Dica

Utilize sempre a opção Data ao utilizar a coluna Data. O campo Data não se destina a suportar hierarquias predefinidas no Power BI.

Revisões de itens de trabalho

Sempre que atualizar um item de trabalho, o sistema cria uma nova revisão e regista esta ação no campo, o System.RevisedDate que a torna útil para especificar um filtro de histórico. A data revista é representada pelas RevisedDate propriedades (DateTime) e RevisedDateSK (Int32). Para obter o melhor desempenho, utilize a última chave de substituição de data. Representa a data em que uma revisão foi criada ou tem um valor nulo para revisões ativas ou incompletas.

Se quiser todas as datas desde o {startDate} inclusive, adicione o seguinte filtro à consulta.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

Utilize o WorkItemRevisions conjunto de entidades para carregar todas as revisões de um determinado item de trabalho. A consulta devolve todas as revisões históricas de itens de trabalho, incluindo a revisão atual, para os itens de trabalho que filtrar. Não inclui itens de trabalho eliminados.

Dica

Para criar um relatório de tendência de controlo de trabalho, crie ou modifique uma vista de Análise predefinida e especifique o período de tempo de interesse no separador Histórico . Para saber mais, veja Criar uma vista de Análise.

Tanto as vistas de Análise como os widgets Burndown e Burnup permitem-lhe configurar filtros que definem o conjunto de dados de acordo com as suas necessidades. Aplica filtros para definir o âmbito dos dados para equipas específicas, tipos de itens de trabalho ou registos de tarefas pendentes. Os filtros também podem aplicar-se a propriedades ou campos específicos e aos respetivos valores correspondentes. Por exemplo, pode aplicar filtros em itens de trabalho para devolver apenas erros definidos para a equipa de Voz da Fabrikam e que estão etiquetados com o Cliente.

Como os filtros são aplicados a dados históricos

Os filtros são aplicados a cada revisão de um item de trabalho. Por exemplo, digamos que temos um item de trabalho que tem as seguintes revisões:

Rev #	Data de Revisão	ID	Título	Estado	Caminho da Área	Etiquetas
1	Jan-01	1001	Um erro	Novo
2	Jan-02	1001	Um erro	Novo	/Almirantes
3	Jan-10	1001	Um erro	Ativo	/Almirantes
4	12 de janeiro	1001	Um erro	Ativo	/Almirantes	Cliente
5	20 de janeiro	1001	Um erro	Resolvido	/Almirantes	Cliente
6 (Atual)	28 de janeiro	1001	Um erro	Fechado	/Almirantes	Cliente

A revisão mais recente (#6) é a Revisão atual do item de trabalho. Nas vistas de Análise, se selecionasse "Apenas atual" no separador Histórico, obteria uma linha de dados para este item de trabalho, a linha atual.

Ao comunicar o histórico, podemos potencialmente solicitar revisões 1 a 6 para relatórios.

Digamos que, ao criar uma vista de Análise ou ao configurar o widget Burndown, defina estes dois filtros:

• Caminho da Área = /Almirantes
• As etiquetas contêm o Cliente

Aplicar estes filtros ao conjunto de revisões de itens de trabalho gera as seguintes correspondências:

Corresponde?	Rev #	Data de Revisão	ID	Título	Estado	Caminho da Área	Etiquetas
	1	Jan-01	1001	Um erro	Novo
	2	Jan-02	1001	Um erro	Novo	/Almirantes
	3	Jan-10	1001	Um erro	Ativo	/Almirantes
	4	12 de janeiro	1001	Um erro	Ativo	/Almirantes	Cliente
	5	20 de janeiro	1001	Um erro	Resolvido	/Almirantes	Cliente
	6 (Atual)	28 de janeiro	1001	Um erro	Fechado	/Almirantes	Cliente

As revisões 1, 2 e 3 não correspondem, porque essas revisões não correspondem aos filtros. O item de trabalho acima não apareceria no conjunto de dados ou no gráfico de tendências até à revisão 4 ou 12 de janeiro.

Suponhamos que queria comunicar a sua tendência de Erros ativos, que iria criar um filtro de Estado = Ativo. Esses filtros corresponderiam às seguintes revisões:

Corresponde?	Rev #	Data de Alteração	ID	Título	Estado	Caminho da Área	Etiquetas
	1	Jan-01	1001	Um erro	Novo
	2	Jan-02	1001	Um erro	Novo	/Almirantes
	3	Jan-10	1001	Um erro	Ativo	/Almirantes
	4	12 de janeiro	1001	Um erro	Ativo	/Almirantes	Cliente
	5	20 de janeiro	1001	Um erro	Resolvido	/Almirantes	Cliente
	6 (Atual)	28 de janeiro	1001	Um erro	Fechado	/Almirantes	Cliente

Os filtros só corresponderiam à revisão 3 e 4 do item de trabalho e só incluiriam as revisões jan-10 e jan-12 no seu gráfico de tendências.

O que significa isto para Burndown ou Burnup?

Quando configura um widget Burndown ou Burnup que filtra uma determinada Etiqueta (por exemplo, "Cliente"), os itens de trabalho não serão apresentados na sua evolução até à data em que a Etiqueta é definida para o item de trabalho. Se, em algum momento, a Etiqueta for removida do item de trabalho, o item de trabalho é da evolução após a data em que a Etiqueta foi removida.

Alguns assumiram que, se a versão atual de um item de trabalho tiver a Etiqueta, esta será incluída no burndown retroativamente desde o início. Por exemplo, se a versão atual do item de trabalho tiver a etiqueta "Cliente", assumiu-se que o item de trabalho seria incluído na evolução a partir do ponto em que o item de trabalho foi criado.

Não é assim que funciona a filtragem histórica. Se os filtros fossem aplicados apenas com base na versão atual de um item de trabalho, os gráficos de tendência não funcionariam. Não pode remover um item da sua evolução ao remover uma Etiqueta ou ao definir o Caminho da Área para o caminho de área de outra equipa.

Nota

Estamos a considerar adicionar um operando "alguma vez" aos critérios de filtro nas vistas de Análise e widgets, como Burndown/Burnup. Esta funcionalidade permitir-lhe-ia criar um filtro como: "State Was Ever Active". Isto significaria que uma revisão do item de trabalho corresponderia aos critérios de filtro se alguma revisão do item de trabalho tivesse Estado = Ativo. Se acredita que esta funcionalidade é importante, pode votar na mesma no nosso site da Comunidade de Programadores.

Dados históricos e colocar em pausa ou desativar a Análise

Colocar a Análise em pausa preserva os seus dados, mas impede que as tarefas de teste atualizem os seus dados. Pode retomar o serviço mais tarde e os seus dados são atualizados.

Se um administrador desativar o Analytics, todas as tarefas de teste do Analytics serão desativadas e os dados de Análise armazenados nas tabelas de Análise serão eliminados. Todos os dados do Analytics que capturam tendências históricas são perdidos. Não elimina quaisquer outros dados armazenados na sua coleção. Não pode anular esta ação. Assim que os dados históricos e os dados populares forem eliminados, não poderá restaurá-lo. A reativação do Analytics não restaura os dados históricos.

Com o Analytics desativado ou removido, ocorrem as seguintes ações:

• Não são executadas tarefas de teste e as tabelas do Analytics não terão informações atualizadas.
• Os dados da tabela são eliminados e, se a Análise for reativada, todos os dados serão repovoados do zero.

Para saber mais, veja Instalar ou ativar o serviço Analytics.

Resumo

Para reformular, ao reportar dados históricos, todos os filtros são aplicados à versão do item de trabalho a partir do ponto histórico no tempo. Os itens de trabalho aparecerão na sua tendência quando cumprirem os critérios de filtro. Desaparecerão da sua tendência quando já não cumprirem os critérios de filtro.

Artigos relacionados

• Diretrizes de consulta do OData Analytics
• Referência de entidades e propriedades dos Quadros do Azure
• Modelo de dados para Análise