Bagikan melalui

Laporan sampel tren tingkat kelulusan pipeline

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Artikel ini memperlihatkan kepada Anda cara membuat laporan yang menunjukkan tren tingkat kelulusan harian dari pipeline. Tingkat keberhasilan alur didefinisikan sebagai persentase eksekusi alur yang berhasil dibagi dengan total eksekusi alur. Ini mirip dengan bagan 'Tren tingkat kelulusan' dari laporan tingkat kelulusan Pipeline. Gambar berikut menunjukkan contoh tren tersebut.

Cuplikan layar laporan Tren Tingkat Keberhasilan Eksekusi Alur Power BI.

Penting

Integrasi Power BI dan akses ke umpan OData dari Layanan Analisis umumnya tersedia untuk Azure DevOps Services dan Azure DevOps Server 2020 dan versi yang lebih baru. Kueri sampel yang disediakan dalam artikel ini hanya berlaku untuk Azure DevOps Server 2020 dan versi yang lebih baru, dan bergantung pada v3.0-preview atau versi yang lebih baru. Kami mendorong Anda untuk menggunakan kueri ini dan memberi kami umpan balik.

Kategori Persyaratan
Tingkat-tingkat akses - Anggota proyek.
- Setidaknya akses Dasar .
Izin Secara default, anggota proyek memiliki izin untuk mengkueri Analytics dan membuat tampilan. Untuk informasi selengkapnya tentang prasyarat lain mengenai pengaktifan layanan dan fitur serta aktivitas pelacakan data umum, lihat Izin dan prasyarat untuk mengakses Analitik.

Catatan

Artikel ini mengasumsikan Anda telah membaca Gambaran Umum Laporan Sampel menggunakan Kueri OData serta Anda memiliki pemahaman dasar tentang Power BI.

Contoh kueri

Anda dapat menggunakan kueri berikut dari kumpulan entitas PipelineRuns untuk membuat laporan tren tingkat kelulusan yang berbeda tetapi serupa.

Catatan

Untuk menentukan properti yang tersedia untuk tujuan filter atau laporan, lihat Referensi metadata untuk Azure Pipelines. Anda dapat memfilter kueri atau mengembalikan properti menggunakan salah satu nilai Property dalam nilai EntityType atau NavigationPropertyBinding Path yang tersedia dengan EntitySet. Masing-masing EntitySet sesuai dengan EntityType. Untuk informasi selengkapnya tentang jenis data dari setiap nilai, tinjau metadata yang disediakan untuk yang sesuai EntityType.

Tren tingkat kelulusan untuk pipeline yang ditentukan

Kueri berikut mengembalikan jalannya alur untuk alur tertentu sejak tanggal mulai tertentu.

Salin dan tempel kueri Power BI berikut ini langsung ke jendela Dapatkan Data>Kueri Kosong. Untuk informasi selengkapnya, lihat Gambaran Umum Laporan Sampel Menggunakan Kueri 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

String substitusi dan perincian kueri

Ganti string berikut dengan nilai Anda. Jangan sertakan tanda kurung {} bersama dengan pengganti Anda. Misalnya jika nama organisasi Anda adalah "Fabrikam", ganti {organization} dengan Fabrikam, bukan {Fabrikam}.

  • {organization} - Nama organisasi Anda
  • {project} - Nama proyek tim Anda
  • {pipelinename} - Nama alur Anda. Contoh: Fabrikam hourly build pipeline
  • {startdate} - Tanggal untuk memulai laporan Anda. Format: YYYY-MM-DDZ. Contoh: 2021-09-01Z mewakili 1 September 2021. Jangan sertakan dalam tanda kutip atau tanda kurung dan gunakan dua digit untuk keduanya, bulan dan tanggal.

Perincian kueri

Tabel berikut ini menjelaskan setiap bagian kueri.

Bagian kueri

Keterangan

