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

Ketika Application Real-Time Monitoring Service (ARMS) mendeteksi masalah pada aplikasi Anda, tim Anda perlu segera mengambil tindakan. Dengan mengintegrasikan Jira ke dalam manajemen alert ARMS melalui OAuth, setiap alert secara otomatis membuat isu Jira, dan perubahan status tetap tersinkronisasi dua arah—sehingga tim Anda dapat melakukan triage, menetapkan penugasan, dan menyelesaikan insiden dari platform mana pun tanpa perlu berpindah konteks.

Panduan ini mencakup seluruh proses penyiapan: menghasilkan kredensial OAuth, mengonfigurasi tautan aplikasi Jira, menghubungkan ARMS ke Jira, serta mengaktifkan sinkronisasi dua arah.

Kemampuan integrasi

Setelah penyiapan selesai, integrasi ini menyediakan kemampuan berikut:

Automatic issue creation: Alert ARMS membuat isu Jira berdasarkan kebijakan notifikasi Anda.
Priority mapping: Tingkat keparahan alert (P1–P5) dipetakan ke prioritas isu Jira (Highest–Lowest).
Bidirectional status sync: Tindakan Claim, comment, dan resolve di ARMS disinkronkan ke Jira. Perubahan assignee dan komentar di Jira disinkronkan kembali ke ARMS.
Flexible alert routing: Dorong alert ke Jira melalui kebijakan notifikasi, halaman riwayat alert, atau kartu alert DingTalk.

Prasyarat

Sebelum memulai, pastikan Anda memiliki hal-hal berikut:

Requirement	Details
ARMS console access	Izin untuk mengonfigurasi integrasi di bawah Alert Management > Integrations
Jira administrator access	Izin untuk membuat application links dan webhook di Jira
OpenSSL	Terinstal di mesin lokal Anda untuk menghasilkan pasangan kunci RSA

Langkah 1: Hasilkan kunci RSA

Hasilkan pasangan kunci RSA untuk hubungan kepercayaan OAuth antara ARMS dan Jira. Jalankan perintah OpenSSL berikut di terminal.

Catatan

Perintah-perintah ini membuat file di direktori kerja saat ini.

Hasilkan kunci privat RSA 1024-bit:

openssl genrsa -out jira_privatekey.pem 1024

Buat sertifikat X.509 yang berlaku selama 365 hari:

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

Konversi kunci privat ke format PKCS#8:

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

Ekstrak kunci publik dari sertifikat:

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

Setelah menjalankan perintah-perintah tersebut, empat file dibuat:

File	Used in
`jira_privatekey.pem`	File antara (tidak digunakan langsung dalam konfigurasi)
`jira_publickey.cer`	File antara (tidak digunakan langsung dalam konfigurasi)
`jira_privatekey.pcks8`	Langkah 3 – Penyiapan integrasi ARMS (private key)
`jira_publickey.pem`	Langkah 2 – Tautan aplikasi Jira (public key)

Langkah 2: Buat tautan aplikasi Jira

Konfigurasikan Jira agar menerima koneksi OAuth dari ARMS dengan membuat tautan aplikasi.

Masuk ke Jira, klik ikon Settings di pojok kanan atas, lalu klik Applications.
Di tab Applications, klik Application links.
Di bagian Configure Application Links, masukkan URL dan klik Create new link.
Catatan
URL ini hanya berfungsi sebagai placeholder dan tidak digunakan untuk komunikasi aktual. Masukkan URL valid apa pun, misalnya http://alerts.console.aliyun.com/.
Di kotak dialog Configure Application URL, abaikan peringatan dan klik Continue.
Di kotak dialog Link applications, konfigurasikan pengaturan berikut dan klik Continue:
Field
Value
Application Type
Generic Application
Consumer key
AlertOauthKey
Create incoming link
Selected
Tentukan bidang lain sesuai kebutuhan.
Di kotak dialog Link applications berikutnya, konfigurasikan pengaturan incoming link dan klik Continue:
Field
Value
Consumer Key
AlertOauthKey
Consumer Name
alertmanager
Public Key
Isi file jira_publickey.pem yang dihasilkan pada Langkah 1
Setelah tautan dibuat, tautan tersebut akan muncul di halaman Configure Application Links.
Klik ikon di kolom Actions tautan aplikasi tersebut. Di kotak dialog Configure alertmanager, klik Incoming Authentication.
Jika bidang Status menampilkan Not Configured, masukkan nilai Consumer Key, Consumer Name, dan Public Key, lalu klik Save.
Klik Cancel untuk menutup kotak dialog.

