Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
È possibile specificare set di entità specifici per creare report sui dati cronologici o creare report di tendenza. Comprendere in che modo Analytics registra i dati cronologici è importante per assicurarsi di poter tenere traccia e segnalare i dati di interesse.
Set di entità che supportano la creazione di report cronologici
Nella tabella seguente vengono descritti i set di entità che è possibile usare per creare report cronologici o di tendenza.
EntitySet |
Descrizione | Report di esempio |
|---|---|---|
| WorkItemBoardSnapshot | (Composito) Stato di ogni elemento di lavoro in ogni data del calendario, inclusa la posizione della lavagna. | Esempio di report del diagramma di flusso cumulativo (CFD) |
| RevisioniElementoDiLavoro | Tutte le revisioni degli elementi di lavoro cronologici, inclusa la revisione corrente. Non include elementi di lavoro eliminati. | Restituire la cronologia di un elemento di lavoro specifico |
| WorkItemSnapshot | (Composito) Stato di ogni elemento di lavoro in ogni data del calendario. | Report di esempio sulle tendenze dei bug |
| ParallelPipelineJobsSnapshot | (Composito) Supporta la comprensione del consumo di flussi paralleli. | |
| TaskAgentPoolSizeSnapshots | (Composito) Supporta la comprensione delle dimensioni del pool, dei processi della pipeline e della concorrenza. | Grafico cronologico per pool di agenti |
| TaskAgentRequestSnapshots | (Composito) Consente la creazione di report sulle richieste dell'agente di attività. | |
| TestPointHistorySnapshot | (Composito) Risultati dell'esecuzione singola per un test specifico associato a un TestRun. | Esempio di rapporto sulla tendenza dell'esecuzione dei test manuali |
| TestResultsDaily | Un'istantanea quotidiana aggregata delle esecuzioni di TestResult, raggruppate per tipo di test. | Rapporto di esempio sui trend dei riassunti dei test |
Uno snapshot fornisce un record dei valori definiti per il tipo di entità ogni giorno. Il record viene scritto in Analytics una volta al giorno alla stessa ora ogni giorno. Gli snapshot vengono usati quando si desidera generare un report di tendenza. Per impostazione predefinita, tutte le tabelle istantanee vengono modellate come tabelle di fatti istantanee giornaliere. Se si esegue una query per un intervallo di tempo, si otterrà un valore per ogni giorno. Gli intervalli di tempo lunghi comportano un numero elevato di record. Se non è necessaria una precisione così elevata, è possibile usare snapshot settimanali o persino mensili.
Tabelle dei fatti di istantanee periodiche
Gli analytics modellano i dati storici come una tabella di fatti snapshot periodica. La tabella dei fatti contiene una riga creata a mezzanotte per ogni elemento di lavoro o tipo di entità alla fine di ogni periodo. Ad esempio, la cronologia in un periodo giornaliero viene modellata come una riga a mezzanotte per ogni giorno, mentre un periodo settimanale sarà una riga a mezzanotte dell'ultimo giorno della settimana. Se la settimana non è stata completata, il valore dello snapshot per la settimana è basato sul valore corrente.
La granularità di questa tabella è il periodo, non il singolo elemento di lavoro. Significa che un singolo elemento di lavoro verrà visualizzato più volte, una volta per ogni periodo cronologico. La selezione degli ultimi 30 giorni di cronologia comporterà la visualizzazione di un singolo elemento di lavoro 30 volte nel modello di dati. Se l'elemento di lavoro non è stato modificato negli ultimi 30 giorni, la revisione più recente dell'elemento di lavoro viene replicata ogni giorno.
Quando si usano il connettore dati di Power BI e i dati cronologici, è consigliabile usare il Date campo .
Se il set di dati contiene dati cronologici, ma sono necessari solo i valori correnti, questa operazione può essere configurata filtrando Is Current.
Ad esempio, se si desidera visualizzare una tabella di elementi di lavoro e valori per i campi associati, usare Is Current come filtro impostato su True. Se invece si desidera visualizzare una tendenza degli elementi di lavoro in base allo stato, è necessario includere la colonna Data sull'asse della visualizzazione.
Suggerimento
Usare sempre l'opzione Date quando si usa la colonna Date. Il campo Data non è progettato per supportare le gerarchie predefinite in Power BI.
Revisioni degli elementi di lavoro
Ogni volta che si aggiorna un elemento di lavoro, il sistema crea una nuova revisione e registra questa azione nel System.RevisedDate campo, che rende utile specificare un filtro di cronologia. La data modificata è rappresentata dalle RevisedDate proprietà (DateTime) e RevisedDateSK (Int32). Per ottenere prestazioni ottimali, usare la chiave surrogata della data più recente. Rappresenta la data in cui è stata creata una revisione o ha null per le revisioni attive o incomplete.
Se vuoi tutte le date dalla data {startDate} inclusa, aggiungi il seguente filtro alla tua query.
RevisedDateSK eq null or RevisedDateSK gt {startDateSK}
Utilizza il WorkItemRevisions set di entità per caricare tutte le revisioni di un elemento di lavoro. La query restituisce tutte le revisioni cronologiche degli elementi di lavoro, inclusa la revisione corrente, per gli elementi di lavoro filtrati. Non include elementi di lavoro eliminati.
Suggerimento
Per creare un report sulle tendenze di rilevamento del lavoro, creare o modificare una visualizzazione di Analisi predefinita e specificare l'intervallo di tempo di interesse nella scheda Cronologia. Per altre informazioni, vedere Creare una visualizzazione di Analisi.
Sia le visualizzazioni di Analisi che i widget Burndown e Burnup consentono di configurare filtri che consentono di definire l'ambito del set di dati in base alle proprie esigenze. Si applicano filtri per limitare i dati a team, tipi di elementi di lavoro o backlog specifici. I filtri possono essere applicati anche a proprietà o campi specifici e ai relativi valori corrispondenti. Ad esempio, è possibile applicare filtri per gli elementi di lavoro per restituire solo i bug definiti per il team di Fabrikam Voice e contrassegnati con il cliente.
Modalità di applicazione dei filtri ai dati cronologici
I filtri vengono applicati a ogni revisione di un elemento di lavoro. Si supponga, ad esempio, di avere un elemento di lavoro con le revisioni seguenti:
| Rev # | Data di revisione | ID | Title | Stato | Percorso dell'area | Tag |
|---|---|---|---|---|---|---|
| 1 | Jan-01 | 1001 | Un bug | Nuovo | ||
| 2 | Jan-02 | 1001 | Un bug | Nuovo | /Ammiragli | |
| 3 | 10 gennaio | 1001 | Un bug | Attive | /Ammiragli | |
| 4 | 12 gennaio | 1001 | Un bug | Attive | /Ammiragli | Cliente |
| 5 | 20 gennaio | 1001 | Un bug | Risolto | /Ammiragli | Cliente |
| 6 (corrente) | 28 gennaio | 1001 | Un bug | Chiusa | /Ammiragli | Cliente |
La revisione più recente (#6) è la revisione corrente dell'elemento di lavoro. Nelle visualizzazioni analisi, se è stato selezionato "Solo corrente" nella scheda Cronologia, si otterrebbe una riga di dati per questo elemento di lavoro, la riga corrente.
Quando si segnala la cronologia, è possibile eseguire il pull delle revisioni da 1 a 6 per la creazione di report.
Si supponga, quando si crea una visualizzazione di Analisi o si configura il widget Burndown, si impostano questi due filtri:
- Percorso area = /Ammiragli
- I tag contengono customer
L'applicazione di questi filtri al set di revisioni degli elementi di lavoro restituisce le corrispondenze seguenti:
| Partita? | Rev # | Data di revisione | ID | Title | Stato | Percorso dell'area | Tag |
|---|---|---|---|---|---|---|---|
|
1 | Jan-01 | 1001 | Un bug | Nuovo | ||
|
|
2 | Jan-02 | 1001 | Un bug | Nuovo | /Ammiragli | |
|
|
3 | 10 gennaio | 1001 | Un bug | Attive | /Ammiragli | |
|
4 | 12 gennaio | 1001 | Un bug | Attive | /Ammiragli | Cliente |
|
|
5 | 20 gennaio | 1001 | Un bug | Risolto | /Ammiragli | Cliente |
|
|
6 (corrente) | 28 gennaio | 1001 | Un bug | Chiusa | /Ammiragli | Cliente |
Le revisioni 1, 2 e 3 non corrispondono, perché tali revisioni non corrispondono ai filtri. L'elemento di lavoro precedente non verrà visualizzato nel set di dati o nel grafico di tendenza fino alla revisione 4 o al 12 gennaio.
Si supponga di voler segnalare la tendenza dei bug attivi, si creerà un filtro Di stato = Attivo. Questi filtri corrispondono alle revisioni seguenti:
| Partita? | Rev # | Data modificata | ID | Title | Stato | Percorso dell'area | Tag |
|---|---|---|---|---|---|---|---|
|
|
1 | Jan-01 | 1001 | Un bug | Nuovo | ||
|
|
2 | Jan-02 | 1001 | Un bug | Nuovo | /Ammiragli | |
|
|
3 | 10 gennaio | 1001 | Un bug | Attive | /Ammiragli | |
|
|
4 | 12 gennaio | 1001 | Un bug | Attive | /Ammiragli | Cliente |
|
|
5 | 20 gennaio | 1001 | Un bug | Risolto | /Ammiragli | Cliente |
|
|
6 (corrente) | 28 gennaio | 1001 | Un bug | Chiusa | /Ammiragli | Cliente |
I filtri corrispondono solo alla revisione 3 e 4 dell'elemento di lavoro e includono solo le revisioni di gennaio-10 e gennaio-12 nel grafico di tendenza.
Cosa significa questo per Burndown o Burnup?
Quando si configura un widget Burndown o Burnup che filtra per un determinato tag (ad esempio, "Cliente"), gli elementi di lavoro non verranno visualizzati nel burndown fino alla data in cui il tag viene definito per l'elemento di lavoro. Se in qualsiasi momento il tag viene rimosso dall'elemento di lavoro, allora l'elemento di lavoro viene rimosso dal burndown dopo la data di rimozione del tag.
Alcuni hanno supposto che se la versione corrente di un elemento di lavoro ha il tag, verrà inclusa nel burndown retroattivamente dall'inizio. Ad esempio, se la versione corrente dell'elemento di lavoro ha il tag "Customer", si presuppone che l'elemento di lavoro venga incluso nel burndown dal punto in cui è stato creato l'elemento di lavoro.
Non è così che funziona il filtro storico. Se i filtri sono stati applicati solo in base alla versione corrente di un elemento di lavoro, i grafici di tendenza non funzioneranno. Non è possibile rimuovere un elemento dal burndown rimuovendo un tag o impostando il percorso area su un altro percorso dell'area del team.
Nota
Stiamo considerando l'aggiunta di un operando "was ever" ai criteri di filtro nelle visualizzazioni di Analytics e nei widget come Burndown/Burnup. Questa funzionalità consente di creare un filtro simile al seguente: "State Was Ever Active". Ciò significa che una revisione dell'elemento di lavoro corrisponderebbe ai criteri di filtro se una revisione dell'elemento di lavoro abbia mai avuto State = Active. Se si ritiene che questa funzionalità sia importante, è possibile votarla nel sito della community degli sviluppatori.
Dati cronologici e sospensione o disabilitazione di Analytics
La sospensione di Analytics mantiene i dati, ma impedisce ai processi di staging di aggiornare i dati. È possibile riprendere il servizio in un secondo momento e i dati vengono quindi aggiornati.
Se un amministratore disabilita Analytics, tutti i processi di gestione temporanea di Analisi vengono disabilitati e i dati di Analisi archiviati nelle tabelle di Analisi vengono eliminati. Tutti i dati di Analisi che acquisisce tendenze cronologiche vengono persi. Non elimina altri dati archiviati nella raccolta. Questa azione non può essere annullata. Una volta eliminati i dati cronologici e i dati di tendenza, non è possibile ripristinarli. La riabilitazione di Analytics non ripristina i dati cronologici.
Con Analytics disabilitato o rimosso, vengono eseguite le azioni seguenti:
- Non vengono eseguiti processi di staging e le tabelle di Analisi non avranno informazioni aggiornate.
- I dati della tabella vengono eliminati e, se Analytics è riabilitato, tutti i dati verranno ripopolati da zero.
Per altre informazioni, vedere Installare o abilitare il servizio Analisi.
Riepilogo
Per riformulare, quando si segnalano dati cronologici, tutti i filtri vengono applicati alla versione dell'elemento di lavoro come punto cronologico nel tempo. Gli elementi di lavoro verranno visualizzati nella tendenza quando soddisfano i criteri di filtro. Scompariranno dalla tendenza quando non soddisfano più i criteri di filtro.