Referensi metadata untuk Azure Pipelines Analytics

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

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 membuat laporan.

Catatan

Artikel ini menyediakan deskripsi entitas, properti, dan jenis enumerasi yang didukung oleh model data Analytics. Untuk mengkueri model data, lihat Membuat kueri OData untuk Analitik.

Kumpulan 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 rangkaian proses. Untuk contoh laporan, lihat Laporan sampel status kemajuan.
ParallelPipelineJobsSnapshot ParallelPipelineJobsSnapshot (Komposit) Mendukung pemahaman tentang konsumsi jalur pengolahan paralel. Untuk informasi selengkapnya tentang pengujian alur paralel, lihat Menjalankan pengujian secara paralel menggunakan tugas Visual Studio Test.
Pipelines Pipeline Properti untuk alur.
PipelineJobs PipelineJob Hasil eksekusi individual untuk Pengujian tertentu yang terkait dengan TestRun
PipelineRuns PipelineRun Informasi pelaksanaan untuk pipeline. Untuk contoh laporan, lihat Laporan Contoh Tren Tingkat Lolos Jalur.
PipelineRunActivityResults PipelineRunActivityResult Log gabungan dari semua tahapan, langkah, pekerjaan, dan tugas dalam eksekusi alur tertentu. Untuk contoh laporan, lihat contoh laporan durasi tugas pipeline.
PipelineTasks PipelineTask Properti-properti untuk tugas yang digunakan dalam jalur pipa.
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 untuk 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 Keterangan
AnalyticsUpdatedDate TanggalWaktu Tanda air yang menunjukkan waktu terakhir pembaruan data Analytics.
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 diberikan kepada repositori TFVC ketika dibuat.
RepositoriUrl RepositoryUrl String URL yang ditentukan untuk repositori saat dibuat.

Properti navigasi termasuk Project dan batasan referensial ProjectSK.

ParallelPipelineJobsSnapshot

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

  • IsHosted
  • ParallelismTag
  • SamplingDate
Nama tampilan Nama Jenis data Keterangan
Dihosting atau Dihost sendiri IsHosted Boolean Menunjukkan apakah alur paralel dijalankan pada agen yang dihosting Microsoft (True) atau dihost sendiri (False). Untuk informasi selengkapnya, lihat agen Pipeline Azure.
Gagal Menjangkau Semua Penyedia FailedToReachAllProviders Boolean Menunjukkan apakah pekerjaan yang dijalankan mencapai semua penyedia (Benar) atau tidak (Salah).
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 Ini menunjukkan apakah alur paralel adalah premium (True) atau bukan (False).
Tanggal Sampel SamplingDate TanggalWaktu Tanggal yang terkait dengan rekam jepret.

Jalur Pipa

Properti berikut ini berlaku untuk Pipeline dan kunci pengganti PipelineSKnya.

Nama tampilan Nama Jenis data Keterangan
Id Pipeline PipelineId Int32 ID yang ditetapkan ke pipeline.
Nama Pipeline PipelineName String Nama yang diberikan ke pipeline.
Versi Pipa PipelineVersion Int32 Versi yang terkait dengan rangkaian proses.
Jenis Proses Alur PipelineProcessType Disebutkan Jenis definisi alur. Nilai yang valid tercantum di bawah ini untuk PipelineProcessType.

Properti navigasi termasuk Project dan batasan referensial ProjectSK.

Anggota jenis enumerasi dari 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 kerja YAML.
Docker 3 Definisi alur Docker.

PipelineJobs

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

Properti berikut adalah valid untuk PipelineJobs dan kunci penggantinya PipelineJobSK.

Nama tampilan Nama Jenis data Keterangan
Nama Pekerjaan Lengkap Pipeline FullJobName String Nama lengkap pekerjaan pipeline.
Id Pipeline PipelineId Int32 ID yang ditetapkan ke alur tempat pekerjaan ditentukan.
Pengidentifikasi Pekerjaan Pipeline JobId String Pengidentifikasi pekerjaan yang ditetapkan ke tugas jalur saat pekerjaan itu dibuat.
Nama Pekerjaan Pipeline JobName String Nama yang ditetapkan untuk tugas alur kerja.
Nama Tahapan Saluran StageName String Nama tahap yang terkait dengan pekerjaan alur.
Atribut Strategi Pekerjaan Pipeline StrategyAttributes String Atribut yang ditentukan untuk pekerjaan alur pipa.
Pengidentifikasi Tahap StageId String Pengidentifikasi tahap yang terkait dengan pekerjaan alur.

Properti navigasi termasuk Project dan batasan referensial ProjectSK.

Untuk contoh laporan yang mengkueri jenis entitas PipelineJob, lihat contoh laporan kegagalan pada setiap tahap pipeline.

