Application Real-Time Monitoring Service：Integrasi SkyWalking dengan ARMS

Langkah 1: Buat integrasi SkyWalking

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

2. Pada tab Alert Integration, klik Skywalking.
3. Di kotak dialog Create Skywalking Integration, masukkan nama dan deskripsi untuk integrasi SkyWalking, tentukan waktu pemulihan otomatis untuk peristiwa peringatan, lalu klik Save.
   Catatan

   Waktu pemulihan otomatis setelah batas waktu: Jika peristiwa peringatan tidak dipicu lagi dalam periode waktu yang ditentukan, peristiwa tersebut akan dihapus secara otomatis.

4. Pada tab Alert Integration, temukan integrasi SkyWalking yang telah dibuat dan salin URL pada kolom Alamat Integrasi.
   

Langkah 2: Konfigurasi SkyWalking

1. Masuk ke server tempat SkyWalking diterapkan dan buka direktori skrip SkyWalking:

   cd /opt/sky/apache-skywalking-apm-bin/

2. Jalankan perintah berikut untuk melihat folder config:

   ls config/

3. Jalankan perintah berikut untuk memodifikasi file alarm-settings.yml di folder config:

   vim config/alarm-settings.yml

4. Tambahkan URL yang Anda dapatkan di Langkah 1 ke bidang webhook:

   webhook
   - https://alerts.aliyuncs.com/api/v1/skywalking/event/******

5. Jalankan perintah :wq untuk menyimpan perubahan pada file alarm-settings.yml.

(Opsional) Langkah 3: Modifikasi integrasi

Alert Management menyediakan pemetaan bidang antara sumber peringatan SkyWalking dan peristiwa peringatan ARMS. Anda juga dapat menambah atau memodifikasi pemetaan antar bidang di halaman Edit Integration.

Contoh sumber peringatan:

{
    "startTime":1630408697583,
    "scope":"SERVICE_INSTANCE",
    "scopeId":2,
    "name":"932******@127.0.XX.XX of testApp",
    "alarmMessage":"instance_jvm_cpu of 932******@127.0.XX.XX of testApp is more than 80 in 2 minutes of last 3 minutes",
    "ruleName":"instance_jvm_cpu_rule",
    "id1":"",
    "id0":"YnNtLXdlYg==.1_OTMyYjU1NmVmM2Y1NGR====--7p862kYTliODA4MTk0ZTJlODcxMWFAMTAuMS4xMS4xNg=="
}

1. Pada tab Alert Integration, temukan integrasi yang ingin Anda kelola dan klik Edit di kolom Actions.

2. Di bagian Event Mapping, klik Send Test Data.

3. Di kotak dialog Send Test Data, masukkan konten peringatan dari sumber peringatan pihak ketiga dalam format JSON dan klik Send.

   Catatan

   • Jika pesan Uploaded. No events are generated. Configure mappings based on the original data. muncul, bidang sumber peringatan belum dipetakan ke bidang peristiwa peringatan ARMS. Data yang dikirim ditampilkan di kotak di sebelah kiri untuk membantu konfigurasi pemetaan.

   • Jika pesan Uploaded. muncul, konten peringatan dilaporkan ke halaman Histori Peristiwa Peringatan. Untuk informasi lebih lanjut, lihat Lihat histori peristiwa peringatan.

4. Di kotak dialog Send Test Data, klik Disable.

5. Di bagian kiri Event Mapping, klik catatan data yang ingin Anda konfigurasikan pemetaannya untuk melihat detailnya.

