Report di esempio sulla durata del test
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020
I report sulla durata dei test, simili a quello illustrato nell'immagine seguente, forniscono informazioni dettagliate sul numero di esecuzioni di un test e sul tempo medio necessario per l'esecuzione di un determinato test durante un'esecuzione della pipeline.
Usare le query fornite in questo articolo per generare i report seguenti:
- Durata test per il flusso di lavoro di compilazione
- Durata del test per il flusso di lavoro di rilascio
- Durata del test per un ramo specifico
- Durata del test per un file di test specifico
- Durata del test per un proprietario di test specifico
Importante
L'integrazione di Power BI e l'accesso al feed OData del servizio di analisi sono disponibili a livello generale per Azure DevOps Services e Azure DevOps Server 2020 e versioni successive. Le query di esempio fornite in questo articolo sono valide solo per Azure DevOps Server 2020 e versioni successive e dipendono dalla versione v3.0-preview o successiva. È consigliabile usare queste query e fornire commenti e suggerimenti.
Prerequisiti
- Accesso: essere un membro di un progetto con almeno l'accesso Basic .
- Autorizzazioni: per impostazione predefinita, i membri del progetto dispongono dell'autorizzazione per eseguire query su Analisi e creare viste.
- Per altre informazioni sugli altri prerequisiti relativi all'abilitazione di servizi e funzionalità e alle attività generali di rilevamento dei dati, vedere Autorizzazioni e prerequisiti per l'accesso ad Analytics.
Nota
Questo articolo presuppone che sia possibile leggere Panoramica dei report di esempio usando query OData e avere una conoscenza di base di Power BI.
Query di esempio
È possibile usare le query seguenti del TestResultsDaily
set di entità per creare report sulla durata del test diversi ma simili. Il TestResultsDaily
set di entità fornisce un'aggregazione snapshot giornaliera delle TestResult
esecuzioni, raggruppate per test.
Nota
Per determinare le proprietà disponibili a scopo di filtro o report, vedere Informazioni di riferimento sui metadati per l'analisi dei piani di test e i metadati per Azure Pipelines. È possibile filtrare le query o restituire proprietà usando uno qualsiasi dei Property
valori in un EntityType
oggetto o NavigationPropertyBinding Path
i valori disponibili con un oggetto EntitySet
. Ognuno EntitySet
corrisponde a un oggetto EntityType
. Per altre informazioni sul tipo di dati di ogni valore, esaminare i metadati forniti per l'oggetto corrispondente EntityType
.
Durata del test per il flusso di lavoro di compilazione
Usare le query seguenti per visualizzare il report sulla durata del test per una pipeline con un flusso di lavoro di compilazione .
Copiare e incollare la query di Power BI seguente direttamente nella finestra Recupera dati>query vuota. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed (
"https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?"
&"$apply=filter("
&"Pipeline/PipelineName eq '{pipelineName}' "
&"And Date/Date ge {startdate} "
&"And Workflow eq 'Build'"
&")/groupby("
&"(TestSK, Test/TestName),"
&"aggregate("
&"ResultCount with sum as TotalCount, "
&"ResultDurationSeconds with sum as TotalDuration"
&"))/compute("
&"TotalDuration div TotalCount as AvgDuration"
&")",
null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
)
in
Source
Durata del test per il flusso di lavoro Versione
Usare le query seguenti per visualizzare il report sulla durata del test per una pipeline con un flusso di lavoro Release .
Copiare e incollare la query di Power BI seguente direttamente nella finestra Recupera dati>query vuota. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed (
"https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?"
&"$apply=filter("
&"Pipeline/PipelineName eq '{pipelineName}' "
&"And Date/Date ge {startdate}"
&")/groupby("
&"(TestSK, Test/TestName, Workflow),"
&"aggregate("
&"ResultCount with sum as TotalCount, "
&"ResultDurationSeconds with sum as TotalDuration"
&"))/compute("
&"TotalDuration div TotalCount as AvgDuration"
&")",
null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
)
in
Source
Durata del test filtrata per ramo
Per visualizzare la durata del test dei test della pipeline per un ramo specifico, usare le query seguenti. Per creare il report, eseguire i passaggi aggiuntivi seguenti insieme a quanto specificato più avanti in questo articolo.
- Espandi
Branch
inBranch.BranchName
- Selezionare Filtro dei dati visualizzazione di Power BI e aggiungere il campo al campo
Branch.BranchName
del filtro dei dati - Selezionare il nome del ramo dal filtro dei dati per il quale è necessario visualizzare il riepilogo dei risultati.
Per altre informazioni sull'uso dei filtri dei dati, vedere Filtri dei dati in Power BI.
Copiare e incollare la query di Power BI seguente direttamente nella finestra Recupera dati>query vuota. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed (
"https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?"
&"$apply=filter("
&"Pipeline/PipelineName eq '{pipelineName}' "
&"And Date/Date ge {startdate} "
&"And Workflow eq 'Build'"
&")/groupby("
&"(TestSK, Test/TestName, Branch/BranchName),"
&"aggregate("
&"ResultCount with sum as TotalCount, "
&"ResultDurationSeconds with sum as TotalDuration"
&"))/compute("
&"TotalDuration div TotalCount as AvgDuration"
&")",
null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
)
in
Source
Durata del test filtrata in base al file di test
Per visualizzare la durata del test di una pipeline per i test di proprietà di un determinato proprietario del test, usare le query seguenti. Per creare il report, eseguire i passaggi aggiuntivi seguenti insieme a quanto definito più avanti in questo articolo.
- Espandi
Test
inTest.ContainerName
- Selezionare Filtro dei dati visualizzazione di Power BI e aggiungere il campo al campo
Test.ContainerName
del filtro dei dati - Selezionare il file di test dal filtro dei dati per il quale è necessario visualizzare il riepilogo dei risultati.
Copiare e incollare la query di Power BI seguente direttamente nella finestra Recupera dati>query vuota. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed (
"https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?"
&"$apply=filter("
&"Pipeline/PipelineName eq '{pipelineName}' "
&"And Date/Date ge {startdate} "
&"And Workflow eq 'Build'"
&")/groupby("
&"(TestSK, Test/TestName, Test/ContainerName),"
&"aggregate("
&"ResultCount with sum as TotalCount, "
&"ResultDurationSeconds with sum as TotalDuration"
&"))/compute("
&"TotalDuration div TotalCount as AvgDuration"
&")",
null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
)
in
Source
Durata del test filtrata in base al proprietario del test
Per visualizzare la durata del test di una pipeline per i test di proprietà di un determinato proprietario del test, usare le query seguenti. Per creare il report, eseguire i passaggi aggiuntivi seguenti insieme a quanto definito più avanti in questo articolo.
- Espandi
Test
inTest.TestOwner
- Selezionare Filtro dei dati visualizzazione di Power BI e aggiungere il campo al campo
Test.TestOwner
del filtro dei dati - Selezionare il proprietario del test dal filtro dei dati per il quale è necessario visualizzare il riepilogo dei risultati.
Copiare e incollare la query di Power BI seguente direttamente nella finestra Recupera dati>query vuota. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.
let
Source = OData.Feed (
"https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/TestResultsDaily?"
&"$apply=filter("
&"Pipeline/PipelineName eq '{pipelineName}' "
&"And Date/Date ge {startdate} "
&"And Workflow eq 'Build'"
&")/groupby("
&"(TestSK, Test/TestName, Test/TestOwner),"
&"aggregate("
&"ResultCount with sum as TotalCount, "
&"ResultDurationSeconds with sum as TotalDuration"
&"))/compute("
&"TotalDuration div TotalCount as AvgDuration"
&")",
null, [Implementation="2.0", OmitValues = ODataOmitValues.Nulls, ODataVersion = 4]
)
in
Source
Stringhe di sostituzione e scomposizione delle query
Sostituire le stringhe seguenti con i valori. Non includere parentesi quadre {} con la sostituzione. Ad esempio, se il nome dell'organizzazione è "Fabrikam", sostituire {organization}
con Fabrikam
, non {Fabrikam}
.
{organization}
- Nome dell'organizzazione.{project}
- Nome del progetto team.{pipelinename}
- Nome della pipeline. Esempio:Fabrikam hourly build pipeline
.{startdate}
- Data di inizio del report. Formato: AAAA-MM-GG. Esempio:2021-09-01Z
rappresenta il 1° settembre 2021. Non racchiudere tra virgolette o parentesi quadre e usare due cifre per entrambi, mese e data.
Suddivisione delle query
La tabella seguente descrive ogni parte della query.
Parte della query
Descrizione
$apply=filter(
Clausola Start filter()
.
Pipeline/PipelineName eq '{pipelineName}'
Restituire le esecuzioni di test per la pipeline denominata.
And Date/Date ge {startdate}
Restituisce le esecuzioni dei test in o dopo la data specificata.
and Workflow eq 'Build'
Restituire le esecuzioni dei test per un Build
flusso di lavoro.
)
Clausola Close filter()
.
/groupby(
Clausola Start groupby()
.
(TestSK, Test/TestName),
Raggruppare in base al nome del test.
aggregate(
Clausola Start aggregate
per sommare risultati di esecuzione di test diversi corrispondenti ai criteri di filtro.
ResultCount with sum as TotalCount,
Contare il numero totale di esecuzioni di test come TotalCount
.
ResultDurationSeconds with sum as TotalDuration
Sommare la durata totale di tutte le esecuzioni come TotalDuration
.
))
Chiudere aggregate()
e groupby()
clausole.
/compute(
Clausola Start compute()
.
TotalDuration div TotalCount as AvgDuration
Per tutti i test, calcolare la durata media dividendo la durata totale in base al numero totale di esecuzioni.
)
Clausola Close compute()
.
(Facoltativo) Rinominare la query
È possibile rinominare l'etichetta di query predefinita Query1 in qualcosa di più significativo. È sufficiente immettere un nuovo nome dal riquadro Impostazioni query.
Espandere la colonna Test in Power BI
Espandere la Test
colonna per visualizzare l'entità Test.TestName
espansa . Espandendo la colonna, il record viene appiattito in campi specifici. Per informazioni su come, vedere Trasformare i dati di Analisi per generare report di Power BI, Espandere le colonne.
Modificare il tipo di dati della colonna
Nella editor di Power Query selezionare la
TotalCount
colonna, selezionare Tipo di dati dal menu Trasforma e quindi scegliere Numero intero.Selezionare le
TotalDuration
colonne eAvgDuration
, selezionare Tipo di dati dal menu Trasforma e quindi scegliere Numero decimale.
Per altre informazioni sulla modifica del tipo di dati, vedere Trasformare i dati di Analisi per generare report di Power BI, Trasformare un tipo di dati di colonna.
Chiudere la query e applicare le modifiche
Dopo aver completato tutte le trasformazioni dei dati, scegliere Chiudi e applica dal menu Home per salvare la query e tornare alla scheda Report in Power BI.
Creare il report Tabella
In Power BI, in Visualizzazioni scegliere **Tabella, trascinare e rilasciare i campi nell'area Colonne .
Aggiungere i campi seguenti alla sezione Colonne nell'ordine elencato.
Test.TestName
TotalCount
AvgDuration
Fare clic con il pulsante destro del
AvgDuration
menu e scegliere Media anziché Somma.
Il report dovrebbe essere simile all'immagine seguente.