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

  • [アーティクル]

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

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

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

すべてのパイプラインの結果の概要レポートのスクリーンショット。

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

選択したパイプラインのみの結果の概要を示すレポートのスクリーンショット。

重要

Power BI の統合と Analytics サービスの OData フィードへのアクセスは、Azure DevOps Services および Azure DevOps Server 2020 以降のバージョンで一般提供されています。 この記事で提供されるサンプル クエリは、Azure DevOps Server 2020 以降のバージョンに対してのみ有効であり、v3.0-preview 以降のバージョンによって異なります。 これらのクエリを使用し、フィードバックをお寄せください。

前提条件

  • 分析データを表示してサービスにクエリを実行するには、 Basic アクセス以上のプロジェクトのメンバーである必要があります。 既定では、すべてのプロジェクト メンバーには、Analytics のクエリと 分析ビューの定義に対するアクセス許可が付与されます。
  • サービスと機能の有効化と一般的なデータ追跡アクティビティに関するその他の前提条件については、「 Analytics にアクセスするためのアクセス許可と前提条件」を参照してください。

Note

この記事では、「 OData クエリを使用したサンプル レポートの概要」を 読み、Power BI の基本的な理解があることを前提としています。

サンプル クエリ

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

Note

フィルターまたはレポートの目的で使用可能なプロパティを決定するには、Azure Pipelines のメタデータ リファレンスを参照してください。 クエリをフィルター処理したり、 で使用可能な または 値のProperty下EntityTypeNavigationPropertyBinding Pathの値のいずれかを使用してプロパティをEntitySet返したりできます。 各 は EntitySet に EntityType対応します。 各値のデータ型の詳細については、対応する EntityTypeに提供されているメタデータを確認してください。

以下に示す Power BI クエリは、[ データの取得- 空の>クエリ ] ウィンドウに直接貼り付けることができます。 詳細については、「 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

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

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

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

クエリの内訳

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

クエリ パーツ

説明

$apply=filter(

Start filter() 句。

CompletedDate ge {startdate}

指定した日付より大きい日付に対してパイプラインが実行されます。

)

Close filter() 句。

/groupby(

Start groupby() 句/

(Pipeline/PipelineName),

パイプライン名でデータ結果をグループ化します。

aggregate(

各パイプラインの Start aggregate 句。

$count as TotalCount,

実行の合計数を次のように TotalCountカウントします。

SucceededCount with sum as SucceededCount.

成功した実行の数を次のように SucceededCountカウントします。

FailedCount with sum as FailedCount,

失敗した実行の数を次のように FailedCountカウントします。

PartiallySucceededCount with sum as PartiallySucceededCount,

部分的に成功した実行の数を次のように PartiallySucceededCountカウントします。

CanceledCount with sum as CanceledCount

取り消された実行の数を次のように CanceledCountカウントします。

))

groupby()閉じてaggregate()句を指定します。

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

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

Power BI クエリ メニュー オプションのスクリーンショット。クエリの名前を変更します。

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

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

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

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

    パイプライン列の展開メニューのスクリーンショット。

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

    Pipeline.PipelineName 列のスクリーンショット。

列のデータ型を変更する

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

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

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

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

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

[閉じて適用] オプションPower Query エディタースクリーンショット。

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

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

    すべてのパイプライン実行レポートの視覚化フィールドの選択のスクリーンショット。

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

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

    • SucceededCount
    • FailedCount
    • CanceledCount
    • PartiallySucceededCount.

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

    • フィールドに名前を変更した列Pipeline Nameを追加または追加Pipeline.PipelineNameします。
      [視覚化] ウィンドウ、スライサー、パイプライン名の追加のスクリーンショット。

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

      [視覚化] ウィンドウ、スライサー、設定オプション、ドロップダウンが選択されているスクリーンショット。

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

すべてのパイプラインの結果の概要レポートのサンプルのスクリーンショット。