Souhrn výsledků kanálu pro všechny ukázkové sestavy kanálů

  • Článek

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

Informace uvedené v tomto článku můžete použít k dotazování metrik kanálu, jako je rychlost průchodu, počet selhání, doba trvání atd., pro všechny kanály a vytvořit jednu sestavu. Další dotazy jsou k dispozici pro získání dalších metrik, jako je doba trvání kanálu a počet selhání pro všechny kanály projektu.

Následující obrázek znázorňuje souhrn výsledků pro všechny kanály definované pro projekt od září 2022.

Snímek obrazovky se sestavou souhrnu výsledků všech kanálů

Jak je znázorněno na následujícím obrázku, můžete vybrat libovolný kanál z rozevírací nabídky Název kanálu a sestava se změní tak, aby se zaměřila na souhrn výsledků vybraného kanálu.

Snímek obrazovky sestavy zobrazující souhrn výsledků jenom pro vybraný kanál

Důležité

Integrace Power BI a přístup k datovému kanálu OData služby Analytics jsou obecně dostupné pro Azure DevOps Services a Azure DevOps Server 2020 a novější verze. Ukázkové dotazy uvedené v tomto článku jsou platné pouze pro Azure DevOps Server 2020 a novější verze a závisí na verzi v3.0-Preview nebo novější. Doporučujeme, abyste tyto dotazy používali a poskytli nám zpětnou vazbu.

Požadavky

  • Pokud chcete zobrazit data Analýzy a dotazovat se na službu, musíte být členem projektu se základním přístupem nebo novějším. Ve výchozím nastavení mají všichni členové projektu udělená oprávnění k dotazování analýzy a definování zobrazení Analýzy.
  • Další informace o dalších požadavcích týkajících se povolení služeb a funkcí a obecných aktivit sledování dat najdete v tématu Oprávnění a požadavky pro přístup k Analýzám.

Poznámka:

Tento článek předpokládá, že jste si přečetli přehled ukázkových sestav pomocí dotazů OData a máte základní znalosti o Power BI.

Vzorové dotazy

Následující dotazy sady entit můžete použít k vytvoření různých, ale podobných PipelineRuns souhrnných sestav výsledků kanálu.

Poznámka:

Informace o dostupných vlastnostech pro účely filtru nebo sestavy najdete v referenčních informacích k metadatům pro Azure Pipelines. Dotazy můžete filtrovat nebo vracet vlastnosti pomocí libovolné hodnoty Property pod hodnotami nebo NavigationPropertyBinding Path hodnotami dostupnými v objektu EntitySetEntityType . Každý EntitySet odpovídá hodnotě EntityType. Další informace o datovém typu každé hodnoty najdete v metadatech zadaných pro odpovídající EntityTypehodnotu .

Dotaz Power BI uvedený níže můžete vložit přímo do okna Získat prázdný dotaz dat>. Další informace najdete v přehledu ukázkových sestav pomocí dotazů 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

Náhradní řetězce a rozpis dotazů

Nahraďte následující řetězce hodnotami. Nezahrnujte do náhradních závorek {} . Pokud je například název vaší organizace "Fabrikam", nahraďte {organization} ho Fabrikam, nikoli {Fabrikam}.

  • {organization} – Název vaší organizace
  • {project} - Název projektu vašeho týmu
  • {startdate} - Datum zahájení sestavy. Formát: RRRR-MM-DDZ. Příklad: 2022-09-01Z představuje 1. září 2022. Nepoužívejte uvozovky ani hranaté závorky a pro oba měsíce a datum použijte dvě číslice.

Rozpis dotazů

Následující tabulka popisuje jednotlivé části dotazu.

Část dotazování

Popis

$apply=filter(

Klauzule Start filter() .

CompletedDate ge {startdate}

Vrácení spuštění kanálu pro datum větší než zadané datum.

)

Klauzule Close filter()

