Application Real-Time Monitoring Service：Gunakan OAuth untuk mengintegrasikan Jira dengan ARMS

Langkah 1: Konfigurasikan Jira

1. Jalankan perintah OpenSSL berikut di antarmuka baris perintah (CLI) untuk menghasilkan kunci publik Rivest–Shamir–Adleman (RSA) dan kunci privat RSA.
   Catatan Operasi ini dapat dilakukan di mana saja dalam sistem file, dan file yang dibuat akan disimpan di lokasi saat ini.
   1. Hasilkan kunci privat 1024-bit:

      openssl genrsa -out jira_privatekey.pem 1024

   2. Buat sertifikat X509:

      openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365

   3. Ekstrak kunci privat (format PKCS8) ke file jira_privatekey.pcks8:

      openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8

   4. Ekstrak kunci publik dari sertifikat ke file jira_publickey.pem:

      openssl x509 -pubkey -noout -in jira_publickey.cer  > jira_publickey.pem

2. Buat tautan aplikasi.
   1. Masuk ke Jira, klik ikon Pengaturan di pojok kanan atas halaman Jira, lalu klik Applications.
      
   2. Pada tab Applications, klik Application links.
   3. Di bagian Configure Application Links, masukkan URL dan klik Create new link.
      Catatan URL tersebut tidak digunakan. Anda bisa memasukkan URL acak, misalnya, http://alerts.console.aliyun.com/.
   4. Di kotak dialog Configure Application URL, abaikan peringatan dan klik Continue.
      
   5. Di kotak dialog Link applications, atur Application Type menjadi Generic Application, atur Consumer key menjadi AlertOauthKey, pilih Create incoming link, tentukan parameter lainnya, lalu klik Continue.
      
   6. Di kotak dialog Link applications, konfigurasikan parameter berikut dan klik Continue.

      Parameter	Nilai
      Consumer Key	AlertOauthKey
      Consumer Name	alertmanager
      Public Key	Kunci publik yang dihasilkan di Langkah 1, yaitu isi dari file jira_publickey.pem.

      
      Setelah beberapa saat, Anda dapat melihat tautan aplikasi baru di halaman Configure Application Links.
   7. Klik ikon di kolom Actions dari tautan aplikasi. Di kotak dialog Configure alertmanager, klik Incoming Authentication.
      
   8. Jika parameter Status menampilkan Not Configured, tentukan Consumer Key, Consumer Name, dan Public Key, lalu klik Save.
   9. Klik Cancel.

Langkah 2: Integrasikan Jira dengan ARMS

1. Masuk ke Konsol ARMS. Di panel navigasi kiri, pilih Alert Management > Integrations.

2. Di halaman Integrations, klik tab Notification Integration lalu klik JIRA.
3. Di wizard Add Integration, konfigurasikan parameter berdasarkan informasi berikut:
   1. Di halaman wizard Basic Information, atur parameter berikut dan klik Obtain Verification Code.
      Anda akan dialihkan secara otomatis ke halaman verifikasi Jira.

      Parameter	Nilai
      Nama	Nama integrasi Jira.
      Deskripsi	Deskripsi integrasi Jira.
      URL	URL yang disediakan oleh Jira.
      Verifikasi	Atur Verifikasi menjadi Oauth.
      Consumer key	AlertOauthKey
      Private key	Kunci privat yang dihasilkan di Langkah 1, yaitu isi dari file jira_privatekey.pcks8.

   2. Di halaman Welcome to JIRA, klik Allow.
      
   3. Di halaman Access Approved, dapatkan kode verifikasi.
      
   4. Kembali ke halaman wizard Add integration, masukkan kode verifikasi yang diperoleh untuk parameter Verification Code, lalu klik Obtain Access Token.
      
   5. Setelah pesan Access token telah diperoleh. ditampilkan, klik Next.
   6. Di halaman wizard Alert Source Configuration, atur parameter berikut dan klik Save.

      Parameter	Deskripsi	Contoh
      Proyek	Tentukan proyek Jira ke mana informasi tentang peringatan disinkronkan.	Proyek pemantauan, manajemen, dan kontrol terintegrasi
      Tipe	Tipe masalah di Jira. Nilai valid: Tugas Subtugas Peningkatan Fitur baru Bug Epic Cerita	Bug
      Status masalah ketika peringatan dinonaktifkan.	Status masalah Jira ketika masalah diselesaikan. Ketika masalah Jira berada dalam status tertentu, masalah Jira diidentifikasi sebagai selesai. Operasi pada peringatan yang sesuai dengan masalah tidak disinkronkan ke masalah. Nilai valid: To Do In Progress In Review Done Catatan Kami merekomendasikan Anda memilih Done. Jika Anda memilih nilai lain dan status masalah berubah menjadi Done, operasi pada peringatan yang sesuai dengan masalah tetap disinkronkan ke masalah.	Done
      Prioritas	Pemetaan antara tingkat keparahan peringatan dan prioritas masalah di Jira. Penting Jika tingkat keparahan peringatan tidak dipetakan ke prioritas masalah, peringatan dengan tingkat keparahan ini tidak disinkronkan ke Jira. Ketika peringatan didorong ke Jira untuk pertama kalinya, tingkat keparahan disinkronkan berdasarkan pemetaan yang Anda konfigurasikan. Setelah tingkat keparahan disinkronkan, jika Anda hanya mengubah tingkat keparahan, informasi tentang perubahan tidak disinkronkan ke Jira.	P1: Tertinggi P2: Tinggi P3: Sedang P4: Rendah P5: Terendah

   Setelah konfigurasi selesai, Anda dapat melihat integrasi Jira yang dibuat di tab Notification Integrations.

