Bagikan melalui

Referensi metadata untuk Azure Pipelines Analytics

  • Artikel

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Layanan Analytics mengumpulkan alur dan aktivitas pengujian yang dihasilkan melalui Azure Pipelines. Artikel ini menjelaskan properti yang dapat Anda gunakan untuk membuat laporan Analytics untuk alur. Anda menggunakan kombinasi properti untuk memfilter kueri, mengagregasi data, atau menyusun laporan.

Catatan

Deskripsi entitas, properti, dan jenis enumerasi yang didukung oleh model data Analytics disediakan. Ini adalah draf awal. Harap berikan umpan balik tentang area yang ingin Anda dapatkan informasi lebih lanjut. Untuk mengkueri model data, lihat Membuat kueri OData untuk Analitik.

Set entitas dan jenis entitas

Tabel berikut ini meringkas jenis entitas dan kumpulan entitas yang mendukung Azure Pipelines. Semua jenis entitas/set entitas tersedia dengan versi pratinjau Analytics v4.0 . Versi analitik v3.0-preview tidak mendukung rekam jepret.

EntitySet JenisEntitas Deskripsi
Cabang Cabang Informasi dasar tentang cabang yang digunakan dalam pengujian atau alur. Untuk contoh laporan, lihat Laporan sampel status kemajuan.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (Komposit) Mendukung pemahaman tentang konsumsi alur paralel. Untuk mempelajari selengkapnya tentang pengujian alur paralel, lihat Menjalankan pengujian secara paralel menggunakan tugas Visual Studio Test.
Pipelines Alur Properti untuk alur.
PipelineJobs PipelineJob Hasil eksekusi individu untuk Pengujian tertentu yang terkait dengan TestRun
PipelineRuns PipelineRun Informasi eksekusi untuk alur. Untuk laporan sampel, lihat Laporan sampel tren laju pass rate alur.
PipelineRunActivityResults PipelineRunActivityResult Log gabungan dari semua tahapan, langkah, pekerjaan, dan tugas dalam eksekusi alur tertentu. Untuk contoh laporan, lihat Laporan sampel durasi tugas alur.
PipelineTasks PipelineTask Properti untuk tugas yang digunakan dalam alur.
TaskAgentPoolSizeSnapshots TaskAgentPoolSizeSnapshot (Komposit) Mendukung pemahaman tentang ukuran kumpulan, pekerjaan alur, dan konkurensi. Grafik Historis untuk kumpulan agen menggambarkan bagaimana kumpulan entitas ini dapat digunakan.
TaskAgentRequestSnapshots TaskAgentRequestSnapshot (Komposit) Mendukung pelaporan permintaan agen tugas.

Cabang

Properti berikut ini valid untuk kumpulan entitas Cabang . Kunci pengganti yang terkait dengan Cabang termasuk BranchSK dan ProjectSK.

Nama tampilan Nama Jenis data Deskripsi
AnalyticsUpdatedDate DateTime Marka air yang menunjukkan terakhir kali data Analytics diperbarui.
Nama Cabang BranchName String Nama yang ditetapkan ke cabang saat dibuat.
Id Repositori RepositoryId String Nomor yang ditetapkan ke repositori saat dibuat.
Repositori Vsts Id RepositoryVstsId String Nomor yang ditetapkan ke repositori TFVC saat dibuat.
RepositoriUrl RepositoryUrl String URL yang ditentukan untuk repositori saat dibuat.

Properti navigasi termasuk Project dan batasan ProjectSKreferensialnya.

ParallelPipelineJobsSnapshot

Properti berikut ini valid untuk kumpulan entitas ParallelPipelineJobsSnapshot . Kunci referensi meliputi:

  • IsHosted
  • ParallelismTag
  • SamplingDate