Langkah 3: Hubungkan ARMS ke Jira

Konfigurasikan integrasi Jira di Konsol ARMS dan selesaikan alur otorisasi OAuth.

Masuk ke ARMS console.
Di panel navigasi kiri, pilih Alert Management > Integrations.
Di halaman Integrations, klik tab Notification Integration, lalu klik JIRA.

Di wizard Add Integration, konfigurasikan halaman Basic Information dengan pengaturan berikut, lalu klik Obtain Verification Code:

Parameter	Value
Name	Nama untuk integrasi Jira
Description	Deskripsi integrasi Jira
URL	URL instans Jira Anda
Verification	Oauth
Consumer key	`AlertOauthKey`
Private key	Isi file jira_privatekey.pcks8 yang dihasilkan pada Langkah 1

Anda akan diarahkan secara otomatis ke halaman otorisasi Jira.

Di halaman Welcome to JIRA, klik Allow untuk memberikan akses ARMS ke instans Jira Anda.
Di halaman Access Approved, salin kode verifikasi.
Kembali ke wizard Add Integration di ARMS, tempel kode verifikasi ke dalam bidang Verification Code, lalu klik Obtain Access Token.
Setelah muncul pesan "The access token is obtained.", klik Next.

Di halaman Alert Source Configuration, konfigurasikan pengaturan berikut dan klik Save:

Parameter	Description	Example
Project	Proyek Jira tempat ARMS membuat isu untuk alert.	Integrated monitoring, management, and control project
Type	Tipe isu Jira. Nilai yang valid: Task, Subtask, Improvement, New feature, Bug, Epic, Story.	Bug
The status of the issue when the alert is disabled.	Status isu Jira yang dianggap ARMS sebagai resolved. Ketika isu mencapai status ini, ARMS berhenti menyinkronkan operasi alert ke isu tersebut. Nilai yang valid: To Do, In Progress, In Review, Done.	Done
Priority	Memetakan tingkat keparahan alert ARMS ke prioritas isu Jira.	P1: Highest, P2: High, P3: Medium, P4: Low, P5: Lowest

Penting

Jika Anda tidak memetakan tingkat keparahan tertentu ke prioritas isu, alert dengan tingkat keparahan tersebut tidak akan disinkronkan ke Jira.
Pemetaan keparahan ke prioritas hanya berlaku saat ARMS pertama kali mendorong alert ke Jira. Perubahan selanjutnya pada tingkat keparahan saja tidak disinkronkan.
Atur status menjadi Done. Jika Anda memilih status lain dan masalah tersebut kemudian berubah menjadi Done, ARMS akan terus menyinkronkan operasi ke masalah tersebut.

Setelah konfigurasi disimpan, integrasi Jira akan muncul di tab Ticket Integration pada halaman Integrations.

Jira integration

Langkah 4: Dorong alert ke Jira

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

Metode 1: Kebijakan notifikasi

Buat atau perbarui kebijakan notifikasi untuk secara otomatis membuat isu Jira ketika alert dipicu.

Di panel navigasi kiri, pilih Alert Management > Notification policy.
Klik Create Notification Policy, atau edit kebijakan yang sudah ada.
Di bagian When an alert is triggered, pilih minimal satu kontak atau kelompok kontak untuk parameter Contacts.
Penting
- Jira mencocokkan kontak pertama dalam kebijakan tersebut ke pengguna Jira berdasarkan alamat email atau username, lalu menetapkan pengguna tersebut sebagai assignee isu.
- Jika Jira tidak menemukan pengguna yang cocok, alert tidak didorong ke Jira.
Untuk parameter Ticket system, pilih integrasi Jira yang telah Anda buat.
Konfigurasikan parameter lain sesuai kebutuhan. Untuk informasi lebih lanjut, lihat Create and manage a notification policy.
Klik ikon di pojok kanan atas untuk menyimpan kebijakan.