$apply=filter(

Mulai filter() klausa.

Pipeline/PipelineName eq '{pipelinename}'

Mengembalikan jalur proses untuk alur yang spesifik.

and CompletedDate ge {startdate}

Mengembalikan jalur pipa yang dijalankan pada atau setelah tanggal yang ditentukan.

and CanceledCount ne 1

Hapus eksekusi pipeline yang dibatalkan.

)

Tutup filter() klausa.

/groupby(

Mulai groupby() klausa.

(CompletedOn/Date),

Kelompokkan berdasarkan tanggal penyelesaian jalur pemrosesan.

aggregate

Mulai klausa aggregate untuk semua jalur eksekusi yang sesuai dengan kriteria filter.

($count as TotalCount,

Hitung jumlah total eksekusi sebagai TotalCount.

SucceededCount with sum as SucceededCount ,

Hitung jumlah eksekusi yang berhasil sebagai SucceededCount.

FailedCount with sum as FailedCount,

Hitung jumlah eksekusi yang gagal sebagai FailedCount.

PartiallySucceededCount with sum as PartiallySucceededCount))

Hitung jumlah percobaan yang berhasil sebagian sebagai PartiallySucceededCount. Tutup aggregate() dan groupby() klausa.

/compute(

Awal klausa compute() .

SucceededCount mul 100.0 div TotalCount as PassRate,

Hitung PassRate untuk setiap hari dengan membagi jumlah percobaan yang berhasil dengan jumlah total percobaan.

FailedCount mul 100.0 div TotalCount as FailRate,

Hitung FailRate untuk setiap hari dengan memba lagi jumlah eksekusi yang gagal dengan jumlah total eksekusi.

PartiallySucceededCount mul 100.0 div TotalCount as PartiallySuccessfulRate)

Hitung PartiallySuccessfulRate untuk setiap hari dengan membagi jumlah percobaan yang berhasil sebagian dengan jumlah total percobaan.

&$orderby=CompletedOn/Date asc

Urutkan hasil dalam urutan naik berdasarkan tanggal eksekusi alur.

Tren tingkat kelulusan untuk ID alur

Alur dapat diganti namanya. Untuk memastikan bahwa laporan Power BI tidak rusak saat nama alur diubah, gunakan ID alur daripada nama alur. Anda dapat memperoleh ID pipa dari URL halaman jalannya pipa.

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

Kueri berikut mengembalikan eksekusi alur untuk ID alur tertentu dari tanggal mulai tertentu.

Salin dan tempel kueri Power BI berikut ini langsung ke jendela Dapatkan Data>Kueri Kosong. Untuk informasi selengkapnya, lihat Gambaran Umum Laporan Sampel Menggunakan Kueri 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

Tren tingkat kelulusan, filter menurut cabang

Anda mungkin ingin melihat tren tingkat keberhasilan alur untuk sebuah cabang tertentu saja. Untuk membuat laporan, lakukan langkah tambahan berikut bersama dengan apa yang diuraikan di bagian Ubah tipe data kolom dan Buat laporan bagan garis.

  • Perluas Branch ke .Branch.BranchName
  • Pilih Visualisasi Power BI Slicer dan tambahkan Branch.BranchName ke bidang slicer.
  • Pilih cabang dari pengiris yang ingin Anda lihat tren tingkat kelulusannya.

Salin dan tempel kueri Power BI berikut ini langsung ke jendela Dapatkan Data>Kueri Kosong. Untuk informasi selengkapnya, lihat Gambaran Umum Laporan Sampel Menggunakan Kueri 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

Tren tingkat kelulusan, filter berdasarkan alasan pembuatan

Anda mungkin ingin melihat tren tingkat keberhasilan jalur kerja hanya untuk Alasan Build tertentu (Manual / BatchedCI, Permintaan Tarik, dan sebagainya). Untuk membuat laporan, lakukan langkah tambahan berikut bersama dengan apa yang diuraikan di bagian Ubah tipe data kolom dan Buat laporan bagan garis.

  • Pilih Pemotong dari panel Visualisasi dan tambahkan RunReason ke Bidang pemotong.
  • Pilih alur dari pemotong yang Anda butuhkan untuk melihat tren laju pass.

