Application Real-Time Monitoring Service：Integrasikan Jira dengan manajemen alert ARMS menggunakan akun Jira

Cara kerja

Manajemen Alert ARMS terhubung ke instans Jira melalui akun Jira. Saat sebuah alert dipicu, ARMS membuat issue di proyek Jira yang ditentukan dan memetakan tingkat severity alert ke priority Jira.

Setiap arah sinkronisasi memerlukan konfigurasi tersendiri:

• ARMS ke Jira — Dikonfigurasi saat penyiapan integrasi. Operasi alert (claim, komentar, resolve) secara otomatis disinkronkan ke issue Jira yang terkait.

• Jira ke ARMS — Memerlukan webhook Jira yang mengirim pembaruan issue (reassign, komentar) kembali ke ARMS.

Pencocokan pengguna: ARMS mencocokkan pengguna antara kedua sistem berdasarkan alamat email atau username. Jika tidak ditemukan pengguna Jira yang sesuai, alert tidak dapat didorong ke Jira.

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

• Akses ke Konsol ARMS dengan izin Manajemen Alert

• URL instans Jira, username, dan password dengan izin untuk membuat issue

Langkah 1: Buat integrasi Jira

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

2. Di halaman Integrations, klik tab Notification Integrations, lalu klik JIRA.

3. Di wizard Add Integration, lakukan langkah-langkah berikut:

   1. Pada langkah Basic Information, konfigurasikan koneksi:

      • Masukkan nama integrasi dan URL instans Jira.

      • Atur Verification Method ke Log On with Jira Account.

      • Masukkan username dan password instans Jira.

      • (Opsional) Tambahkan deskripsi.

      • Klik Test Connection.

   2. Setelah muncul pesan Connection Succeeded, klik Next.

      Catatan

      Jika koneksi gagal, verifikasi URL, username, dan password, lalu klik Test Connection lagi.

   3. Pada langkah Alert Source Configuration, konfigurasikan pemetaan alert ke issue:

      Parameter	Deskripsi	Contoh
      Project	Proyek Jira tempat ARMS membuat issue untuk alert.	Monitoring Project
      Type	Tipe issue Jira. Nilai yang valid: Task, Subtask, Improvement, New feature, Bug, Epic, Story.	Bug
      Issue status when the alert is disabled	Status Jira yang menandai issue sebagai resolved. Saat issue Jira mencapai status ini, ARMS berhenti menyinkronkan operasi alert lebih lanjut ke issue tersebut. Nilai yang valid: To Do, In Progress, In Review, Done.	Done
      Priority	Memetakan tingkat severity alert ARMS ke priority issue Jira.	P1: Highest, P2: High, P3: Medium, P4: Low, P5: Lowest

      Penting

      • Jika tingkat severity alert tidak dipetakan ke priority Jira, alert pada level tersebut tidak akan didorong ke Jira.

      • Pemetaan severity ke priority hanya diterapkan saat dorongan pertama. Perubahan selanjutnya pada severity alert saja tidak memperbarui priority issue Jira.

      • Kami menyarankan memilih Done sebagai status resolved. Jika Anda memilih nilai lain dan issue kemudian berubah ke Done, ARMS tetap menyinkronkan operasi alert ke issue tersebut.

   4. Klik Save.

Langkah 2: Dorong alert ke Jira

Setelah membuat integrasi, dorong alert ke Jira dengan salah satu cara berikut.

Opsi A: Dorongan otomatis melalui kebijakan notifikasi

Siapkan kebijakan notifikasi untuk secara otomatis membuat issue Jira setiap kali alert yang sesuai dipicu.

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

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

3. Di bagian When an alert is triggered,, tentukan minimal satu contact atau contact group untuk parameter Contacts.

   Penting

   • ARMS mencocokkan contact pertama dalam kebijakan dengan pengguna Jira berdasarkan alamat email atau username, lalu menetapkan pengguna tersebut sebagai penanganan issue.

   • Jika tidak ditemukan pengguna Jira yang sesuai, alert tidak didorong ke Jira.

4. Pilih integrasi Jira yang telah Anda buat untuk Ticket System. Konfigurasikan parameter lain sesuai kebutuhan. Untuk informasi lebih lanjut, lihat Create and manage a notification policy.

5. Klik Save.

   Alert yang sesuai dengan kebijakan notifikasi kini secara otomatis didorong ke Jira.

Opsi B: Dorongan manual dari halaman riwayat pengiriman alert

Dorong alert individual ke Jira dari halaman detailnya.

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

2. Di halaman Alert Sending History, di pojok kanan atas, kaitkan penanganan dengan alert, lalu klik nama alert tersebut.

   Penting

   • ARMS mencocokkan operator dengan pengguna Jira berdasarkan alamat email atau username, lalu menetapkan pengguna tersebut sebagai penanganan issue.

   • Jika tidak ditemukan pengguna Jira yang sesuai, alert tidak didorong ke Jira.

3. Di halaman detail alert, klik ikon di pojok kanan atas, lalu klik Push Alerts.

4. Di kotak dialog, pilih integrasi Jira dari daftar drop-down Ticket System, lalu klik OK.

Setelah alert didorong, tautan ke issue Jira yang sesuai muncul di halaman detail alert.

Opsi C: Dorong dari kartu alert DingTalk

Dorong alert ke Jira langsung dari kartu alert grup DingTalk.

Gunakan salah satu metode berikut:

• Di kartu alert, klik Push Alerts dan pilih integrasi Jira.

• Klik nama alert di kartu tersebut. Di panel detail, klik Settings > Push Alerts, lalu pilih integrasi Jira.

Setelah alert didorong, tautan ke issue Jira yang sesuai muncul di halaman detail alert.

Operasi yang disinkronkan dari ARMS ke Jira

Setelah Anda mendorong alert ke Jira, operasi ARMS berikut secara otomatis disinkronkan ke issue yang terkait:

Langkah 3: Siapkan sinkronisasi Jira ke ARMS

Untuk menyinkronkan pembaruan issue Jira (reassign, komentar) kembali ke ARMS, buat webhook di Jira.

1. Di halaman Integrations di ARMS, klik tab Notification Integrations dan salin integration key untuk integrasi Jira tersebut.

   

2. Masuk ke instans Jira Anda. Di pojok kanan atas, klik ikon Settings, lalu klik System.

   

3. Masukkan password administrator dan klik OK.

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

5. Klik + Create a webhook.

   

6. Atur URL ke nilai berikut, ganti {token} dengan integration key yang Anda salin di langkah 1:

   http://alerts.aliyuncs.com/api/jira/receiver/{token}/${project.key}/${issue.key}

   

7. Konfigurasikan parameter webhook lain sesuai kebutuhan. Untuk detailnya, lihat dokumentasi webhook Jira. Klik Create.

Setelah webhook aktif, operasi Jira berikut disinkronkan ke ARMS: