Referensi metadata untuk Azure Pipelines Analytics
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 membuat 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 miliki informasi lebih lanjut. 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 | EntityType | 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 informasi selengkapnya tentang pengujian alur paralel, lihat Menjalankan pengujian secara paralel menggunakan tugas Visual Studio Test. |
Pipelines | Pipa | Properti untuk alur. |
PipelineJobs | PipelineJob | Hasil eksekusi individual untuk Pengujian tertentu yang terkait dengan TestRun |
PipelineRuns | PipelineRun | Informasi eksekusi untuk alur. Untuk contoh laporan, lihat Laporan sampel tren laju lolos 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 | Keterangan |
---|---|---|---|
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 ProjectSK
referensialnya .
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 Azure Pipelines. |
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 | 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 PipelineSK
penggantinya .
Nama tampilan | Nama | Jenis data | Keterangan |
---|---|---|---|
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 ProjectSK
referensialnya .
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 informasi selengkapnya, lihat Menentukan pekerjaan di alur Anda.
Properti berikut ini valid untuk PipelineJobs dan kunci penggantinya PipelineJobSK
.
Nama tampilan | Nama | Jenis data | Keterangan |
---|---|---|---|
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 ProjectSK
referensialnya .
Untuk contoh laporan 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- langkah, dan tugas. Untuk informasi selengkapnya, lihat Urutan eksekusi alur.
Properti berikut ini valid untuk jenis entitas PipelineRun dan kunci penggantinya PipelineRunSK
.
Nama tampilan | Nama | Jenis data | Keterangan |
---|---|---|---|
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 |
Decimal | Jumlah detik alur tetap dalam antrean. |
Nomor Eksekusi | RunNumber |
String | Nomor yang ditetapkan ke eksekusi alur saat dijalankan. |
Jalankan Hasil | RunOutcome |
Disebutkan | Hasil yang ditetapkan ke alur setelah selesai 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. |
Jalankan Durasi Detik | RunDurationSeconds |
Decimal | Jumlah detik yang diperlukan agar eksekusi alur selesai. |
Tanggal Mulai | StartedDate |
DateTime | Tanggal dan waktu ketika eksekusi alur dimulai. |
Jumlah Berhasil | SucceededCount |
Int32 | Jumlah eksekusi alur yang berhasil. |
Total Durasi Detik | TotalDurationSeconds |
Decimal | Jumlah total detik alur berada dalam antrean dan dijalankan. |
Properti navigasi
Properti navigasi berikut ini didukung.
Nama tampilan | Nama | -Batasan referensial | Properti yang dirujuk |
---|---|---|---|
Cabang | Branch |
BranchSK |
BranchSK |
Selesai Pada | CompletedOn |
CompletedDateSK |
DateSK |
Diantrekan Pada | QueuedOn |
QueuedDateSK |
DateSK |
Dimulai Pada | StartedOn |
QueuedDateSK |
DateSK |
Pipa | Pipeline |
PipelineSK |
PipelineSK |
Proyek | 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 |
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 |
Succeed |
2 | Berhasil |
PartiallySucceeded |
4 | Berhasil Sebagian |
Failed |
6 | Gagal |
Canceled |
32 | Canceled |
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 tanggal Kalender, Proyek, dan metadata Pengguna.
Nama tampilan | Nama | Jenis data | Keterangan |
---|---|---|---|
Jumlah yang Ditinggalkan | AbandonedCount |
Int32 | Jumlah eksekusi alur yang ditandai sebagai ditinggalkan. |
Tanggal Selesai Aktivitas | ActivityCompletedDate |
DateTime | Tanggal dan waktu ketika eksekusi alur selesai dieksekusi. |
Durasi Aktivitas Detik | ActivityDurationSeconds |
Decimal | 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 | Nomor yang ditetapkan ke eksekusi alur saat dijalankan. |
Hasil Eksekusi Alur | PipelineRunOutcome |
Disebutkan | Hasil yang ditetapkan ke alur setelah selesai eksekusinya. 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 |
Adat | Hasil tugas yang dijalankan. |
Untuk contoh laporan yang mengkueri jenis entitas PipelineRunActivityResult , lihat Laporan sampel tren durasi tugas alur.
Properti navigasi
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 |
Pipa | 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 Aktif | PipelineRunCompletedOn |
PipelineRunCompletedDateSK |
DateSK |
Eksekusi Alur Dimulai Pada | PipelineRunStartedOn |
PipelineRunStartedDateSK |
DateSK |
Proyek | Project |
ProjectSK |
ProjectSK |
Anggota jenis enumerasi PipelineActivityType
Anggota berikut didefinisikan untuk PipelineActivityType
jenis enumerasi.
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 PipelineTaskSK
penggantinya .
Nama tampilan | Nama | Jenis data | Keterangan |
---|---|---|---|
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 ProjectSK
referensialnya .
TaskAgentPoolSizeSnapshots
Properti berikut ini valid untuk kumpulan entitas TaskAgentPoolSizeSnapshots dan kunci SamplingDate
penggantinya .
Nama tampilan | Nama properti | Jenis data | Keterangan |
---|---|---|---|
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 ketika 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 | Keterangan |
---|---|---|---|
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 di zona waktu yang ditentukan untuk organisasi. |
|
Durasi Antrean Detik | QueueDurationSeconds |
Decimal | 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 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 |
Diantrekan Pada | QueuedOn |
QueuedDateSK |
DateSK |
Pipa | Pipeline |
PipelineSK |
PipelineSK |
Proyek | Project |
ProjectSK |
ProjectSK |
Dimulai Pada | StartedOn |
QueuedDateSK |
DateSK |