Exemple de rapport de tendance du taux de transmission de pipeline

  • Article

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

Cet article vous montre comment créer un rapport qui montre la tendance quotidienne du taux de passage quotidien d’un pipeline. Le taux de transmission d’un pipeline est défini comme pourcentage d’exécutions de pipeline réussies vers le nombre total d’exécutions de pipeline. Il est similaire au graphique « Tendance du taux de passage » du rapport de taux de transmission de pipeline. L’image suivante montre un exemple de tendance de ce type.

Capture d’écran du rapport tendance des taux d’exécution des pipelines Power BI.

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

  • Accès : être membre d’un projet avec au moins un accès de base .
  • Autorisations : par défaut, les membres du projet ont l’autorisation d’interroger Analytics et de créer des vues.
  • Pour plus d’informations sur les autres prérequis concernant l’activation du service et des fonctionnalités et les activités de suivi des données générales, consultez Autorisations et conditions préalables pour accéder à Analytics.

Remarque

Cet article part du principe que vous lisez la 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 PipelineRuns d’entités pour créer des rapports de tendances de taux de transmission différents, mais similaires.

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 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 plus d’informations sur le type de données de chaque valeur, passez en revue les métadonnées fournies pour le type de données correspondant EntityType.

Tendance du taux de transmission d’un pipeline nommé

Les requêtes suivantes retournent les exécutions du pipeline pour un pipeline spécifique à partir d’une date de début spécifiée.

Copiez et collez la requête Power BI suivante directement dans la fenêtre Obtenir une requête vide de données>. Pour plus d’informations, consultez Vue d’ensemble des exemples de rapports à l’aide de requêtes OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

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 : 2021-09-01Z représente le 1er septembre 2021. Ne placez pas entre guillemets ou crochets et utilisez deux chiffres pour les deux, mois et date.

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 des exécutions de pipeline pour le pipeline spécifié.

and CompletedDate ge {startdate}

Le pipeline de retour s’exécute à la date spécifiée ou après celle-ci.

and CanceledCount ne 1

Omettre les exécutions de pipeline annulées.

)

Clause Close filter() .

/groupby(

Clause Start groupby() .

(CompletedOn/Date),

Regrouper par date d’achèvement de l’exécution du pipeline.

aggregate

Clause Start aggregate pour tous les exécutions du pipeline correspondant aux critères de filtre.

($count as TotalCount,

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

SucceededCount with sum as SucceededCount ,

Compter le nombre d’exécutions réussies en tant que SucceededCount.

FailedCount with sum as FailedCount,

Comptez le nombre d’exécutions ayant échoué en tant que FailedCount.

PartiallySucceededCount with sum as PartiallySucceededCount))

Comptez le nombre d’exécutions partiellement réussies en tant que PartiallySucceededCount. Close aggregate() et groupby() clauses.

/compute(

Début de compute() la clause.

SucceededCount mul 100.0 div TotalCount as PassRate,

Calculez PassRate pour chaque jour en divisant le nombre d’exécutions réussies par nombre d’exécutions totales.

FailedCount mul 100.0 div TotalCount as FailRate,

Calculez FailRate pour chaque jour en divisant le nombre d’exécutions ayant échoué par nombre d’exécutions totales.

PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate)

Calculez PartiallySuccessfulRate pour chaque jour en divisant le nombre d’exécutions partiellement réussies par nombre d’exécutions totales.

&$orderby=CompletedOn/Date asc

Commandez le résultat par ordre croissant en fonction de la date d’exécution du pipeline.

Tendance du taux de transmission d’un ID de pipeline

Les pipelines peuvent être renommés. Pour vous assurer que les rapports Power BI ne s’arrêtent pas lorsque le nom du pipeline est modifié, utilisez l’ID de pipeline plutôt que le nom du pipeline. Vous pouvez obtenir l’ID de pipeline à partir de l’URL de la page d’exécution des pipelines.

https://dev.azure.com/{organization}/{project}/_build?definitionId={pipelineid}

Les requêtes suivantes retournent les exécutions du pipeline pour un ID de pipeline spécifique à partir d’une date de début spécifiée.

Copiez et collez la requête Power BI suivante directement dans la fenêtre Obtenir une requête vide de données>. Pour plus d’informations, consultez Vue d’ensemble des exemples de rapports à l’aide de requêtes OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"PipelineId eq {pipelineId} "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendance du taux de transmission, filtrer par branche

Vous souhaiterez peut-être afficher la tendance du taux de transmission d’un pipeline pour une branche particulière uniquement. Pour créer le rapport, effectuez les étapes supplémentaires suivantes, ainsi que ce qui est décrit dans le type de données modifier la colonne et créer les sections de rapport de graphique en courbes.

  • Développez Branch en Branch.BranchName.
  • Sélectionnez Segment de visualisation Power BI et ajoutez-le Branch.BranchName au champ du segment.
  • Sélectionnez la branche dans le segment pour laquelle vous devez voir la tendance du taux de passage.

