Résumé des résultats du pipeline pour tous les exemples de rapports de pipelines

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

Vous pouvez utiliser les informations fournies dans cet article pour interroger les métriques de pipeline, telles que le taux de réussite, le nombre d’échecs, la durée, etc. pour tous les pipelines et créer un rapport unique. Des requêtes supplémentaires sont fournies pour obtenir d’autres métriques, telles que la durée du pipeline et le nombre d’échecs pour tous les pipelines de projet.

L’image suivante illustre le résumé des résultats pour tous les pipelines définis pour un projet depuis septembre 2022.

Capture d’écran du rapport résumé des résultats de tous les pipelines.

Comme illustré dans l’image suivante, vous pouvez sélectionner n’importe quel pipeline dans le menu déroulant Nom du pipeline et le rapport change pour se concentrer sur le résumé des résultats du pipeline sélectionné.

Capture d’écran du rapport montrant le résumé des résultats du pipeline sélectionné uniquement.

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 synthèse de résultats de pipeline 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.

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} "
	       &")"
                &"/groupby( "
        &"(Pipeline/PipelineName), "
        &"aggregate( "
            &"$count as TotalCount, "
                &"SucceededCount with sum as SucceededCount, "
                &"FailedCount with sum as FailedCount, "
            &"PartiallySucceededCount with sum as PartiallySucceededCount, "
                &"CanceledCount with sum as CanceledCount "
            &")) "
    ,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
  • {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.

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() .

CompletedDate ge {startdate}

Retourne les exécutions du pipeline pour la date supérieure à la date spécifiée.

)

Clause Close filter() .

/groupby(

Clause Start groupby() /

(Pipeline/PipelineName),

Regroupez les résultats des données par nom de pipeline.

aggregate(

Clause Start aggregate pour chaque pipeline.

$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.

CanceledCount with sum as CanceledCount

Comptez le nombre d’exécutions annulées en tant que CanceledCount.

))

Close aggregate() et groupby() clauses.

(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 la colonne Pipeline dans Éditeur Power Query

Avant de créer le rapport, développez la Pipeline colonne qui retourne des enregistrements pouvant contenir un ou plusieurs champs.

  1. Fermez la Éditeur avancé.

  2. Dans le Éditeur Power Query, choisissez le bouton développer la Pipeline colonne, vérifiez qu’elle PipelineName est sélectionnée, puis cliquez sur OK.

    Capture d’écran du menu Développer la colonne Pipelines.

    La table contient maintenant l’entité Pipeline.PipelineNamedéveloppée .

    Capture d’écran de la colonne Pipeline.PipelineName.

Modifier le type de données de colonne

Dans le Éditeur Power Query, sélectionnez la TotalCount colonne, puis sélectionnez Type de données dans le menu Transformer, puis choisissez Nombre entier. Pour plus d’informations 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.

(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 Histogramme empilé

  1. Dans Power BI, sous Visualisations, choisissez le rapport Histogramme empilé.

    Capture d’écran des sélections de champs de visualisation pour tous les rapports d’exécutions de pipeline.

  2. Ajoutez Pipeline.PipelineName ou la colonne Pipeline Name renommée à l’axe.

  3. Ajoutez les champs suivants aux valeurs dans l’ordre indiqué, puis cliquez avec le bouton droit sur chaque champ et vérifiez que Somme est sélectionnée.

    • SucceededCount
    • FailedCount
    • CanceledCount
    • PartiallySucceededCount.
  4. Pour ajouter un segment au rapport, désélectionnez le rapport et sélectionnez Segment dans le volet Visualisations.

    • Ajoutez Pipeline.PipelineName ou la colonne Pipeline Name renommée à Field.
      Capture d’écran du volet Visualisations, segment, nom du pipeline ajouté.

    • Pour remplacer le segment d’une liste par une option de menu déroulant, sélectionnez l’icône Mettre en forme votre pinceau visuel dans le volet Visualisations , puis sélectionnez l’option De liste déroulante au lieu de Liste.

      Capture d’écran du volet Visualisations, segment, options de paramètres, liste déroulante sélectionnée.

Le rapport apparaît comme suit.

Capture d’écran de l’exemple de rapport résumé des résultats des pipelines.