Dorong peringatan ke Jira

Setelah Anda menambahkan integrasi Jira, Anda dapat mendorong peringatan ke Jira menggunakan salah satu dari tiga metode berikut:

Metode 1

Konfigurasikan kebijakan notifikasi yang membuat masalah di Jira ketika peringatan dihasilkan.

1. Di panel navigasi kiri, pilih Alert Management > Notification Policies.

2. Di halaman Notification Policy, klik Create Notification Policy atau edit kebijakan notifikasi yang ada.

3. Di bagian When an alert is triggered, di halaman pengeditan kebijakan notifikasi, tentukan parameter Kontak. Anda harus memilih setidaknya satu kontak atau grup kontak.

   Penting

   • Jira mencari pengguna yang memiliki alamat email atau nama (nama pengguna) yang sama dengan kontak pertama yang ditentukan dalam kebijakan notifikasi, dan menetapkan pengguna tersebut sebagai penanganan masalah yang dibuat.

   • Jika Jira tidak dapat menemukan pengguna yang cocok dengan kontak pertama yang ditentukan dalam kebijakan notifikasi, peringatan tidak didorong ke Jira.

4. Pilih integrasi Jira yang Anda buat untuk Sistem Tiket. Konfigurasikan parameter lainnya sesuai kebutuhan. Untuk informasi lebih lanjut, lihat Buat dan kelola kebijakan notifikasi.

5. Klik Save.

   Dengan cara ini, peringatan yang sesuai dengan kebijakan notifikasi didorong ke Jira.

Metode 2

Di halaman Alert Event History, dorong peringatan ke Jira dan buat masalah di Jira.

1. Di panel navigasi kiri, pilih Alert Management > Alert Sending History.

2. Di pojok kanan atas halaman Alert Sending History, asosiasikan penanganan masalah Jira dengan peringatan dan klik nama peringatan yang ingin Anda lihat.

   Penting

   • Jira mencari pengguna yang memiliki alamat email atau nama (nama pengguna) yang sama dengan operator, dan menetapkan pengguna tersebut sebagai penanganan masalah yang dibuat.

   • Jika Jira tidak dapat menemukan pengguna yang cocok, peringatan tidak didorong ke Jira.

3. Di halaman detail peringatan, klik ikon di pojok kanan atas dan klik Push Alerts.

4. Di kotak dialog yang muncul, pilih integrasi Jira yang dibuat dari daftar drop-down Sistem Tiket dan klik OK.

   Setelah peringatan didorong, Anda dapat melihat tautan ke masalah Jira yang sesuai dengan peringatan di halaman detail peringatan.

Metode 3

Setelah peringatan dihasilkan dan kartu peringatan diterima di grup obrolan DingTalk yang Anda tentukan, Anda dapat menggunakan kartu peringatan untuk mendorong peringatan ke Jira. Kemudian, masalah yang sesuai dibuat di Jira.

• Di kartu peringatan yang Anda terima di grup DingTalk, klik Push Alerts dan pilih integrasi Jira yang Anda buat.

• Klik nama peringatan di kartu peringatan. Di panel detail peringatan, klik Settings, klik Push Alerts, lalu pilih integrasi Jira yang Anda buat.

Setelah peringatan didorong, Anda dapat menemukan tautan ke masalah Jira yang sesuai dengan peringatan di halaman detail peringatan.

Alerts-related operations that can be synchronized

Setelah Anda menyelesaikan langkah-langkah sebelumnya, operasi berikut pada peringatan di ARMS disinkronkan ke Jira.

Operasi berikut di halaman Alert Sending History disinkronkan ke Jira:

• Ambil alih peringatan: Penerima klaim akan menjadi penanganan masalah di Jira.

  Catatan

  Penerima klaim harus memiliki akun pengguna yang cocok di Jira.

• Beri komentar pada peringatan: Komentar disinkronkan ke komentar masalah di Jira.

• Selesaikan peringatan: Solusi disinkronkan ke komentar masalah di Jira.

Operasi berikut pada kartu peringatan disinkronkan ke Jira:

Ambil alih peringatan: Penerima klaim akan menjadi penanganan masalah di Jira.

Sinkronkan operasi Jira ke peringatan

1. Di halaman Integrations di ARMS, klik tab Notification Integrations untuk mendapatkan kunci integrasi Jira.

   

2. Masuk ke sistem tiket Jira. Di pojok kanan atas, klik ikon Pengaturan dan klik System.

   

3. Masukkan kata sandi administrator dan klik OK untuk pergi ke halaman Konfigurasi Sistem.

4. Di panel navigasi kiri halaman System, klik Webhooks.

5. Di halaman Webhook, klik + Create a webhook.

   

6. Di halaman yang muncul, atur URL menjadi http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}. Ganti {token} dengan kunci integrasi Jira yang diperoleh di Langkah 1.

   

7. Konfigurasikan parameter lainnya sesuai kebutuhan. Untuk informasi lebih lanjut, lihat Dokumentasi Jira. Lalu, klik Create.

   Setelah Anda menyelesaikan langkah-langkah sebelumnya, operasi berikut pada masalah di Jira disinkronkan ke manajemen peringatan ARMS.

   • Ubah penanganan masalah: Penanganan peringatan yang sesuai diubah.

   • Beri komentar pada masalah: Komentar ditambahkan ke komentar peringatan yang sesuai.