Connect ke sumber data Jira - Amazon Managed Grafana

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Connect ke sumber data Jira

Dapatkan gambaran keseluruhan proses pengembangan Anda dengan menggabungkan data masalah dari Jira dengan data kinerja aplikasi dari sumber lain.

catatan

Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat Kelola akses ke plugin Enterprise.

Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat Perluas ruang kerja Anda dengan plugin.

  • Buat anotasi berdasarkan pembuatan atau resolusi masalah, untuk melihat hubungan antara masalah dan metrik.

  • Lacak statistik Jira yang terperinci, seperti waktu rata-rata untuk menyelesaikan dan mengeluarkan throughput.

Untuk menggunakan sumber data Jira, Anda memerlukan akun Atlassian dengan akses ke proyek Jira.

Keterbatasan yang Sudah Diketahui

Jenis bidang khusus dari addons Jira mungkin tidak didukung.

Menambahkan sumber data

  1. Buka konsol Grafana di ruang kerja Grafana yang Dikelola Amazon dan pastikan Anda masuk.

  2. Di menu samping di bawah Konfigurasi (ikon roda gigi), pilih Sumber Data.

  3. Pilih Tambahkan sumber data.

    catatan

    Jika Anda tidak melihat link Sumber Data di menu samping Anda, itu berarti bahwa pengguna Anda saat ini tidak memiliki Admin peran.

  4. Pilih JIRA dari daftar sumber data.

  5. Masukkan informasi berikut:

    • Untuk Nama, masukkan nama untuk sumber data Jira ini.

    • Untuk URL, masukkan URL root untuk instance Atlassian Anda, seperti. https://bletchleypark.atlassian.net

    • Untuk Pengguna, masukkan alamat email untuk akun pengguna/layanan.

    • Untuk token API, masukkan token API yang dibuat untuk pengguna.

Kueri sumber data Jira

Dari Editor Kueri Jira Anda dapat memilih bidang dan masalah kueri.

Sumber data Jira meminta Jira untuk masalah, yang dapat mewakili bug, cerita pengguna, tiket dukungan, atau tugas lain di Jira

Filter dan lihat masalah
  1. Pilih Bidang pilih dropdown dan gunakan type-ahead untuk memilih dari salah satu bidang di instance Jira Anda, termasuk bidang khusus. Beberapa bidang untuk dicoba:

    • Ringkasan — Nama masalah

    • Nama Epik — Epi yang menjadi milik suatu masalah

    • Perkiraan Titik Cerita — Jumlah poin cerita yang diperkirakan tim untuk suatu masalah

  2. Filter atau urutkan masalah. Untuk melakukannya, masukkan ekspresi JQL yang valid untuk memfilter atau mengurutkan masalah berdasarkan bidangnya seperti Project, Assignee, atau Sprint dengan bahasa query Atlassian JQL.

Dari sini, Anda dapat menampilkan data Anda dalam tabel atau menggunakan transformasi Grafana untuk memanipulasi data masalah itu, menjalankan perhitungan, atau mengubah data menjadi grafik deret waktu. Untuk informasi selengkapnya, lihat Menerapkan transformasi.

Kueri deret waktu

Untuk menampilkan data deret waktu, pilih bidang Tanggal bersama dengan bidang numerik, lalu beralih ke visualisasi grafik. Misalnya: Sprint Start Date, Story point estimasi.

Contoh sebelumnya, dengan sendirinya, tidak terlalu berguna. Bidang numerik dapat (dan kemungkinan besar akan) dihitung dari Transformasi. Menggunakan Grup Dengan Transformasi akan memungkinkan pengelompokan berdasarkan Tanggal Mulai Sprint dan meringkas estimasi titik Cerita yang memungkinkan visualisasi Poin Cerita dari waktu ke waktu per Sprint. Untuk informasi lebih lanjut tentang transformasi, lihat Menerapkan transformasi.

Template dan variabel

Untuk menambahkan variabel query Jira baru, lihatMenambahkan variabel kueri. Gunakan sumber data Jira Anda sebagai sumber data.

Anda dapat menentukan variabel pada dasbor Anda dan mereferensikannya dalam ekspresi JQL. Misalnya, Anda dapat membuat dasbor status proyek dan memilih di antara proyek, atau dasbor status epik dan memilih epos yang berbeda, atau dasbor status tugas dan memilih penerima tugas yang berbeda.

Untuk mendapatkan daftar dinamis proyek, epos, penerima tugas, dan sebagainya untuk dipilih, buat variabel tipe Query. Variabel tipe kueri menggunakan JQL untuk menanyakan masalah dan mengembalikan Proyek, Epik, Penerima Tugas, atau apa pun yang terkait dengan masalah. Berikut adalah contohnya:

Buat variabel Assignee untuk mendapatkan status masalah oleh Penerima Tugas
  1. Tambahkan variabel tipe Query bernamaassignee.

  2. Pilih Bidang: Penerima Tugas.

  3. ) Opsional) Tambahkan proyek filter JQL = 'proyek Anda'.

  4. Pilih Jalankan untuk melihat daftar Penerima Tugas.

  5. Pilih Perbarui untuk menambahkan variabel ke dasbor.

  6. Tambahkan panel baru ke dasbor dan edit JQL untuk memfilter menggunakan variabel baru Anda assignee = $assignee.

    Sekarang, ketika memilih dari dropdown, Anda hanya melihat masalah yang ditetapkan untuk pengguna itu.