Nama tampilan Nama Jenis data Deskripsi
Dihosting atau Dihost sendiri IsHosted Boolean Menunjukkan apakah alur paralel dijalankan pada agen yang dihosting Microsoft (True) atau dihost sendiri (False). Untuk mempelajari selengkapnya, lihat Agen Azure Pipelines.
Gagal Menjangkau Semua Penyedia FailedToReachAllProviders Boolean Menunjukkan apakah pekerjaan yang dijalankan mencapai semua penyedia (Benar) atau tidak (False).
Jumlah Pekerjaan Alur Paralel TotalCount Int32 Jumlah pekerjaan yang dijalankan sebagai bagian dari rekam jepret.
Jumlah Menit Alur Paralel TotalMinutes Int32 Jumlah menit yang diambil untuk menjalankan rekam jepret.
Jenis Paralelisme ParallelismTag String Tag yang menunjukkan jenis paralelisme yang terkait dengan rekam jepret pekerjaan.
Jenis Premium IsPremium Boolean Menunjukkan apakah alur paralel premium (True) atau tidak (False).
Tanggal Sampel SamplingDate DateTime Tanggal yang terkait dengan rekam jepret.

Pipelines

Properti berikut ini valid untuk Alur dan kunci PipelineSKpenggantinya.

Nama tampilan Nama Jenis data Deskripsi
Id Alur PipelineId Int32 ID yang ditetapkan ke alur.
Nama Alur PipelineName String Nama yang ditetapkan ke alur.
Versi Alur PipelineVersion Int32 Versi yang terkait dengan alur.
Jenis Proses Alur PipelineProcessType Disebutkan Jenis definisi alur. Nilai yang valid tercantum di bawah ini untuk PipelineProcessType.

Properti navigasi termasuk Project dan batasan ProjectSKreferensialnya.

Anggota jenis enumerasi PipelineProcessType

Anggota berikut didefinisikan untuk PipelineProcessType jenis enumerasi yang menunjukkan metode yang digunakan untuk menentukan alur.

Nama anggota Nilai Definisi
Designer 1 Definisi alur klasik.
Yaml 2 Definisi alur YAML.
Docker 3 Definisi alur Docker.

PipelineJobs

Pekerjaan alur adalah serangkaian langkah yang berjalan secara berurutan sebagai unit. Pekerjaan adalah unit kerja terkecil yang dapat Anda jadwalkan untuk dijalankan. Alur diatur di sekitar pekerjaan, dan setiap alur memiliki setidaknya satu pekerjaan. Untuk mempelajari selengkapnya, lihat Menentukan pekerjaan di alur Anda.

Properti berikut ini valid untuk PipelineJobs dan kunci penggantinya PipelineJobSK .

Nama tampilan Nama Jenis data Deskripsi
Nama Pekerjaan Lengkap Alur FullJobName String Nama lengkap pekerjaan alur.
Id Alur PipelineId Int32 ID yang ditetapkan ke alur tempat pekerjaan ditentukan.
Pengidentifikasi Pekerjaan Alur JobId String Pengidentifikasi pekerjaan yang ditetapkan ke pekerjaan alur saat dibuat.
Nama Pekerjaan Alur JobName String Nama yang ditetapkan ke pekerjaan alur.
Nama Tahap Alur StageName String Nama tahap yang terkait dengan pekerjaan alur.
Atribut Strategi Pekerjaan Alur StrategyAttributes String Atribut yang ditentukan untuk pekerjaan alur.
Pengidentifikasi Tahap StageId String Pengidentifikasi tahap yang terkait dengan pekerjaan alur.

Properti navigasi termasuk Project dan batasan ProjectSKreferensialnya.

Untuk laporan sampel yang mengkueri jenis entitas PipelineJob , lihat Laporan sampel kegagalan bijak tahap alur.

PipelineRuns

Eksekusi alur mewakili satu eksekusi alur. Selama eksekusi, alur diproses, dan agen memproses satu atau beberapa pekerjaan. Eksekusi alur mencakup pekerjaan, langkah, dan tugas. Untuk mempelajari selengkapnya, lihat Urutan eksekusi alur.

Properti berikut ini valid untuk jenis entitas PipelineRun dan kunci penggantinya PipelineRunSK .