6. Di bagian kanan Event Mapping, konfigurasikan pemetaan bidang antara sumber peringatan dan ARMS.

   1. Opsional:Di bagian Select Root Node, tentukan apakah akan mengaktifkan pemrosesan batch.

      Jika ada node array dalam data peringatan, Anda dapat menentukan node array sebagai root node. Data yang termasuk dalam root node diproses secara batch.

      Setelah memilih Use Batch Processing, pilih node array yang akan diproses batch sebagai root node.

      Catatan

      Jika ada beberapa node array dalam data peringatan, Anda hanya dapat memilih salah satu node array untuk pemrosesan batch.

   2. Di bagian Map Source Fields to Target Fields, petakan bidang sumber peringatan ke bidang peringatan ARMS.

      Klik ikon pemetaan untuk mengubah metode pemetaan bidang.

      • Direct: Bidang tertentu dari sumber peringatan langsung dipetakan ke bidang peringatan ARMS yang ditentukan.

      • Series: Anda dapat menggunakan pemisah untuk menggabungkan beberapa bidang sumber peringatan menjadi satu bidang, lalu memetakan bidang ini ke bidang peringatan ARMS yang ditentukan. Hanya karakter khusus yang dapat digunakan sebagai pemisah.

      • Conditional: Bidang sumber peringatan yang ditentukan dipetakan ke bidang peringatan ARMS hanya jika nilai bidang memenuhi kondisi yang ditentukan.

      • Mapping table: Tingkat keparahan sumber peringatan dipetakan ke tingkat keparahan peringatan ARMS. Tabel pemetaan hanya berisi bidang tingkat keparahan.

      Tabel berikut menjelaskan bidang peringatan ARMS.

      Bidang peringatan	Deskripsi
      alertname	Nama peringatan kustom.
      severity	Tingkat keparahan peringatan. Anda harus mengonfigurasi pemetaan untuk bidang ini. Metode pemetaan harus disetel ke Direct.
      message	Deskripsi peringatan. Deskripsi digunakan sebagai isi pesan peringatan. Deskripsi tidak boleh melebihi 15.000 karakter.
      value	Nilai sampel dari data deret waktu.
      imageUrl	URL grafik garis yang berisi data deret waktu Grafana. URL digunakan untuk memetakan grafik garis.
      check	Item pemeriksaan peringatan. Contoh: CPU, JVM, Crash Aplikasi, dan Penyebaran.
      source	Sumber peringatan.
      class	Jenis objek yang memicu peristiwa peringatan, misalnya host.
      service	Layanan sumber peringatan. Contoh: Layanan Login.
      startat	Timestamp yang mewakili waktu mulai peristiwa.
      endat	Timestamp yang mewakili waktu akhir peristiwa.
      generatorUrl	URL detail peristiwa.

7. Konfigurasikan deduplikasi bidang untuk peristiwa peringatan.

   Untuk mengurangi data duplikat, sistem menggunakan bidang terkait sebagai dasar deduplikasi. Manajemen Peringatan ARMS memungkinkan Anda melihat hasil pengelompokan deduplikasi data peristiwa historis yang ditampilkan di bagian Event Mapping. Anda dapat mengubah bidang yang akan dideduplikasi.

   Catatan

   Anda hanya dapat mengonfigurasi deduplikasi untuk peristiwa yang tidak dibersihkan.

   1. Di bagian Event Deduplication di halaman Integration Details, pilih bidang yang digunakan untuk deduplikasi.

      Jika beberapa peristiwa memiliki nilai yang sama untuk bidang tertentu, peristiwa tersebut digabungkan menjadi satu notifikasi peringatan.

   2. Klik Deduplication Test untuk melihat pratinjau grup peringatan setelah deduplikasi.

      Catatan

      Pengujian deduplikasi hanya berlaku untuk 10 catatan data terbaru yang diunggah di bagian kiri Event Mapping.

8. Setelah mengonfigurasi pengaturan, klik Save.

Lihat detail tentang peristiwa peringatan

1. Di panel navigasi sebelah kiri Konsol ARMS, pilih Alert Management > Alert Event History.

2. Pada halaman Alert Event History, klik nama peristiwa peringatan untuk melihat detailnya. Untuk informasi lebih lanjut, lihat Lihat histori peristiwa peringatan.

Kelola integrasi

Di panel navigasi sebelah kiri, pilih Alert Management > Integrations. Pada tab Alert Integration, Anda dapat melakukan operasi berikut pada integrasi yang telah dibuat:

• Lihat detail integrasi: Temukan integrasi lalu klik baris tersebut. Di halaman Integration Details, lihat detail integrasi.

• Perbarui kunci: Temukan integrasi lalu pilih More > Update Key di kolom Actions. Dalam pesan yang muncul, klik OK.
  Penting Setelah memperbarui kunci, modifikasi file alarm-settings.yml berdasarkan informasi di Langkah 2.

• Modifikasi integrasi: Temukan integrasi lalu klik Edit di kolom Actions. Di halaman Integration Details, modifikasi informasi integrasi lalu klik Save.

• Aktifkan atau nonaktifkan integrasi: Temukan integrasi lalu klik Disable atau Enable di kolom Actions.

• Hapus integrasi: Temukan integrasi lalu klik Delete di kolom Actions. Dalam pesan yang muncul, klik OK.

• Tambahkan alur pemrosesan peristiwa ke integrasi: Temukan integrasi dan klik Add Event Processing Flow di kolom Actions. Untuk informasi lebih lanjut, lihat Bekerja dengan alur pemrosesan peristiwa.

• Buat kebijakan notifikasi: Temukan integrasi untuk mana Anda ingin membuat kebijakan notifikasi, dan klik More di kolom Actions. Dalam daftar yang muncul, klik Create Notification Policy. Untuk informasi lebih lanjut, lihat Buat dan kelola kebijakan notifikasi.