すべてのパイプライン サンプル レポートのパイプライン結果の概要

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

この記事で提供されている情報を使用して、すべてのパイプラインのパス レート、失敗回数、期間などのパイプライン メトリックに対してクエリを実行し、1 つのレポートを作成できます。 パイプラインの期間や、すべてのプロジェクト パイプラインのエラー数など、他のメトリックを取得するための追加のクエリが提供されます。

次の図は、2022 年 9 月以降にプロジェクトに対して定義されたすべてのパイプラインの結果の概要を示しています。

次の図に示すように、[パイプライン名] ドロップダウン メニューから任意のパイプラインを選択できます。レポートが変更され、選択したパイプラインの結果の概要に注目します。

前提条件

• アクセス: 少なくとも Basic アクセス権を持つプロジェクトのメンバーである。
• 権限: 既定では、プロジェクト メンバーは Analytics にクエリを実行し、ビューを作成する権限を持ちます。
• サービスと機能の有効化と一般的なデータ追跡アクティビティに関するその他の前提条件の詳細については、「Analytics にアクセスするためのアクセス許可と前提条件」を参照してください。

サンプル クエリ

エンティティ セットの次のクエリを PipelineRuns 使用して、異なる似たパイプライン結果の概要レポートを作成できます。

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

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/PipelineRuns?%20
$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
))

置換文字列とクエリの内訳

次の文字列を実際の値に置き換えます。 置換に角かっこを {} 含めないでください。 たとえば、組織名が "Fabrikam" の場合は、 ではなく {Fabrikam}を にFabrikam置き換えます{organization}。

• {organization} - 組織名
• {project} - チーム プロジェクト名
• {startdate} - レポートを開始する日付。 形式: YYYY-MM-DDZ。 例: 2022-09-01Z は 2022 年 9 月 1 日を表します。 引用符または角かっこで囲んで、月と日付の両方に 2 桁の数字を使用しないでください。

クエリの内訳

次の表では、クエリの各部分について説明します。

(省略可能)クエリの名前を変更する

既定のクエリ ラベル Query1 の名前を、より意味のある名前に変更できます。 [ クエリ設定] ペインから新しい名前を入力するだけです。

Power Query エディターの [パイプライン] 列を展開する

レポートを作成する前に、1 つ以上のフィールドを Pipeline 含むレコードを返す列を展開します。

1. 詳細エディターを閉じます。

2. Power Query エディターから、列展開ボタンをPipeline選択し、選択されていることをPipelineName確認して、[OK] を選択します。

   

   テーブルに展開されたエンティティ Pipeline.PipelineNameが含まれるようになりました。

   

列のデータ型を変更する

Power Query エディターから列をTotalCount選択し、[変換] メニューから [データ型] を選択し、[整数] を選択します。 データ型の変更の詳細については、「 Analytics データを変換して Power BI レポートを生成する」の「列データ型の変換」を参照してください。

(省略可能)列フィールドの名前を変更する

列フィールドの名前を変更できます。 たとえば、列Pipeline.PipelineNameの名前を 、または TotalCount Total Count〗 にPipeline Name変更できます。 方法については、「列フィールドの名前を変更する」を参照してください。

クエリを閉じて変更を適用する

すべてのデータ変換が完了したら、[ホーム] メニューから [閉じる] & [適用] を選択してクエリを保存し、Power BI の [レポート] タブに戻ります。

積み上げ縦棒グラフ レポートを作成する

1. Power BI の [視覚化] で、積み上げ縦棒グラフ レポートを選択します。

   

2. 名前を変更した列を Axis に追加Pipeline.PipelineNameまたは変更しますPipeline Name。

3. 次のフィールドを指定した順序で [値] に追加し、各フィールドを右クリックし、[合計] が選択されていることを確認します。

   • SucceededCount
   • FailedCount
   • CanceledCount
   • PartiallySucceededCount.

4. レポートにスライサーを追加するには、レポートの選択を解除し、[視覚化] ウィンドウからスライサーを選択します。

   • フィールドに名前を変更した列Pipeline Nameを追加または追加Pipeline.PipelineNameします。
     

   • スライサーをリストからドロップダウン メニュー オプションに変更するには、[視覚化] ウィンドウから [ビジュアル ペイント ブラシの書式設定] アイコンを選択し、[リスト] ではなく [ドロップダウン] オプションを選択します。

     

レポートは次のように表示されます。

関連記事

• Analytics の OData クエリを作成する
• Azure Pipelines のメタデータ リファレンス
• サンプル レポートとクイック リファレンス インデックス