Nama tampilan Nama Jenis data Deskripsi
Jumlah yang Dibatalkan CanceledCount Int32 Jumlah eksekusi alur yang dibatalkan.
Tanggal Selesai CompletedDate DateTime Tanggal dan waktu ketika alur menyelesaikan eksekusi.
Jumlah Gagal FailedCount Int32 Jumlah eksekusi alur yang berhasil.
Revisi Angka RunNumberRevision Int32 Angka yang ditetapkan ke eksekusi alur dengan eksekusi berurutan.
Jumlah Berhasil Sebagian PartiallySucceededCount Int32 Jumlah eksekusi alur yang sebagian berhasil.
Id Eksekusi Alur PipelineRunId Int32 Nomor yang ditetapkan ke eksekusi alur.
Tanggal Antrean QueuedDate DateTime Tanggal dan waktu saat alur diantrekan untuk dijalankan.
Durasi Antrean Detik QueueDurationSeconds Desimal Jumlah detik alur tetap dalam antrean.
Nomor Eksekusi RunNumber String Angka yang ditetapkan ke eksekusi alur saat dijalankan.
Jalankan Hasil RunOutcome Disebutkan Hasil yang ditetapkan ke alur setelah menyelesaikan eksekusinya. Nilai yang valid tercantum di bawah ini untuk PipelineRunOutcome.
Alasan Eksekusi RunReason Disebutkan Kondisi yang menyebabkan alur berjalan. Nilai yang valid tercantum di bawah ini untuk PipelineRunReason.
Durasi Eksekusi Detik RunDurationSeconds Desimal Jumlah detik yang diperlukan untuk menyelesaikan eksekusi alur.
Tanggal Dimulai StartedDate DateTime Tanggal dan waktu ketika eksekusi alur dimulai.
Jumlah berhasil SucceededCount Int32 Jumlah eksekusi alur yang berhasil.
Total Durasi Detik TotalDurationSeconds Desimal Jumlah total detik alur berada dalam antrean dan dijalankan.

Properti navigasi berikut ini didukung.

Nama tampilan Nama -Batasan referensial Properti yang dirujuk
Cabang Branch BranchSK BranchSK
Selesai Pada CompletedOn CompletedDateSK DateSK
Antrean Aktif QueuedOn QueuedDateSK DateSK
Dimulai Pada StartedOn QueuedDateSK DateSK
Alur Pipeline PipelineSK PipelineSK
Project Project ProjectSK ProjectSK

Anggota jenis enumerasi PipelineRunReason

Anggota berikut didefinisikan untuk PipelineRunReason jenis enumerasi yang menunjukkan kondisi di mana setiap tahap alur, pekerjaan, atau langkah berjalan seperti yang dijelaskan dalam Tentukan kondisi.

Nama anggota Nilai Nama tampilan
None 0 Tidak ada
Manual 1 Manual
IndividualCI 2 CI Individu
BatchedCI 4 Batched CI
Schedule 8 Jadwal
UserCreated 32 Pengguna Dibuat
ValidateShelveset 64 Memvalidasi Shelveset
CheckInShelveset 128 Check In Shelveset
PullRequest 256 Permintaan Pull
PipelineRunCompletion 512 Penyelesaian Build

Anggota jenis enumerasi PipelineRunOutcome

Anggota berikut didefinisikan untuk PipelineRunOutcome jenis enumerasi yang menunjukkan hasil eksekusi alur.

Nama anggota Nilai Nama tampilan
None 0 Tidak ada
Succeed 2 Berhasil
PartiallySucceeded 4 Berhasil Sebagian
Failed 6 Gagal
Canceled 32 Batal

PipelineRunActivityResults

Properti berikut ini valid untuk kumpulan entitas PipelineRunActivityResults dan kunci penggantinya PipelineRunActivityResultSK .

Banyak properti berbasis tanggal atau berbasis pengguna. Properti ini dikaitkan dengan kumpulan entitas CalendarDate dan Pengguna yang dijelaskan dalam referensi metadata Tanggal kalender, Proyek, dan Pengguna.

