Laporan sampel tren laju lolos alur
Layanan Azure DevOps | Azure DevOps Server 2022 | Azure DevOps Server 2020
Artikel ini memperlihatkan kepada Anda cara membuat laporan yang memperlihatkan tren laju pass harian alur. Laju pass alur didefinisikan sebagai persentase eksekusi alur yang berhasil ke total eksekusi alur. Ini mirip dengan bagan 'Tren laju pass' dari laporan laju pass Alur. Gambar berikut menunjukkan contoh tren tersebut.
Penting
Integrasi dan akses Power BI ke umpan OData Dari Layanan Analitik umumnya tersedia untuk Azure DevOps Services dan Azure DevOps Server 2020 dan versi yang lebih baru. Kueri sampel yang disediakan dalam artikel ini hanya valid terhadap Azure DevOps Server 2020 dan versi yang lebih baru, dan bergantung pada pratinjau v3.0 atau versi yang lebih baru. Kami mendorong Anda untuk menggunakan kueri ini dan memberi kami umpan balik.
Prasyarat
- Akses: Menjadi anggota proyek dengan setidaknya akses Dasar .
- Izin: Secara default, anggota proyek memiliki izin untuk mengkueri Analitik 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 membaca Gambaran Umum Laporan Sampel menggunakan Kueri OData dan memiliki pemahaman dasar tentang Power BI.
Contoh kueri
Anda dapat menggunakan kueri berikut dari entitas yang PipelineRuns
ditetapkan untuk membuat laporan tren tingkat pass 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 di Property
bawah nilai atau NavigationPropertyBinding Path
yang EntityType
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 laju pass untuk alur bernama
Kueri berikut mengembalikan eksekusi alur untuk alur tertentu dari tanggal mulai tertentu.
Salin dan tempel kueri Power BI berikut ini langsung ke jendela Dapatkan Kueri Kosong Data>. 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 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 siku dan gunakan dua digit untuk, 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 eksekusi alur untuk alur yang ditentukan.
and CompletedDate ge {startdate}
Mengembalikan eksekusi alur pada atau setelah tanggal yang ditentukan.
and CanceledCount ne 1
Hilangkan eksekusi alur yang dibatalkan.
)
Tutup filter()
klausa.
/groupby(
Mulai groupby()
klausa.
(CompletedOn/Date),
Kelompokkan menurut tanggal penyelesaian eksekusi alur.
aggregate
Klausa mulai aggregate
untuk semua eksekusi alur yang cocok 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 eksekusi 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 memba lagi jumlah eksekusi yang berhasil dengan jumlah total eksekusi.
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 memba lagi jumlah eksekusi yang berhasil sebagian dengan jumlah total eksekusi.
&$orderby=CompletedOn/Date asc
Urutkan hasil dalam urutan naik berdasarkan tanggal eksekusi alur.
Tren laju pass 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 alur dari URL halaman eksekusi alur.
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 Kueri Kosong Data>. 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
Loloskan tren laju, filter menurut cabang
Anda mungkin ingin melihat tren laju pass alur hanya untuk cabang tertentu. 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 Pemotong Visualisasi Power BI dan tambahkan
Branch.BranchName
ke Bidang pemotong. - Pilih cabang dari pemotong yang Anda butuhkan untuk melihat tren laju pass.
Salin dan tempel kueri Power BI berikut ini langsung ke jendela Dapatkan Kueri Kosong Data>. 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
Loloskan tren laju, filter berdasarkan alasan build
Anda mungkin ingin melihat tren laju pass alur hanya untuk Alasan Build tertentu (Manual / BatchedCI, Permintaan Pull, 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 Kueri Kosong Data>. 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
Loloskan tren laju untuk semua alur proyek
Gunakan kueri berikut untuk melihat tren laju pass untuk semua alur 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 alur Build dari pemotong yang Anda butuhkan untuk melihat tren laju pass.
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 Kueri Kosong Data>. 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.
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
danPartiallySuccessfulRate
kolom ke Nomor Desimal.'TotalCount
ke Bilangan Bujur.
(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.
Membuat laporan Bagan garis
Di Power BI, di bawah Visualisasi, pilih laporan Bagan garis.
Tambahkan
CompletedOn.Date
ke Sumbu-X. Klik kanan bidang dan pilih CompletedOn.Date.Tambahkan
PassRate
ke Sumbu-Y, dan klik kanan untuk memastikan Jumlah dipilih.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.