Representasi data historis di Analytics
Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019
Anda menentukan set entitas tertentu untuk melaporkan data historis atau membuat laporan tren. Memahami bagaimana Analitik merekam data historis penting untuk memastikan Anda dapat melacak dan melaporkan data yang menarik.
Kumpulan entitas yang mendukung pelaporan historis
Tabel berikut ini menjelaskan kumpulan entitas yang bisa Anda gunakan untuk membuat laporan historis atau tren.
EntitySet |
Deskripsi | Contoh laporan |
|---|---|---|
| WorkItemBoardSnapshot | (Komposit) Status setiap item kerja pada setiap tanggal kalender, termasuk lokasi papan Kanban. | Laporan sampel Diagram Aliran Kumulatif (CFD) |
| WorkItemRevisions | Semua revisi item kerja historis, termasuk revisi saat ini. Tidak menyertakan item kerja yang dihapus. | Mengembalikan riwayat item kerja tertentu |
| WorkItemSnapshot | (Komposit) Status setiap item kerja pada setiap tanggal kalender. | Laporan sampel tren bug |
| ParallelPipelineJobsSnapshot | (Komposit) Mendukung pemahaman tentang konsumsi alur paralel. | |
| TaskAgentPoolSizeSnapshots | (Komposit) Mendukung pemahaman tentang ukuran kumpulan, pekerjaan alur, dan konkurensi. | Grafik historis untuk kumpulan agen |
| TaskAgentRequestSnapshots | (Komposit) Mendukung pelaporan permintaan agen tugas. | |
| TestPointHistorySnapshot | (Komposit) Hasil eksekusi individu untuk Pengujian tertentu yang terkait dengan TestRun. | Laporan sampel tren eksekusi pengujian manual |
| TestResultsDaily | Agregat rekam jepret harian eksekusi TestResult , dikelompokkan menurut Pengujian. | Menguji laporan sampel tren ringkasan |
Rekam jepret menyediakan catatan nilai yang ditentukan untuk jenis entitas setiap hari. Rekaman ditulis ke Analytics sekali sehari pada saat yang sama setiap hari. Anda menggunakan rekam jepret saat ingin membuat laporan tren. Secara default, semua tabel rekam jepret dimodelkan sebagai tabel fakta rekam jepret harian. Jika Anda meminta rentang waktu, itu akan mendapatkan nilai untuk setiap hari. Rentang waktu yang lama menghasilkan sejumlah besar rekaman. Jika Anda tidak memerlukan presisi tinggi seperti itu, Anda dapat menggunakan rekam jepret mingguan atau bahkan bulanan.
Tabel fakta rekam jepret berkala
Analitik memodelkan data historis sebagai tabel fakta rekam jepret berkala. Tabel fakta berisi satu baris yang dibuat pada tengah malam untuk setiap item kerja atau jenis entitas di akhir setiap periode. Misalnya, riwayat pada periode harian dimodelkan sebagai satu baris pada tengah malam untuk setiap hari, sementara periode mingguan akan menjadi satu baris pada tengah malam hari terakhir dalam seminggu. Jika minggu belum selesai, nilai rekam jepret untuk minggu ini didasarkan pada nilai saat ini.
Butir tabel ini adalah periode, bukan item kerja individual. Ini berarti bahwa satu Item Kerja akan muncul beberapa kali, sekali untuk setiap periode historis. Memilih riwayat 30 hari terakhir akan menghasilkan satu item kerja yang muncul 30 kali dalam model data. Jika item kerja belum berubah dalam 30 hari terakhir, revisi terbaru item kerja direplikasi pada setiap hari.
Saat bekerja dengan Konektor Data Power BI dan data historis, sebaiknya gunakan bidang .Date Jika himpunan data berisi data historis, tetapi hanya nilai saat ini yang diperlukan, ini dapat disiapkan dengan memfilter Is Current.
Misalnya, jika Anda ingin memperlihatkan tabel item kerja dan nilai untuk bidang terkait yang akan Anda gunakan Is Current sebagai filter yang diatur ke True. Jika Anda ingin memperlihatkan tren item kerja berdasarkan status sebagai gantinya, Anda akan menyertakan kolom Tanggal pada Sumbu visualisasi.
Tip
Selalu gunakan opsi Tanggal saat menggunakan kolom Tanggal. Bidang Tanggal tidak dimaksudkan untuk mendukung hierarki default di Power BI.
Revisi item kerja
Setiap kali Anda memperbarui item kerja, sistem membuat revisi baru dan merekam tindakan ini di System.RevisedDate bidang , yang membuatnya berguna untuk menentukan filter riwayat. Tanggal revisi diwakili oleh RevisedDate properti (DateTime) dan RevisedDateSK (Int32). Untuk performa terbaik, gunakan kunci pengganti tanggal terakhir. Ini menunjukkan tanggal ketika revisi dibuat atau memiliki null untuk revisi aktif atau tidak lengkap.
Jika Anda menginginkan semua tanggal sejak inklusif {startDate} , tambahkan filter berikut ke kueri Anda.
RevisedDateSK eq null or RevisedDateSK gt {startDateSK}
Anda menggunakan WorkItemRevisions set entitas untuk memuat semua revisi untuk item kerja tertentu. Kueri mengembalikan semua revisi item kerja historis, termasuk revisi saat ini, untuk item kerja yang Anda filter. Ini tidak termasuk item kerja yang dihapus.
Tip
Untuk membuat laporan tren pelacakan kerja, buat atau ubah tampilan Analytics default dan tentukan jangka waktu yang menarik di tab Riwayat . Untuk mempelajari selengkapnya, lihat Membuat tampilan Analitik.
Baik tampilan Analitik maupun widget Burndown dan Burnup memungkinkan Anda mengonfigurasi filter yang mencakup himpunan data sesuai kebutuhan Anda. Anda menerapkan filter untuk mencakup data ke tim tertentu, jenis item kerja, atau backlog. Filter juga dapat berlaku untuk properti atau bidang tertentu dan nilai terkaitnya. Misalnya, Anda dapat menerapkan filter pada item kerja untuk mengembalikan hanya bug yang ditentukan untuk tim Suara Fabrikam dan yang ditandai dengan Pelanggan.
Bagaimana filter diterapkan ke data historis
Filter diterapkan ke setiap revisi item kerja. Misalnya, kita memiliki item kerja yang memiliki revisi berikut:
| Wahyu # | Tanggal Revisi | ID | Judul | Provinsi | Jalur Area | Tag |
|---|---|---|---|---|---|---|
| 1 | Jan-01 | 1001 | Bug | Baru | ||
| 2 | Jan-02 | 1001 | Bug | Baru | /Admirals | |
| 3 | Jan-10 | 1001 | Bug | Aktif | /Admirals | |
| 4 | Jan-12 | 1001 | Bug | Aktif | /Admirals | Pelanggan |
| 5 | Jan-20 | 1001 | Bug | Diselesaikan | /Admirals | Pelanggan |
| 6 (Saat ini) | Jan-28 | 1001 | Bug | Ditutup | /Admirals | Pelanggan |
Revisi terbaru (#6) adalah Revisi item kerja saat ini. Dalam tampilan Analitik, jika Anda memilih "Saat ini saja" di tab Riwayat, Anda akan mendapatkan satu baris data untuk item kerja ini, baris saat ini.
Ketika melaporkan sejarah, kita berpotensi menarik revisi 1 sampai 6 untuk pelaporan.
Katakanlah, saat membuat tampilan Analitik atau mengonfigurasi widget Burndown, Anda mengatur dua filter ini:
- Jalur Area = /Admirals
- Tag berisi Pelanggan
Menerapkan filter ini ke kumpulan revisi item kerja menghasilkan kecocokan berikut:
| Pertandingan? | Wahyu # | Tanggal Revisi | ID | Judul | Provinsi | Jalur Area | Tag |
|---|---|---|---|---|---|---|---|
 |
1 | Jan-01 | 1001 | Bug | Baru | ||
|
2 | Jan-02 | 1001 | Bug | Baru | /Admirals | |
|
3 | Jan-10 | 1001 | Bug | Aktif | /Admirals | |
 |
4 | Jan-12 | 1001 | Bug | Aktif | /Admirals | Pelanggan |
|
5 | Jan-20 | 1001 | Bug | Diselesaikan | /Admirals | Pelanggan |
|
6 (Saat ini) | Jan-28 | 1001 | Bug | Ditutup | /Admirals | Pelanggan |
Revisi 1, 2, dan 3 tidak cocok, karena revisi tersebut tidak cocok dengan filter. Item kerja di atas tidak akan muncul di himpunan data atau bagan tren Anda hingga revisi 4, atau Jan-12.
Katakanlah Anda ingin melaporkan tren Bug aktif, Anda akan membuat filter Status = Aktif. Filter tersebut akan cocok dengan revisi berikut:
| Pertandingan? | Wahyu # | Tanggal Diubah | ID | Judul | Provinsi | Jalur Area | Tag |
|---|---|---|---|---|---|---|---|
|
1 | Jan-01 | 1001 | Bug | Baru | ||
|
2 | Jan-02 | 1001 | Bug | Baru | /Admirals | |
|
3 | Jan-10 | 1001 | Bug | Aktif | /Admirals | |
|
4 | Jan-12 | 1001 | Bug | Aktif | /Admirals | Pelanggan |
|
5 | Jan-20 | 1001 | Bug | Diselesaikan | /Admirals | Pelanggan |
|
6 (Saat ini) | Jan-28 | 1001 | Bug | Ditutup | /Admirals | Pelanggan |
Filter hanya akan cocok dengan revisi 3 dan 4 item kerja, dan hanya akan menyertakan revisi Jan-10 dan Jan-12 di bagan tren Anda.
Apa artinya ini untuk Burndown atau Burnup?
Saat Anda mengonfigurasi widget Burndown atau Burnup yang memfilter Tag tertentu (misalnya, "Pelanggan"), item kerja tidak akan muncul di burndown Anda hingga tanggal Tag ditentukan untuk item kerja. Jika pada titik mana pun Tag dihapus dari item kerja, maka item kerja berasal dari burndown setelah tanggal Tag dihapus.
Beberapa telah berasumsi bahwa jika versi item kerja saat ini memiliki Tag, maka itu akan disertakan dalam burndown secara retroaktif sejak awal. Misalnya, jika versi item kerja saat ini memiliki tag "Pelanggan", diasumsikan bahwa item kerja akan disertakan dalam burndown dari titik item kerja dibuat.
Ini bukan cara kerja pemfilteran historis. Jika filter hanya diterapkan berdasarkan versi item kerja saat ini, bagan tren tidak akan berfungsi. Anda tidak dapat menghapus item dari burndown dengan menghapus Tag, atau dengan mengatur Jalur Area ke jalur area tim lain.
Catatan
Kami sedang mempertimbangkan untuk menambahkan operand "pernah" ke kriteria filter dalam tampilan dan widget Analytics seperti Burndown/Burnup. Fitur ini akan memungkinkan Anda membuat filter seperti: "State Was Ever Active". Ini berarti revisi item kerja akan cocok dengan kriteria filter jika ada revisi item kerja yang pernah memiliki Status = Aktif. Jika Anda yakin fitur ini penting, Anda dapat memilihnya di situs Komunitas Pengembang kami.
Data historis dan menjeda atau menonaktifkan Analitik
Menjeda Analitik mempertahankan data Anda tetapi menghentikan pekerjaan penahapan agar tidak memperbarui data Anda. Anda dapat melanjutkan layanan nanti dan data Anda kemudian diperbarui.
Jika administrator menonaktifkan Analytics, semua pekerjaan penahapan Analytics dinonaktifkan dan data Analytics yang disimpan dalam tabel Analytics akan dihapus. Semua data Analitik yang menangkap tren historis hilang. Ini tidak menghapus data lain yang disimpan dalam koleksi Anda. Anda tidak dapat mengurungkan tindakan ini. Setelah data historis dan data yang sedang tren dihapus, Anda tidak dapat memulihkannya. Mengaktifkan kembali Analytics tidak akan memulihkan data historis.
Dengan Analitik dinonaktifkan atau dihapus, tindakan berikut terjadi:
- Tidak ada pekerjaan penahapan yang dijalankan, dan tabel Analytics tidak akan memiliki informasi yang diperbarui.
- Data tabel dihapus, dan jika Analytics diaktifkan kembali, semua data akan diisi ulang dari awal.
Untuk mempelajari selengkapnya, lihat Menginstal atau mengaktifkan layanan Analytics.
Ringkasan
Untuk memulihkan, saat melaporkan data historis, semua filter diterapkan ke versi item kerja sebagai titik waktu historis. Item kerja akan muncul dalam tren Anda saat memenuhi kriteria filter. Mereka akan menghilang dari tren Anda ketika mereka tidak lagi memenuhi kriteria filter.
Artikel terkait
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk