Application Real-Time Monitoring Service:Integrasikan SkyWalking dengan ARMS

Langkah 1: Buat integrasi SkyWalking

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

2. Pada tab Alert Integration, klik SkyWalking.
3. Di wizard Create SkyWalking Integration, masukkan nama dan deskripsi untuk integrasi, atur waktu pemulihan otomatis untuk event alert, lalu klik Save.
   Catatan

   Waktu pemulihan otomatis setelah timeout: Jika event alert tidak dipicu lagi dalam periode waktu yang ditentukan, event alert tersebut akan dihapus secara otomatis.

4. Pada tab Alert Integration, temukan integrasi SkyWalking yang telah Anda buat dan salin URL webhook-nya.

Langkah 2: Konfigurasikan SkyWalking

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

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

2. Jalankan perintah berikut untuk melihat folder config di direktori tersebut:

   ls config/

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

   vim config/alarm-settings.yml

4. Tambahkan URL yang Anda peroleh 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: Ubah integrasi

ARMS menyediakan pemetaan bidang default antara sumber alert SkyWalking dan alert ARMS. Anda juga dapat menambah atau mengubah pemetaan tersebut di halaman Edit Integration.

Contoh sumber alert:

{
    "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 alert dari sumber alert pihak ketiga dalam format JSON dan klik Send.

   Catatan

   • Jika muncul pesan Uploaded. No events are generated. Configure mappings based on the original data., artinya bidang sumber alert belum dipetakan ke bidang event alert ARMS. Data yang dikirim akan ditampilkan di kotak sebelah kiri sehingga Anda dapat memilih bidang sumber saat mengonfigurasi pemetaan.

   • Jika muncul pesan Uploaded., konten alert tersebut telah dilaporkan ke halaman Alert Event History. Untuk informasi selengkapnya, lihat View alert event history.

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

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

6. Di sisi kanan bagian Event Mapping, petakan bidang sumber ke bidang alert ARMS.

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

      Jika terdapat node array dalam data alert, Anda dapat menetapkan node array tersebut sebagai root node. Data yang termasuk dalam root node akan diproses secara batch.

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

      Catatan

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

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

      Klik ikon pemetaan untuk mengubah metode pemetaan bidang.

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

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

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

      • Mapping table: Tingkat keparahan (severity) sumber alert dipetakan ke tingkat keparahan alert ARMS. Tabel pemetaan hanya berisi bidang severity.

      Tabel berikut menjelaskan bidang alert ARMS.

      Bidang alert	Deskripsi
      alertname	Nama alert kustom.
      severity	Tingkat keparahan alert. Anda harus mengonfigurasi pemetaan untuk bidang ini. Metode pemetaan harus diatur ke Direct.
      message	Deskripsi alert. Deskripsi ini digunakan sebagai isi pesan alert. Panjang deskripsi tidak boleh melebihi 15.000 karakter.
      value	Nilai sampel suatu metrik.
      imageUrl	URL grafik garis yang berisi metrik Grafana. URL ini digunakan untuk memetakan grafik garis.
      check	Item pemeriksaan alert. Contoh: CPU, JVM, Application Crash, dan Deployment.
      source	Sumber alert.
      class	Jenis objek yang memicu event alert, misalnya host.
      service	Layanan sumber alert. Contoh: Login Service.
      startat	Timestamp yang menunjukkan waktu mulai event.
      endat	Timestamp yang menunjukkan waktu akhir event.
      generatorUrl	URL detail event.

7. Konfigurasikan deduplikasi bidang untuk event alert.

   Untuk mengurangi data duplikat, sistem menggunakan bidang-bidang terkait sebagai dasar deduplikasi. ARMS Alert Management memungkinkan Anda melihat pratinjau hasil pengelompokan deduplikasi data event historis yang ditampilkan di bagian Event Mapping. Anda dapat mengubah bidang yang akan dideduplikasi.

   Catatan

   Anda hanya dapat mengonfigurasi deduplikasi untuk event yang belum dihapus.

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

      Jika beberapa event memiliki nilai yang sama untuk bidang yang ditentukan, event tersebut akan digabung menjadi satu notifikasi alert.

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

      Catatan

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

8. Setelah mengonfigurasi pengaturan, klik Save.

Lihat detail event alert

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

2. Di halaman Alert Event History, klik nama event alert untuk melihat detail event tersebut. Untuk informasi selengkapnya, lihat View alert event history.

Kelola integrasi

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

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

• Perbarui kunci: Untuk integrasi yang ingin Anda ubah, pilih More > Update Key di kolom Actions, lalu klik Confirm di kotak dialog yang muncul.
  Penting Setelah memperbarui kunci, Anda harus mengubah file alarm-settings.yml seperti yang dijelaskan di Langkah 2.

• Ubah integrasi: Temukan integrasi tersebut lalu klik Edit di kolom Actions. Di halaman Integration Details, ubah informasi integrasi lalu klik Save.

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

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

• Tambahkan alur pemrosesan event ke integrasi: Temukan integrasi tersebut lalu klik Add Event Processing Flow di kolom Actions. Untuk informasi selengkapnya, lihat Event processing flow.

• Buat kebijakan notifikasi: Temukan integrasi yang ingin Anda buat kebijakan notifikasinya, lalu klik More di kolom Actions. Di daftar yang muncul, klik Create Notification Policy. Untuk informasi selengkapnya, lihat Notification policies.