/groupby(

Klauzule Start groupby() /

(Pipeline/PipelineName),

Seskupte výsledky dat podle názvu kanálu.

aggregate(

Počáteční aggregate klauzule pro každý kanál.

$count as TotalCount,

Spočítejte celkový počet spuštění jako TotalCount.

SucceededCount with sum as SucceededCount.

Spočítejte počet úspěšných spuštění jako SucceededCount.

FailedCount with sum as FailedCount,

Spočítejte počet neúspěšných spuštění jako FailedCount.

PartiallySucceededCount with sum as PartiallySucceededCount,

Spočítejte počet částečně úspěšných spuštění jako PartiallySucceededCount.

CanceledCount with sum as CanceledCount

Spočítejte počet zrušených spuštění jako CanceledCount.

))

Uzavření aggregate() a groupby() klauzule

(Volitelné) Přejmenování dotazu

Výchozí popisek dotazu , Query1, můžete přejmenovat na něco smysluplnějšího. Jednoduše zadejte nový název z podokna Nastavení dotazu.

Snímek obrazovky s možnostmi nabídky dotazu Power BI a přejmenování dotazu

Rozbalení sloupce Kanálu v Editor Power Query

Před vytvořením sestavy Pipeline rozbalte sloupec, který vrací záznamy, které můžou obsahovat jedno nebo více polí.

  1. Zavřete Rozšířený editor.

  2. V Editor Power Query zvolte Pipeline tlačítko rozbalení sloupce, ujistěte se, že PipelineName je vybrané, a pak zvolte OK.

    Snímek obrazovky s rozbalenou nabídkou sloupce Pipelines

    Tabulka teď obsahuje rozbalenou entitu Pipeline.PipelineName.

    Snímek obrazovky se sloupcem Pipeline.PipelineName

Změna datového typu sloupce

V Editor Power Query vyberte TotalCount sloupec a potom v nabídce Transformace vyberte datový typ a zvolte Kdo le Number. Další informace o změně datového typu najdete v tématu Transformace analytických dat pro generování sestav Power BI a transformace datového typu sloupce.

(Volitelné) Přejmenování polí sloupců

Pole sloupců můžete přejmenovat. Můžete například přejmenovat sloupec Pipeline.PipelineName na Pipeline Name, nebo TotalCount na Total Count. Postup najdete v tématu Přejmenování polí sloupců.

Zavřete dotaz a použijte změny.

Jakmile dokončíte všechny transformace dat, v nabídce Domů zvolte Zavřít a použítdotaz a vraťte se na kartu Sestava v Power BI.

Snímek obrazovky s možností Zavřít a Použít Editor Power Query

Vytvoření sestavy skládaného sloupcového grafu

  1. V Power BI v části Vizualizace zvolte sestavu skládaného sloupcového grafu .

    Snímek obrazovky s výběrem polí vizualizace pro všechny sestavy spuštění kanálu

  2. Přidejte Pipeline.PipelineName nebo přejmenovaný sloupec Pipeline Name na osu.

  3. Přidejte následující pole do hodnot v uvedeném pořadí a klikněte pravým tlačítkem myši na každé pole a ujistěte se, že je vybrán součet .

    • SucceededCount
    • FailedCount
    • CanceledCount
    • PartiallySucceededCount.

  4. Pokud chcete do sestavy přidat průřez, zrušte výběr sestavy a v podokně Vizualizace vyberte Průřez.

    • Přidejte Pipeline.PipelineName nebo přejmenovaný sloupec Pipeline Name do pole.
      Snímek obrazovky s podoknem Vizualizace, průřezem a přidaným názvem kanálu

    • Pokud chcete změnit průřez ze seznamu na možnost rozevírací nabídky, vyberte v podokně Vizualizace ikonu Formát vizuálního malířského štětce a vyberte možnost Rozevírací seznam místo seznamu.

      Snímek obrazovky s podoknem Vizualizace, průřezem, možnostmi nastavení a vybranou možností rozevíracího seznamu

Sestava se zobrazí následujícím způsobem.

Snímek obrazovky s ukázkovou sestavou souhrnu výsledků kanálu