Nama tampilan Nama Jenis data Deskripsi
Jumlah yang Ditinggalkan AbandonedCount Int32 Jumlah eksekusi alur yang ditandai sebagai ditinggalkan.
Tanggal Selesai Aktivitas ActivityCompletedDate DateTime Tanggal dan waktu saat eksekusi alur selesai dieksekusi.
Durasi Aktivitas Detik ActivityDurationSeconds Desimal Jumlah total detik alur berada dalam antrean dan dijalankan.
Tanggal Mulai Aktivitas ActivityStartedDate DateTime Tanggal-waktu saat eksekusi alur dimulai.
Jumlah yang Dibatalkan CanceledCount Int32 Jumlah eksekusi alur yang dibatalkan.
Jumlah Gagal FailedCount Int32 Jumlah eksekusi alur yang gagal.
Jenis Aktivitas Alur ActivityType Disebutkan Jenis aktivitas alur. Nilai yang valid tercantum di bawah ini untuk PipelineActivityType.
Id Eksekusi Alur PipelineRunId Int32 Angka yang ditetapkan ke eksekusi alur saat dijalankan.
Hasil Eksekusi Alur PipelineRunOutcome Disebutkan Hasil yang ditetapkan ke alur setelah selesai dieksekusi. Nilai yang valid tercantum di bawah PipelineRunOutcome.
Waktu Mulai Relatif Dari Detik Pekerjaan RelativeStartTimeFromJobSeconds Int32 Jumlah detik yang berlalu sejak awal pekerjaan.
Waktu Mulai Relatif Dari Detik Tahap RelativeStartTimeFromStageSeconds Int32 Jumlah detik yang berlalu sejak awal tahap.
Waktu Mulai Relatif Dari Detik Eksekusi RelativeStartTimeFromRunSeconds Int32 Jumlah detik yang berlalu dari saat eksekusi dijalankan.
Jumlah yang Dilewati SkippedCount Int32 Jumlah eksekusi alur yang dilewati.
Jumlah Berhasil SucceededCount Int32 Jumlah eksekusi alur yang berhasil.
Berhasil dengan Jumlah Masalah SucceededWithIssuesCount Int32 Jumlah eksekusi alur yang sebagian berhasil.
Nama Tampilan Tugas TaskDisplayName String Nama tugas yang dijalankan dalam eksekusi alur.
Jalur Log Tugas TaskLogPath String Jalur file log yang dihasilkan oleh tugas.
Hasil Tugas TaskOutcome Kustom Hasil tugas yang dijalankan.

Untuk contoh laporan yang mengkueri jenis entitas PipelineRunActivityResult , lihat Laporan sampel tren durasi tugas alur.

Properti navigasi menyertakan yang tercantum dalam tabel berikut ini.

Nama Tampilan Nama Batasan referensial Properti yang dirujuk
Aktivitas Dimulai Pada ActivityStartedOn ActivityStartedDateSK DateSK
Cabang Branch BranchSK BranchSK
Alur Pipeline PipelineSK PipelineSK
Tugas Alur PipelineTask PipelineTaskSK PipelineTaskSK
Pekerjaan Alur PipelineJob PipelineJobSK PipelineJobSK
Eksekusi Alur Diantrekan Pada PipelineRunQueuedOn PipelineRunQueuedDateSK DateSK
Eksekusi Alur Dimulai Pada PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Eksekusi Alur Selesai Pada PipelineRunCompletedOn PipelineRunCompletedDateSK DateSK
Eksekusi Alur Dimulai Pada PipelineRunStartedOn PipelineRunStartedDateSK DateSK
Project Project ProjectSK ProjectSK

Jenis anggota yang dijumlahkan PipelineActivityType

Anggota berikut didefinisikan untuk jenis enumerasi PipelineActivityType .

Nama anggota Nilai Nama tampilan
Task 0 Tugas
Approval 1 Persetujuan
AgentWait 2 Agen Tunggu

PipelineTasks

Properti berikut ini valid untuk kumpulan entitas PipelineTasks dan kunci PipelineTaskSKpenggantinya.

Nama tampilan Nama Jenis data Deskripsi
Id Definisi Tugas TaskDefinitionId GUID GUID yang ditetapkan ke tugas alur.
Versi Definisi Tugas TaskDefinitionVersion String Versi yang ditetapkan ke tugas alur.