Salin dan tempel kueri Power BI berikut ini langsung ke jendela Dapatkan Data>Kueri Kosong. Untuk informasi selengkapnya, lihat Gambaran Umum Laporan Sampel Menggunakan Kueri 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

Tren tingkat kelulusan untuk semua jalur proyek

Gunakan kueri berikut untuk melihat tren tingkat kelulusan untuk semua pipeline proyek dalam satu laporan. Untuk membuat laporan, lakukan langkah tambahan berikut bersama dengan apa yang diuraikan di bagian Ubah tipe data kolom dan Buat laporan bagan garis.

  • Perluas Pipeline ke .Pipeline.PipelineName
  • Pilih Pemotong dari panel Visualisasi, dan tambahkan bidang Pipeline.PipelineName ke Bidang pemotong.
  • Pilih pipeline Build dari slicer yang Anda perlukan untuk melihat tren tingkat keberhasilan.

Lihat Ringkasan hasil untuk semua laporan sampel alur yang telah merinci langkah serupa seperti yang diperlukan di sini.

Salin dan tempel kueri Power BI berikut ini langsung ke jendela Dapatkan Data>Kueri Kosong. Untuk informasi selengkapnya, lihat Gambaran Umum Laporan Sampel Menggunakan Kueri 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

(Opsional) Mengganti nama kueri

Anda bisa mengganti nama label kueri default, Query1, menjadi sesuatu yang lebih bermakna. Cukup masukkan nama baru dari panel Pengaturan Kueri.

Cuplikan layar opsi menu kueri Power BI, ganti nama kueri.

Perluas kolom di Editor Power Query

Sebelum membuat laporan, Anda harus memperluas kolom yang mengembalikan rekaman yang berisi beberapa bidang. Dalam hal ini, Anda akan ingin memperluas CompletedOn kolom untuk meratakannya ke CompletedOn.Date.
Untuk mempelajari cara memperluas item kerja, lihat Mengubah data Analitik untuk menghasilkan laporan Power BI.

Mengubah tipe data kolom

Dari menu Transformasi, ubah jenis data untuk kolom berikut. Untuk mempelajari caranya, lihat Mengubah jenis data kolom.

  • PassRate, FailRate dan PartiallySuccessfulRate diubah menjadi kolom Angka Desimal.
  • TotalCount ke Bilangan Bulat.

(Opsional) Mengganti nama bidang kolom

Anda dapat mengganti nama bidang kolom. Misalnya, Anda dapat mengganti nama kolom Pipeline.PipelineName menjadi Pipeline Name, atau TotalCount menjadi Total Count. Untuk mempelajari caranya, lihat Mengganti nama bidang kolom.

Tutup kueri dan terapkan perubahan Anda

Setelah Anda menyelesaikan semua transformasi data, pilih Tutup & Terapkan dari menu Beranda untuk menyimpan kueri dan kembali ke tab Laporan di Power BI.

Cuplikan layar opsi Editor Power Query Tutup dan Terapkan.

Membuat laporan bagan garis

  1. Di Power BI, di bawah Visualisasi, pilih laporan Bagan garis.

    Cuplikan layar pilihan bidang visualisasi untuk laporan grafik garis tren tingkat keberhasilan.

  2. Tambahkan CompletedOn.Date ke Sumbu-X. Klik kanan bidang dan pilih CompletedOn.Date.

  3. Tambahkan PassRate ke Sumbu-Y, dan klik kanan untuk memastikan Jumlah dipilih.

  4. Untuk mengubah judul laporan, pilih ikon Format kuas cat visual Anda dari panel Visualisasi , pilih Umum, perluas Judul, dan ganti teks yang ada.

    Gambar berikut menunjukkan laporan yang dihasilkan.

    Cuplikan layar sampel Power BI Laporan Tren Laju Lolos Eksekusi Alur.

  • Last updated on