Variabel multi-nilai memungkinkan memilih beberapa opsi dan dapat digunakan sebagai bagian dari klausa IN. Misalnya, penerima tugas IN ($assignee).

Menggunakan transformasi dari Grafana untuk menjawab pertanyaan umum

Makro adalah variabel yang mereferensikan jendela waktu Dasbor sehingga Anda dapat memfilter masalah hanya dalam rentang jendela Dasbor. Ada 2 makro:

  • $__TimeFrom

  • $ __TimeTo.

Contoh berikut masalah filter permintaan JQL yang dibuat dalam jendela waktu dasbor: createdDate >= $__timeFrom AND createdDate <= $__timeTo

Dapatkan hasil maksimal dari sumber data

Menggunakan transformasi Grafana dan fitur bawaan lainnya dapat membantu Anda melihat data Jira Anda secara bermakna.

Menggunakan transformasi untuk menambah JQL

Meskipun ada banyak Transformasi di Grafana untuk dipilih, berikut ini memberikan augmentasi yang kuat untuk memberi JQL beberapa fitur/kekuatan SQL.

Group By Transformasi ini menyediakan fitur utama yang bukan bagian dari sintaks Jira JQL standar: Pengelompokan. Dengan menggunakan transformasi Grup Berdasarkan, Anda dapat mengelompokkan berdasarkan Sprint atau bidang Masalah lainnya, dan menggabungkan menurut grup untuk mendapatkan metrik seperti perkiraan kecepatan dan titik cerita vs penyelesaian aktual dalam Sprint.

Outer Join Mirip dengan SQL bergabung, Anda dapat menggabungkan 2 atau lebih kueri bersama-sama dengan bidang umum. Ini menyediakan cara untuk menggabungkan kumpulan data dari kueri dan menggunakan transformasi lain untuk menghitung nilai dari beberapa kueri/kumpulan data.

Tambahkan Bidang dari Perhitungan Mirip dengan ekspresi SQL, transformasi ini memungkinkan penambahan bidang baru ke kumpulan data Anda berdasarkan perhitungan bidang lain. Bidang yang digunakan dalam perhitungan dapat berasal dari satu kueri atau dari kueri yang telah Anda gabungkan bersama. Anda juga dapat menggabungkan perhitungan dan melakukan perhitungan dari bidang terhitung.

Menggunakan transformasi dari Grafana untuk menjawab pertanyaan umum

Anda dapat menggunakan Transformasi untuk memvisualisasikan, menggabungkan, mengelompokkan, dan menggabungkan kumpulan data, bersama dengan banyak jenis transformasi lainnya untuk mengubah hasil sederhana menjadi jawaban untuk pertanyaan kompleks.

Bagaimana cara menunjukkan kecepatan per sprint?

  1. Pilih Bidang: Nama Sprint, Perkiraan titik cerita.

  2. Tambahkan filter JQL: project = "Your Project" AND type != epic AND status = done order by created ASC

  3. Tambahkan Grup Berdasarkan transformasi:

    • Nama Sprint | Kelompokkan Berdasarkan

    • Perkiraan Poin Cerita | Hitung | Total

  4. Pilih visualisasi Bar Gauage.

Bagaimana cara menunjukkan apa yang telah Selesai vs Diperkirakan dalam Sprint?

  1. Tambahkan kueri. Pertama, pilih Bidang: Nama Sprint, Tanggal Mulai Sprint,, Perkiraan titik cerita.

    Kemudian tambahkan filter JQL: project = 'Your Project' AND type != epic

  2. Tambahkan kueri kedua. Pertama, pilih Bidang: Nama Sprint, Tanggal Mulai Sprint,, Perkiraan titik cerita.

    Kemudian tambahkan filter JQL: project = 'Your Project' AND type != epic AND status = done

  3. Tambahkan Grup Berdasarkan transformasi:

    • Nama Sprint | Kelompokkan Berdasarkan

    • Tanggal Mulai Sprint | Kelompokkan Berdasarkan

    • Perkiraan Poin Cerita | Hitung | Total

  4. Pilih visualisasi Grafik.

Berapa waktu rata-rata untuk menyelesaikan masalah dalam proyek saya?

  1. Tambahkan kueri. Pertama, pilih Bidang: Dibuat, Kategori Status Diubah.

    Kemudian tambahkan filter JQL: project = 'Your Project' AND type != epic AND status = done

  2. Tambahkan transformasi: Tambahkan bidang dari perhitungan

    • Mode = Kurangi Baris

    • Perhitungan = Perbedaan

  3. Tambahkan transformasi: Tambahkan bidang dari perhitungan

    • Mode = Operasi Biner

    • Operasi = Perbedaan/86000000

    • Alias = Hari

  4. Tambahkan transformasi: Atur bidang

    • Sembunyikan bidang yang berbeda

  5. Tambahkan transformasi: Filter data berdasarkan nilai

    • Jenis Filter = Sertakan

    • kondisi = Cocokkan apapun

      • Bidang = Hari | Pertandingan = Lebih Besar | Nilai = 1

  6. Tambahkan transformasi: Kurangi

    • Mode = Seri ke Baris

    • Perhitungan = mean

  7. Pilih visualisasi Stat.