Properti navigasi termasuk Project dan batasan ProjectSKreferensialnya.

TaskAgentPoolSizeSnapshots

Properti berikut ini valid untuk kumpulan entitas TaskAgentPoolSizeSnapshots dan kunci SamplingDatepenggantinya .

Nama tampilan Nama properti Jenis data Deskripsi
Jumlah Online OnlineCount Int32 Jumlah agen online di kumpulan agen saat tugas dijalankan.
Jumlah Offline OfflineCount Int32 Jumlah agen offline di kumpulan agen saat tugas dijalankan.
Id Kumpulan PoolId Int32 Nomor yang ditetapkan ke kumpulan agen.
Tanggal Sampel SamplingDate DateTime Tanggal dan waktu ketika ukuran kumpulan diciutkan.

Untuk contoh laporan yang dibangun dari entitas TaskAgentPoolSizeSnapshot , lihat Grafik historis untuk kumpulan agen (Pratinjau).

TaskAgentRequestSnapshots

Kumpulan agen dialokasikan saat tugas dijalankan. Kumpulan entitas TaskAgentRequestSnapshots menangkap data yang terkait dengan permintaan agen tugas.

Properti berikut ini valid untuk jenis entitas TaskAgentRequestSnapshot dan kunci SamplingTime penggantinya dan SamplingDateSK.

Nama tampilan Nama Jenis data Deskripsi
Bangun Antrean IsQueued Boolean Menunjukkan apakah build diantrekan (True) atau tidak diantrekan (False).
Membangun Berjalan IsRunning Boolean Menunjukkan apakah build berjalan (True) atau tidak berjalan (False).
Dihosting atau Dihost sendiri IsHosted Boolean Menunjukkan apakah agen yang ditetapkan ke tugas dihosting (True) atau dihost sendiri (False).
Tanggal Selesai Pekerjaan FinishedDate DateTime Tanggal-waktu ketika permintaan agen tugas selesai berjalan.
FinishedDateSK Int32 Tanggal permintaan agen tugas selesai berjalan, dinyatakan seperti YYYYMMDD di zona waktu yang ditentukan untuk organisasi.
Tanggal Antrean QueuedDate DateTime Tanggal-waktu ketika permintaan agen tugas diantrekan.
QueuedDateSK Int32 Tanggal permintaan agen tugas diantrekan, dinyatakan seperti YYYYMMDD dalam zona waktu yang ditentukan untuk organisasi.
Durasi Antrean Detik QueueDurationSeconds Desimal Jumlah detik permintaan agen tugas tetap dalam antrean sebelum agen ditetapkan.
Id Kumpulan PoolId Int32 Nomor yang ditetapkan ke kumpulan agen yang ditetapkan ke permintaan agen tugas.
Jenis Alur PipelineType String Jenis alur yang berisi permintaan agen tugas.
Id Permintaan RequestId Int64 Nomor yang ditetapkan ke permintaan agen tugas.
Jam Sampel SamplingHour Int32 Nomor yang ditetapkan ke jam ketika permintaan diterima.
Waktu Sampel SamplingTime DateTime Tanggal-waktu ketika permintaan agen tugas diterima.
Tanggal Mulai StartedDate DateTime Tanggal-waktu ketika permintaan agen tugas dijalankan.
StartedDateSK Int32 Tanggal permintaan agen tugas memulai eksekusi, dinyatakan seperti YYYYMMDD dalam zona waktu yang ditentukan untuk organisasi.

Properti navigasi menyertakan yang tercantum dalam tabel berikut ini.

Nama tampilan Nama Batasan referensial -Properti yang dirujuk
Cabang Branch BranchSK BranchSK
Selesai Pada CompletedOn CompletedDateSK DateSK
Waktu Akhir Pekerjaan FinishedOn FinishedDateSK DateSK
Diantrekan Pada QueuedOn QueuedDateSK DateSK
Alur Pipeline PipelineSK PipelineSK
Project Project ProjectSK ProjectSK
Dimulai Pada StartedOn QueuedDateSK DateSK