Weergave van historische gegevens in Analytics

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

U geeft specifieke entiteitensets op om te rapporteren over historische gegevens of trendrapporten te maken. Het is belangrijk om te begrijpen hoe in Analytics historische gegevens worden vastgelegd om ervoor te zorgen dat u de interessante gegevens kunt bijhouden en rapporteren.

Entiteitssets die ondersteuning bieden voor historische rapportage

In de volgende tabel worden de entiteitensets beschreven die u kunt gebruiken om historische rapporten of trendrapporten te maken.

EntitySet	Beschrijving	Voorbeeldrapport
WorkItemBoardSnapshot	(Samengesteld) De status van elk werkitem op elke kalenderdatum, inclusief kanbanbordlocatie.	Voorbeeldrapport van cumulatief stroomdiagram (CFD)
WorkItemRevisions	Alle historische revisies van werkitems, inclusief de huidige revisie. Bevat geen verwijderde werkitems.	De geschiedenis van een specifiek werkitem retourneren
WorkItemSnapshot	(Samengesteld) De status van elk werkitem op elke kalenderdatum.	Voorbeeldrapport met fouttrends
ParallelPipelineJobsSnapshot	(Samengesteld) Ondersteunt inzicht in het gebruik van parallelle pijplijnen.
TaskAgentPoolSizeSnapshots	(Samengesteld) Ondersteunt inzicht in poolgrootte, pijplijntaken en gelijktijdigheid.	Historische grafiek voor agentpools
TaskAgentRequestSnapshots	(Samengesteld) Ondersteunt rapportage over taakagentaanvragen.
TestPointHistorySnapshot	(Samengesteld) Afzonderlijke uitvoeringsresultaten voor een specifieke test die is gekoppeld aan een TestRun.	Voorbeeldrapport voor handmatige testuitvoeringstrend
TestResultsDaily	Een dagelijkse momentopnameaggregatie van TestResult-uitvoeringen , gegroepeerd op Test.	Voorbeeldrapport van een testsamenvattingstrend

Een momentopname bevat een record van de waarden die elke dag voor het entiteitstype zijn gedefinieerd. De record wordt één keer per dag op hetzelfde tijdstip naar Analytics geschreven. U gebruikt momentopnamen wanneer u een trendrapport wilt genereren. Standaard worden alle momentopnametabellen gemodelleerd als feitentabellen voor dagelijkse momentopnamen. Als u een query uitvoert voor een tijdsbereik, krijgt u een waarde voor elke dag. Lange tijdsbereiken resulteren in een groot aantal records. Als u niet zo'n hoge precisie nodig hebt, kunt u wekelijkse of zelfs maandelijkse momentopnamen gebruiken.

Periodieke momentopname-feitentabellen

Analyse modelleert historische gegevens als een periodieke momentopname-feitentabel. De feitentabel bevat één rij die om middernacht is gemaakt voor elk werkitem of entiteitstype aan het einde van elke periode. De geschiedenis van een dagelijkse periode wordt bijvoorbeeld gemodelleerd als één rij om middernacht voor elke dag, terwijl een wekelijkse periode één rij is om middernacht van de laatste dag van de week. Als de week niet is voltooid, is de momentopnamewaarde voor de week gebaseerd op de huidige waarde.

De korrel van deze tabel is de punt, niet het afzonderlijke werkitem. Dit betekent dat één werkitem meerdere keren wordt weergegeven, één keer voor elke historische periode. Als u de geschiedenis van de afgelopen 30 dagen selecteert, wordt één werkitem 30 keer weergegeven in het gegevensmodel. Als het werkitem de afgelopen 30 dagen niet is gewijzigd, wordt de meest recente revisie van het werkitem elke dag gerepliceerd.

Wanneer u met de Power BI-gegevensconnector en historische gegevens werkt, raden we u aan het Date veld te gebruiken. Als de gegevensset historische gegevens bevat, maar alleen de huidige waarden nodig zijn, kan dit worden ingesteld door te filteren Is Current.

Als u bijvoorbeeld een tabel met werkitems en waarden voor de gekoppelde velden wilt weergeven, gebruikt Is Current u als filter dat is ingesteld op Waar. Als u in plaats daarvan een trend van werkitems wilt weergeven op basis van de status, neemt u de kolom Datum op de as van de visualisatie op.