PipelineRuns

Satu kali penjalan pipa mewakili satu eksekusi penjalan pipa. Selama pelaksanaan, pipeline diproses, dan agen memproses satu atau lebih pekerjaan. Pelaksanaan pipeline mencakup pekerjaan, langkah-langkah, dan tugas. Untuk informasi selengkapnya, lihat Urutan eksekusi pipeline.

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

Nama tampilan Nama Jenis data Keterangan
Jumlah yang Dibatalkan CanceledCount Int32 Jumlah jalur pipeline yang dibatalkan.
Tanggal Selesai CompletedDate TanggalWaktu Tanggal dan waktu ketika alur menyelesaikan eksekusi.
Jumlah Kegagalan FailedCount Int32 Jumlah eksekusi jalur pipa yang berhasil.
Revisi Angka RunNumberRevision Int32 Nomor yang ditetapkan untuk menjalankan pipeline dengan eksekusi berurutan.
Jumlah Berhasil Sebagian PartiallySucceededCount Int32 Jumlah eksekusi pipeline yang berhasil sebagian.
Id Eksekusi Alur PipelineRunId Int32 Nomor yang ditetapkan ke proses pipeline.
Tanggal Dijadwalkan QueuedDate TanggalWaktu Tanggal dan waktu saat jalur pipa dijadwalkan untuk dijalankan.
Durasi Antrean dalam Detik QueueDurationSeconds Desimal Jumlah detik alur tetap dalam antrean.
Nomor Jalankan RunNumber String Nomor yang diberikan kepada jalur saat dijalankan.
Hasil Pelaksanaan RunOutcome Disebutkan Hasil yang diberikan kepada alur setelah eksekusinya selesai. Nilai yang valid tercantum di bawah ini untuk PipelineRunOutcome.
Alasan Penerapan RunReason Disebutkan Kondisi yang menyebabkan pipa berjalan. Nilai yang valid tercantum di bawah ini untuk PipelineRunReason.
Jalankan Durasi Detik RunDurationSeconds Desimal Jumlah detik yang diperlukan agar eksekusi alur selesai.
Tanggal Mulai StartedDate TanggalWaktu Tanggal dan waktu saat pengoperasian pipeline dimulai.
Jumlah Berhasil SucceededCount Int32 Jumlah eksekusi jalur pipa 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
Diantrikan Pada QueuedOn QueuedDateSK DateSK
Dimulai Pada StartedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Proyek Project ProjectSK ProjectSK

Anggota jenis enumerasi PipelineRunReason

Anggota berikut didefinisikan untuk PipelineRunReason tipe enumerasi yang menunjukkan kondisi dimana setiap tahap proses, pekerjaan, atau langkah berjalan seperti yang dijelaskan dalam Tentukan kondisi.

Nama anggota Nilai Nama tampilan
None 0 Tidak
Manual 1 Panduan
IndividualCI 2 CI Individu
BatchedCI 4 Pengelompokan Integrasi Berkelanjutan
Schedule 8 Jadwal
UserCreated 32 Dibuat oleh Pengguna
ValidateShelveset 64 Memvalidasi Shelveset
CheckInShelveset 128 Periksa Masuk Shelveset
PullRequest 256 Permintaan Penarikan
PipelineRunCompletion 512 Penyelesaian Pembangunan

Anggota jenis enumerasi PipelineRunOutcome

Anggota berikut didefinisikan untuk PipelineRunOutcome jenis enumerasi yang menunjukkan hasil pemrosesan pipeline.

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

HasilAktivitasPipelineRun

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 tanggal Kalender, Proyek, dan metadata Pengguna.