Copiez et collez la requête Power BI suivante directement dans la fenêtre Obtenir une requête vide de données>. Pour plus d’informations, consultez Vue d’ensemble des exemples de rapports à l’aide de requêtes OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(Branch/BranchName, CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendance du taux de transmission, filtrer par raison de génération

Vous pouvez afficher la tendance du taux de transmission d’un pipeline uniquement pour des raisons de build spécifiques (Manuel / BatchedCI, Demande de tirage, etc.). Pour créer le rapport, effectuez les étapes supplémentaires suivantes, ainsi que ce qui est décrit dans le type de données modifier la colonne et créer les sections de rapport de graphique en courbes.

  • Sélectionnez Segment dans le volet Visualisations et ajoutez-le RunReason au champ du segment.
  • Sélectionnez le pipeline dans le segment pour lequel vous devez voir la tendance du taux de réussite.

Copiez et collez la requête Power BI suivante directement dans la fenêtre Obtenir une requête vide de données>. Pour plus d’informations, consultez Vue d’ensemble des exemples de rapports à l’aide de requêtes OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"Pipeline/PipelineName eq '{pipelineName}' "
                &"and CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
        &") "
        &"/groupby( "
            &"(RunReason, CompletedOn/Date), "
                &"aggregate "
                &"($count as TotalCount, "
            &"SucceededCount with sum as SucceededCount , "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
        &"/compute( "
    &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Tendance des taux de transmission pour tous les pipelines de projet

Utilisez les requêtes suivantes pour afficher la tendance du taux de transmission pour tous les pipelines du projet dans un seul rapport. Pour créer le rapport, effectuez les étapes supplémentaires suivantes, ainsi que ce qui est décrit dans le type de données modifier la colonne et créer les sections de rapport de graphique en courbes.

  • Développez Pipeline en Pipeline.PipelineName.
  • Sélectionnez Segment dans le volet Visualisations, puis ajoutez le champ Pipeline.PipelineName au champ du segment.
  • Sélectionnez le pipeline de build à partir du segment pour lequel vous devez voir la tendance du taux de réussite.

Reportez-vous au résumé des résultats pour tous les exemples de rapport de pipelines qui ont des étapes similaires détaillées comme nécessaire ici.

Copiez et collez la requête Power BI suivante directement dans la fenêtre Obtenir une requête vide de données>. Pour plus d’informations, consultez Vue d’ensemble des exemples de rapports à l’aide de requêtes OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?"
        &"$apply=filter( "
                &"CompletedDate ge {startdate} "
                &"and CanceledCount ne 1 "
                &") "
        &"/groupby( "
        &"(Pipeline/PipelineName, CompletedOn/Date), "
            &"aggregate "
                &"($count as TotalCount, "
                &"SucceededCount with sum as SucceededCount , "
            &"FailedCount with sum as FailedCount, "
                &"PartiallySucceededCount with sum as PartiallySucceededCount)) "
            &"/compute( "
        &"SucceededCount mul 100.0 div TotalCount as PassRate, "
    &"FailedCount mul 100.0 div TotalCount as FailRate, "
    &"PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate) "
    &"&$orderby=CompletedOn/Date asc "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

(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 des colonnes dans Éditeur Power Query

Avant de créer le rapport, vous devez développer des colonnes qui retournent des enregistrements contenant plusieurs champs. Dans cette instance, vous souhaiterez développer la CompletedOn colonne pour l’aplatir CompletedOn.Datesur .
Pour savoir comment développer des éléments de travail, consultez Transformer des données Analytics pour générer des rapports Power BI.

Modifier le type de données de colonne

Dans le menu Transformer , modifiez le type de données pour les colonnes suivantes. Pour savoir comment procéder, consultez Transformer un type de données de colonne.

  • PassRateet FailRate PartiallySuccessfulRate colonnes en nombre décimal.
  • TotalCount à nombre entier.

(Facultatif) Renommer des champs de colonne

Vous pouvez renommer des champs de colonne. Par exemple, vous pouvez renommer la colonne Pipeline.PipelineName en Pipeline Name, ou TotalCount en Total Count. Pour savoir comment procéder, consultez Renommer les champs 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 le rapport de graphique en courbes.

    Capture d’écran des sélections de champs de visualisation pour le rapport de graphique en courbes de tendance de taux de transmission.

  2. Ajouter CompletedOn.Date à l’axe X. Cliquez avec le bouton droit sur le champ et choisissez CompletedOn.Date.

  3. Ajoutez PassRate à l’axe Y, puis cliquez dessus avec le bouton droit pour vérifier que Somme est sélectionnée.

  4. Pour modifier le titre du rapport, sélectionnez l’icône Mettre en forme votre pinceau visuel dans le volet Visualisations, sélectionnez Général, Développez Titre et remplacez le texte existant.

    L’image suivante montre le rapport résultant.

    Capture d’écran du rapport de tendance des taux d’exécutions pass de pipelines Power BI.