Tip

Gebruik altijd de optie Datum wanneer u de kolom Datum gebruikt. Het veld Datum is niet bedoeld om standaardhiërarchieën in Power BI te ondersteunen.

Revisies van werkitems

Telkens wanneer u een werkitem bijwerkt, maakt het systeem een nieuwe revisie en registreert het deze actie in het System.RevisedDate veld, waardoor het handig is voor het opgeven van een geschiedenisfilter. De herziene datum wordt vertegenwoordigd door RevisedDate de eigenschappen (DateTime) en RevisedDateSK (Int32). Gebruik voor de beste prestaties de laatste datum-surrogaatsleutel. Het geeft de datum aan waarop een revisie is gemaakt of de datum is null voor actieve of onvolledige revisies.

Als u alle datums sinds de {startDate} inclusief wilt, voegt u het volgende filter toe aan uw query.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

U gebruikt de WorkItemRevisions entiteitsset om alle revisies voor een bepaald werkitem te laden. De query retourneert alle historische revisies van werkitems, inclusief de huidige revisie, voor de werkitems waarop u filtert. Het bevat geen verwijderde werkitems.

Tip

Als u een trendrapport voor het bijhouden van werk wilt maken, maakt of wijzigt u een standaardanalyseweergave en geeft u het gewenste tijdsbestek op het tabblad Geschiedenis op. Zie Een analyseweergave maken voor meer informatie.

Met zowel de analyseweergaven als de Burndown- en Burnup-widgets kunt u filters configureren die de gegevensset aanpassen aan uw behoeften. U past filters toe om de gegevens te bepalen voor specifieke teams, typen werkitems of achterstanden. Filters kunnen ook van toepassing zijn op specifieke eigenschappen of velden en de bijbehorende waarden. U kunt bijvoorbeeld filters toepassen op werkitems om alleen bugs te retourneren die zijn gedefinieerd voor het Fabrikam Voice-team en die zijn gelabeld met klant.

Hoe filters worden toegepast op historische gegevens

Filters worden toegepast op elke revisie van een werkitem. Stel dat we een werkitem hebben met de volgende revisies:

Rev #	Revisiedatum	Id	Titel	Staat	Gebiedspad	Tags
1	Jan-01	1001	Een fout	Nieuw
2	Jan-02	1001	Een fout	Nieuw	/Admiraals
3	10 januari	1001	Een fout	Actief	/Admiraals
4	12 januari	1001	Een fout	Actief	/Admiraals	Klant
5	Jan-20	1001	Een fout	Opgelost	/Admiraals	Klant
6 (huidig)	28 januari	1001	Een fout	Gesloten	/Admiraals	Klant

