Historische gegevensweergave in Analytics

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

U geeft specifieke entiteitssets op om te rapporteren over historische gegevens of trendrapporten te maken. Inzicht in hoe historische gegevens in Analytics worden vastgelegd, is belangrijk om ervoor te zorgen dat u de interessegegevens kunt bijhouden en rapporteren.

Entiteitssets die historische rapportage ondersteunen

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

EntitySet	Beschrijving	Voorbeeldrapport
WorkItemBoardSnapshot	(Samengesteld) De status van elk werkitem op elke kalenderdatum, inclusief bordlocatie.	Voorbeeldrapport cumulatief stroomdiagram (CFD)
WorkItemRevisions	Alle revisies van historische 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 bugtrends
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 voorbeeld van samenvattingstrend testen

Een momentopname bevat een record van de waarden die elke dag zijn gedefinieerd voor het entiteitstype. De record wordt één keer per dag op hetzelfde tijdstip per dag 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 deze een waarde voor elke dag. Lange tijdsbereiken resulteren in een groot aantal records. Als u deze hoge precisie niet nodig hebt, kunt u wekelijkse of zelfs maandelijkse momentopnamen gebruiken.

Periodieke feitentabellen voor momentopnamen

Analysemodellen historische gegevens als een periodieke feitentabel voor momentopnamen. 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.

Het korreltje 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 laatste 30 dagen geschiedenis 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 op 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 wilt weergeven voor de gekoppelde velden, 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 ter ondersteuning van standaardhiërarchieën in Power BI.

Revisies van werkitems

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

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

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

U gebruikt de WorkItemRevisions entiteit die is ingesteld om alle revisies voor een bepaald werkitem te laden. De query retourneert alle revisies van historische 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 interessekader op het tabblad Geschiedenis op. Zie Een analyseweergave maken voor meer informatie.

Met zowel analyseweergaven als burndown - en Burnup-widgets kunt u filters configureren die de gegevensset aan uw behoeften aanpassen. U past filters toe om de gegevens te bepalen op 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	Provincie	Pad naar gebied	Tags
1	Jan-01	1001	Een bug	Nieuw
2	Jan-02	1001	Een bug	Nieuw	/Admiraals
3	10 januari	1001	Een bug	Actief	/Admiraals
4	12 januari	1001	Een bug	Actief	/Admiraals	Customer
5	Jan-20	1001	Een bug	Opgelost	/Admiraals	Customer
6 (huidig)	Jan-28	1001	Een bug	Gesloten	/Admiraals	Customer

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

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

Stel dat u bij het maken van een analyseweergave of het configureren van de Burndown-widget deze twee filters instelt:

• Gebiedspad = /Admiraals
• Tags bevatten klant

Als u deze filters toepast op de set revisies van werkitems, levert dit de volgende overeenkomsten op:

Lucifer?	Rev #	Revisiedatum	Id	Titel	Provincie	Pad naar gebied	Tags
	1	Jan-01	1001	Een bug	Nieuw
	2	Jan-02	1001	Een bug	Nieuw	/Admiraals
	3	10 januari	1001	Een bug	Actief	/Admiraals
	4	12 januari	1001	Een bug	Actief	/Admiraals	Customer
	5	Jan-20	1001	Een bug	Opgelost	/Admiraals	Customer
	6 (huidig)	Jan-28	1001	Een bug	Gesloten	/Admiraals	Customer

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

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

Lucifer?	Rev #	Gewijzigde datum	Id	Titel	Provincie	Pad naar gebied	Tags
	1	Jan-01	1001	Een bug	Nieuw
	2	Jan-02	1001	Een bug	Nieuw	/Admiraals
	3	10 januari	1001	Een bug	Actief	/Admiraals
	4	12 januari	1001	Een bug	Actief	/Admiraals	Customer
	5	Jan-20	1001	Een bug	Opgelost	/Admiraals	Customer
	6 (huidig)	Jan-28	1001	Een bug	Gesloten	/Admiraals	Customer

De filters komen alleen overeen met revisie 3 en 4 van het werkitem en bevatten alleen de revisies van 10 januari en 12 in het 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 als 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 hebben ervan uitgegaan dat als de huidige versie van een werkitem de Tag heeft, het vanaf het begin met terugwerkende kracht wordt opgenomen in de burndown. Als de huidige versie van het werkitem bijvoorbeeld de tag Klant heeft, wordt ervan uitgegaan dat het werkitem wordt opgenomen in de burndown vanaf het punt dat het werkitem is gemaakt.

Het is niet hoe historisch filteren werkt. Als filters alleen werden toegepast op basis van de huidige versie van een werkitem, zouden trendgrafieken niet werken. 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 een operand 'was ooit' toe te voegen aan de filtercriteria in analytics-weergaven en widgets zoals Burndown/Burnup. Met deze functie kunt u een filter maken als: 'Status was ooit actief'. Dit zou betekenen dat een revisie van een werkitem overeenkomt met de filtercriteria als een revisie van het werkitem ooit State = Actief had. Als u denkt dat deze functie belangrijk is, kunt u ervoor stemmen op onze communitysite voor ontwikkelaars.

Historische gegevens en het onderbreken of uitschakelen van Analytics

Als u analytics onderhoudt, blijven uw gegevens behouden, maar worden uw gegevens niet meer bijgewerkt door faseringstaken. U kunt de service later hervatten en uw gegevens worden vervolgens bijgewerkt.

Als een beheerder Analytics uitschakelt, worden alle faseringstaken van Analytics uitgeschakeld en worden analysegegevens verwijderd die zijn opgeslagen in de Analytics-tabellen. Alle analysegegevens die historische trends vastleggen, gaan verloren. Er worden geen andere gegevens verwijderd die zijn opgeslagen in uw verzameling. U kunt deze actie niet ongedaan maken. Zodra historische gegevens en trendingsgegevens 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 hebben geen bijgewerkte informatie.
• Tabelgegevens worden verwijderd en als Analytics opnieuw is ingeschakeld, worden alle gegevens helemaal opnieuw ingevuld.

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

Samenvatting

Als u wilt bij het rapporteren van 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