Nama tampilan Nama Jenis data Keterangan
Jumlah yang Ditinggalkan AbandonedCount Int32 Jumlah pengoperasian alur yang ditandai sebagai diabaikan.
Tanggal Selesai Aktivitas ActivityCompletedDate TanggalWaktu Tanggal dan waktu ketika proses alur kerja selesai.
Durasi Aktivitas Detik ActivityDurationSeconds Desimal Jumlah total detik alur berada dalam antrean dan dijalankan.
Tanggal Mulai Aktivitas ActivityStartedDate TanggalWaktu Tanggal dan waktu ketika pipeline dijalankan dimulai.
Jumlah yang Dibatalkan CanceledCount Int32 Jumlah jalur pipeline yang dibatalkan.
Jumlah Kegagalan FailedCount Int32 Jumlah proses pipeline yang gagal.
Jenis Aktivitas Alur ActivityType Disebutkan Jenis aktivitas pipa. Nilai yang valid tercantum di bawah ini untuk PipelineActivityType.
Id Eksekusi Alur PipelineRunId Int32 Nomor yang diberikan kepada jalur saat dijalankan.
Hasil Eksekusi Alur PipelineRunOutcome Disebutkan Hasil yang diberikan kepada alur setelah eksekusinya selesai. Nilai yang valid tercantum di bawah PipelineRunOutcome.
Waktu Mulai Relatif Berdasarkan Detik Pekerjaan RelativeStartTimeFromJobSeconds Int32 Jumlah detik yang berlalu sejak awal pekerjaan.
Waktu Mulai Relatif dari Detik Fase RelativeStartTimeFromStageSeconds Int32 Jumlah detik yang berlalu sejak awal tahap.
Waktu Mulai Relatif Dari Detik Eksekusi RelativeStartTimeFromRunSeconds Int32 Jumlah detik yang berlalu dari saat run dilakukan.
Jumlah yang Dilewati SkippedCount Int32 Jumlah pemrosesan pipeline yang dilewati.
Jumlah Berhasil SucceededCount Int32 Jumlah eksekusi jalur pipa yang berhasil.
Berhasil dengan Jumlah Masalah Tercatat SucceededWithIssuesCount Int32 Jumlah eksekusi pipeline yang berhasil sebagian.
Nama Tampilan Tugas TaskDisplayName String Nama tugas yang dijalankan dalam proses pipeline.
Lokasi Log Tugas TaskLogPath String Jalur berkas log yang dihasilkan oleh suatu tugas.
Hasil Tugas TaskOutcome Kustom Hasil tugas yang dijalankan.

Untuk contoh laporan yang meminta jenis entitas PipelineRunActivityResult, lihat contoh laporan tren durasi tugas pipeline.

Properti navigasi menyertakan properti yang tercantum dalam tabel berikut ini.

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

Anggota-anggota tipe enumerasi PipelineActivityType

Anggota berikut didefinisikan untuk tipe 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 Keterangan
Id Definisi Tugas TaskDefinitionId GUID GUID yang ditetapkan ke tugas pipeline.
Versi Tugas Definisi TaskDefinitionVersion String Versi yang ditetapkan untuk tugas pipeline.

Properti navigasi termasuk Project dan batasan referensial ProjectSK.

CuplikanUkuranPoolAgenTugas

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

Nama tampilan Nama properti Jenis data Keterangan
Hitungan Online OnlineCount Int32 Jumlah agen online di grup agen saat tugas dijalankan.
Jumlah Offline OfflineCount Int32 Jumlah agen dengan status offline di kumpulan agen ketika tugas dijalankan.
ID Pool PoolId Int32 Nomor yang ditetapkan ke kumpulan agen.
Tanggal Sampel SamplingDate TanggalWaktu Tanggal dan waktu ketika ukuran kumpulan diciutkan.

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

CuplikanPermintaanAgenTugas

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

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

Nama tampilan Nama Jenis data Keterangan
Pembangunan Dalam Antrian IsQueued Boolean Menunjukkan apakah build sedang dalam antrian (True) atau tidak dalam antrian (False).
Pembangunan 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 TanggalWaktu Tanggal-waktu ketika permintaan agen tugas telah selesai berjalan.
FinishedDateSK Int32 Tanggal ketika permintaan agen tugas selesai dijalankan, dinyatakan sebagai YYYYMMDD di zona waktu yang ditentukan untuk organisasi.
Tanggal Dijadwalkan QueuedDate TanggalWaktu Tanggal-waktu ketika permintaan agen tugas diantrekan.
QueuedDateSK Int32 Tanggal permintaan agen tugas diantrekan, dinyatakan seperti YYYYMMDD di zona waktu yang ditentukan untuk organisasi.
Durasi Antrean dalam Detik QueueDurationSeconds Desimal Jumlah detik permintaan penugasan agen tetap dalam antrean sebelum seorang agen ditugaskan.
ID Pool 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 penugasan.
Jam Contoh SamplingHour Int32 Nomor yang diberikan pada jam saat permintaan diterima.
Waktu Sampel SamplingTime TanggalWaktu Tanggal-waktu ketika permintaan agen tugas diterima.
Tanggal Mulai StartedDate TanggalWaktu Tanggal-waktu ketika permintaan agen tugas dijalankan.
StartedDateSK Int32 Tanggal permintaan agen tugas memulai eksekusi, dinyatakan seperti YYYYMMDD di zona waktu yang ditentukan untuk organisasi.

Properti navigasi menyertakan properti 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
Diantrikan Pada QueuedOn QueuedDateSK DateSK
Pipeline Pipeline PipelineSK PipelineSK
Proyek Project ProjectSK ProjectSK
Dimulai Pada StartedOn QueuedDateSK DateSK

Konten terkait

  • Last updated on