De meest recente revisie (#6) is de Huidige revisie van het werkitem. Als u in de analyseweergaven 'Alleen huidig' hebt geselecteerd op het tabblad Geschiedenis, krijgt u één rij met gegevens voor dit werkitem, de huidige rij.

Bij het rapporteren over de geschiedenis kunnen we mogelijk revisies 1 tot en met 6 ophalen voor rapportage.

Stel bij het maken van een analyseweergave of het configureren van de Burndown-widget de volgende twee filters in:

• Gebiedspad = /Admirals
• Tags bevat klant

Het toepassen van deze filters op de set revisies van werkitems levert de volgende overeenkomsten op:

Overeenkomen met?	Rev #	Revisiedatum	Id	Titel	Staat	Gebiedspad	Tags
	1	Jan-01	1001	Een fout	Nieuw
	2	Jan-02	1001	Een fout	Nieuw	/Admiraals
	3	10 januari	1001	Een fout	Actief	/Admiraals
	4	12 januari	1001	Een fout	Actief	/Admiraals	Klant
	5	Jan-20	1001	Een fout	Opgelost	/Admiraals	Klant
	6 (huidig)	28 januari	1001	Een fout	Gesloten	/Admiraals	Klant

Revisies 1, 2 en 3 komen niet overeen, omdat deze revisies niet overeenkomen met de filters. Het bovenstaande werkitem wordt pas in uw gegevensset of trendgrafiek weergegeven als revisie 4 of 12 januari.

Stel dat u wilt rapporteren over uw trend van actieve bugs, maakt u een filter van Status = Actief. Deze filters komen overeen met de volgende revisies:

Overeenkomen met?	Rev #	Wijzigingsdatum	Id	Titel	Staat	Gebiedspad	Tags
	1	Jan-01	1001	Een fout	Nieuw
	2	Jan-02	1001	Een fout	Nieuw	/Admiraals
	3	Jan-10	1001	Een fout	Actief	/Admiraals
	4	Jan-12	1001	Een fout	Actief	/Admiraals	Klant
	5	Jan-20	1001	Een fout	Opgelost	/Admiraals	Klant
	6 (huidig)	28 januari	1001	Een fout	Gesloten	/Admiraals	Klant

De filters komen alleen overeen met revisie 3 en 4 van het werkitem en bevatten alleen de revisies jan-10 en jan-12 in uw trenddiagram.

Wat betekent dit voor Burndown of Burnup?

Wanneer u een Burndown- of Burnup-widget configureert die filtert op een bepaalde tag (bijvoorbeeld 'Klant'), worden werkitems pas in uw burndown weergegeven op de datum waarop de tag is gedefinieerd voor het werkitem. Als de tag op enig moment uit het werkitem wordt verwijderd, komt het werkitem uit de burndown na de datum waarop de tag is verwijderd.

Sommigen gaan ervan uit dat als de huidige versie van een werkitem de tag heeft, dit vanaf het begin met terugwerkende kracht in de burndown wordt opgenomen. Als de huidige versie van het werkitem bijvoorbeeld de tag 'Klant' heeft, werd ervan uitgegaan dat het werkitem in de burndown zou worden opgenomen vanaf het moment dat het werkitem is gemaakt.

Het is niet hoe historisch filteren werkt. Als filters alleen zouden worden toegepast op basis van de huidige versie van een werkitem, werken trenddiagrammen niet. U kunt een item niet verwijderen uit uw burndown door een tag te verwijderen of door het gebiedspad in te stellen op het gebiedspad van een ander team.

Notitie

We overwegen om een operand 'was ooit' toe te voegen aan de filtercriteria in analyseweergaven en widgets zoals Burndown/Burnup. Met deze functie kunt u een filter maken zoals: 'Status was ooit actief'. Dit betekent dat een revisie van een werkitem zou voldoen aan de filtercriteria als een revisie van het werkitem ooit Status = Actief had. Als u denkt dat deze functie belangrijk is, kunt u erop stemmen op onze communitysite voor ontwikkelaars.

Historische gegevens en analyse onderbreken of uitschakelen

Als u Analytics onderbroken, blijven uw gegevens behouden, maar wordt het bijwerken van uw gegevens door faseringstaken gestopt. U kunt de service later hervatten, waarna uw gegevens worden bijgewerkt.

Als een beheerder Analytics uitschakelt, worden alle faseringstaken van Analytics uitgeschakeld en worden analysegegevens die zijn opgeslagen in de Analytics-tabellen verwijderd. Alle analysegegevens die historische trends vastleggen, gaan verloren. Er worden geen andere gegevens verwijderd die in uw verzameling zijn opgeslagen. U kunt deze actie niet ongedaan maken. Zodra historische gegevens en trending gegevens zijn verwijderd, kunt u deze niet meer herstellen. Als u Analytics opnieuw inschakelt, worden de historische gegevens niet hersteld.

Als Analytics is uitgeschakeld of verwijderd, worden de volgende acties uitgevoerd:

• Er worden geen faseringstaken uitgevoerd en de Analytics-tabellen bevatten geen bijgewerkte informatie.
• Tabelgegevens worden verwijderd en als Analytics opnieuw wordt ingeschakeld, worden alle gegevens opnieuw ingevuld.

Zie De Analytics-service installeren of inschakelen voor meer informatie.

Samenvatting

Bij het rapporteren over historische gegevens worden alle filters toegepast op de versie van het werkitem vanaf het historische tijdstip. Werkitems worden weergegeven in uw trend wanneer ze voldoen aan de filtercriteria. Ze verdwijnen uit uw trend wanneer ze niet meer voldoen aan de filtercriteria.

Verwante artikelen:

• OData Analytics-queryrichtlijnen
• Naslaginformatie over entiteiten en eigenschappen voor Azure Boards
• Gegevensmodel voor analyse