Exemple de rapport de tendance de durée de test

  • Article

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Les rapports de tendances de durée de test, similaires à ceux présentés dans l’image suivante, fournissent un aperçu de la tendance quotidienne du temps moyen nécessaire pour exécuter un test pour un intervalle de temps sélectionné. Pour plus d’informations sur l’ajout de tests à un pipeline, consultez la section Ressources des tâches de test plus loin dans cet article.

Capture d’écran du rapport de graphique en courbes de tendance de durée de test.

Important

L’intégration de Power BI et l’accès au flux OData du service Analytics sont généralement disponibles pour Azure DevOps Services et Azure DevOps Server 2020 et versions ultérieures. Les exemples de requêtes fournis dans cet article sont valides uniquement sur Azure DevOps Server 2020 et versions ultérieures, et dépendent de la version v3.0-preview ou ultérieure. Nous vous encourageons à utiliser ces requêtes et à nous fournir des commentaires.

Prérequis

  • Pour afficher les données Analytics et interroger le service, vous devez être membre d’un projet avec un accès de base ou supérieur. Par défaut, tous les membres du projet sont autorisés à interroger Analytics et à définir des vues Analytics.
  • Pour en savoir plus sur les autres prérequis concernant l’activation des services et des fonctionnalités et les activités générales de suivi des données, consultez Autorisations et prérequis pour accéder à Analytics.

Remarque

Cet article suppose que vous avez lu Vue d’ensemble des exemples de rapports à l’aide de requêtes OData et que vous avez une compréhension de base de Power BI.

Exemples de requêtes

Vous pouvez utiliser les requêtes suivantes de l’ensemble TestResultsDaily d’entités pour créer des rapports de durée de test différents mais similaires. L’ensemble TestResultsDaily d’entités fournit un agrégat quotidien instantané des TestResult exécutions, regroupés par test.

Remarque

Pour déterminer les propriétés disponibles à des fins de filtre ou de rapport, consultez la référence des métadonnées pour l’analyse des plans de test et les informations de référence sur les métadonnées pour Azure Pipelines. Vous pouvez filtrer vos requêtes ou renvoyer des propriétés à l’aide de l’une Property des valeurs sous ou EntityType des NavigationPropertyBinding Path valeurs disponibles avec un EntitySet. Chaque EntitySet correspond à un EntityType. Pour en savoir plus sur le type de données de chaque valeur, passez en revue les métadonnées fournies pour le .EntityType

Utilisez les requêtes suivantes pour afficher le rapport de tendance de durée de test d’un pipeline avec un workflow de génération .

Vous pouvez coller la requête Power BI répertoriée ci-dessous> directement dans la fenêtre Obtenir une requête vide. Pour plus d’informations, consultez Vue d’ensemble des exemples de rapports utilisant des requêtes OData.

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, Date/Date), 
	aggregate(
	  ResultCount with sum as TotalCount,
	  ResultDurationSeconds with sum as TotalDuration
	))
/compute(
	TotalDuration div TotalCount as AvgDuration
	)

Chaînes de substitution et répartition des requêtes

Remplacez les chaînes suivantes par vos valeurs. N’incluez pas de crochets {} avec votre substitution. Par exemple, si le nom de votre organisation est « Fabrikam », remplacez par {organization}Fabrikam, et non {Fabrikam}par .

 

  • {organization} - Nom de votre organisation
  • {project} - Nom de votre projet d’équipe
  • {pipelinename} - Nom de votre pipeline. Exemple : Fabrikam hourly build pipeline
  • {startdate} - Date de démarrage de votre rapport. Format : AAAA-MM-DDZ. Exemple : 2022-09-01Z représente le 1er septembre 2022. Ne placez pas entre guillemets ou crochets et utilisez deux chiffres pour les deux, mois et date.

Conseil

Selon le nombre de tests ajoutés à un pipeline, les données retournées peuvent être significatives. Nous vous recommandons d’utiliser un {startdate} délai de quelques jours pour évaluer la quantité de données retournées et ajuster en conséquence.

Répartition des requêtes

Le tableau suivant décrit chaque partie de la requête.

Composant de requête

Description

$apply=filter(

Clause Start filter() .

Pipeline/PipelineName eq '{pipelineName}'

Retourne les exécutions de test pour le pipeline nommé.

And Date/Date ge {startdate}

Retourne des exécutions de test à la date spécifiée ou après la date spécifiée.

and Workflow eq 'Build'

Retourne des exécutions de test pour un Build flux de travail.

)

Clause Close filter() .

/groupby(

Clause Start groupby() .

(TestSK, Test/TestName, Date/Date),

Regroupez par test, nom de test et date d’exécution.

aggregate(

Clause start aggregate pour additionner différents résultats d’exécution de test correspondant aux critères de filtre.

ResultCount with sum as TotalCount,

Comptez le nombre total d’exécutions de test sous la forme TotalCount.

ResultDurationSeconds with sum as TotalDuration

Additionnez la durée totale de toutes les exécutions en tant que TotalDuration.

))

Close aggregate() et groupby() clauses.

/compute(

Clause Start compute() .

TotalDuration div TotalCount as AvgDuration

Pour tous les tests, calculez la durée moyenne en divisant la durée totale par nombre total d’exécutions.

)

Clause Close compute() .

(Facultatif) Renommer la requête

Vous pouvez renommer l’étiquette de requête par défaut , Query1, en quelque chose de plus significatif. Entrez simplement un nouveau nom dans le volet Paramètres de requête .

Capture d’écran des options de menu de requête Power BI, renommer la requête.

Développer les colonnes Test et Date dans Power BI

Le développement d’une colonne aplatit l’enregistrement dans des champs spécifiques. Pour savoir comment afficher les données Transform Analytics pour générer des rapports Power BI, développez des colonnes.

  1. Développez la Test colonne pour afficher les entités TestSK développées et Test.TestName.
  2. Développez la Date colonne pour afficher l’entité Date.Datedéveloppée.

Modifier le type de données de colonne

  1. Dans le Éditeur Power Query, sélectionnez la TotalCount colonne ; sélectionnez Type de données dans le menu Transformer, puis choisissez Qui le Nombre.

  2. Sélectionnez les colonnes et le type de données dans le menu Transformer, puis choisissez Nombre décimal.TotalDurationAvgDuration

Pour en savoir plus sur la modification du type de données, consultez Transform Analytics pour générer des rapports Power BI, Transformer un type de données de colonne.

Fermez la requête et appliquez vos modifications

Une fois que vous avez terminé toutes vos transformations de données, choisissez Fermer & Appliquer dans le menu Accueil pour enregistrer la requête et revenir à l’onglet Rapport dans Power BI.

Capture d’écran de Éditeur Power Query’option Fermer et appliquer.

Créer le rapport de graphique en courbes

  1. Dans Power BI, sous Visualisations, choisissez Graphique en courbes et faites glisser et déposez les champs dans la zone Colonnes.

    Capture d’écran des sélections de champs de visualisation pour le rapport de graphique en courbes de tendance de durée de test.

  2. Ajoutez Date.Date à l’axe X, cliquez avec le bouton droit sur le champ et sélectionnez Date.Date, plutôt que Date.Hierarchy.

  3. Ajoutez AvgDuration à l’axe Y.

Votre rapport doit ressembler à l’image suivante.

Capture d’écran de l’exemple de rapport courbes de tendance de durée de test.

Ressources de tâche de test