Alert yang sesuai dengan kebijakan ini akan secara otomatis didorong ke Jira.

Metode 2: Halaman riwayat alert

Dorong alert tertentu secara manual ke Jira dari halaman riwayat alert.

Di panel navigasi kiri, pilih Alert Management > Alarm Sending History.
Di pojok kanan atas, pilih operator lalu klik nama alert. Operator tersebut akan menjadi assignee isu Jira.
Penting
- Operator adalah kontak yang nomor ponselnya terkait dengan kartu alert grup DingTalk. Untuk informasi lebih lanjut, lihat Handle alerts.
- Jira mencocokkan operator ke pengguna Jira berdasarkan alamat email atau username. Jika tidak ditemukan kecocokan, alert tidak didorong.
Di halaman detail alert, klik ikon di pojok kanan atas lalu pilih Push to Ticket System.
Di kotak dialog Push Alert to Ticket System, pilih integrasi Jira dari daftar drop-down Ticket System lalu klik OK.

Setelah alert didorong, tautan ke isu Jira akan muncul di halaman detail alert.

Metode 3: Kartu alert DingTalk

Dorong alert langsung dari kartu alert DingTalk untuk membuat isu Jira.

Penting

Operator yang mendorong alert akan menjadi assignee isu Jira.
Operator adalah kontak yang nomor ponselnya terkait dengan kartu alert grup DingTalk. Untuk informasi lebih lanjut, lihat Handle alerts.
Jira mencocokkan operator ke pengguna Jira berdasarkan alamat email atau username. Jika tidak ditemukan kecocokan, alert tidak didorong.

Dorong alert dari kartu DingTalk dengan salah satu cara berikut:

Di kartu alert, klik Push Alert lalu pilih integrasi Jira.
Klik nama alert untuk membuka panel detail. Klik Settings, klik Push Ticket, lalu pilih integrasi Jira.

Setelah alert didorong, tautan ke isu Jira akan muncul di halaman detail alert.

Perilaku sinkronisasi

Setelah penyiapan selesai, operasi tertentu akan otomatis disinkronkan antara ARMS dan Jira.

ARMS ke Jira

Operasi berikut di halaman Alarm Sending History disinkronkan ke isu Jira yang sesuai:

ARMS operation	Jira result
Claim an alert	Orang yang melakukan claim menjadi assignee isu. Orang tersebut harus memiliki akun pengguna Jira yang sesuai.
Comment on an alert	Komentar tersebut ditambahkan ke isu Jira.
Resolve an alert	Solusi ditambahkan sebagai komentar pada isu Jira.

Operasi berikut pada kartu alert DingTalk disinkronkan ke Jira:

ARMS operation	Jira result
Claim an alert	Orang yang melakukan claim menjadi assignee isu. Orang tersebut harus memiliki akun pengguna Jira yang sesuai.

Jira ke ARMS

Untuk menyinkronkan operasi Jira kembali ke ARMS, buat webhook di Jira.

Di Jira, klik ikon Settings di pojok kanan atas lalu klik System.
Masukkan password administrator lalu klik OK.
Di panel navigasi kiri, pilih Advanced > WebHooks.
Klik + Create a WebHook.
Tetapkan URL ke nilai berikut:
```
http://alerts.console.aliyun.com/api/jira/receiver/{token}/${project.key}/${issue.key}
```
Ganti {token} dengan kunci integrasi dari ARMS. Untuk menemukan kunci ini, buka halaman Integrations di Konsol ARMS lalu klik tab Ticket Integration.
Konfigurasikan parameter webhook lain sesuai kebutuhan. Untuk informasi lebih lanjut, lihat Jira webhook documentation.
Klik Create.

Setelah webhook aktif, operasi Jira berikut disinkronkan ke ARMS:

Jira operation	ARMS result
Ubah penugasan issue	Penanganan alert yang sesuai diperbarui.
Beri komentar pada suatu issue	Komentar tersebut ditambahkan ke alert yang sesuai.

Field	Value
Application Type	Generic Application
Consumer key	`AlertOauthKey`
Create incoming link	Selected