Application Real-Time Monitoring Service：Mengintegrasikan Instance Prometheus yang Dikelola Sendiri ke dalam Manajemen Peringatan

Langkah 1: Buat integrasi untuk mengintegrasikan instance Prometheus yang dikelola sendiri

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

2. Di tab Alert Integration, klik Prometheus.

3. Di kotak dialog Create Prometheus Integration, masukkan nama dan deskripsi, tentukan waktu pemulihan otomatis untuk peristiwa peringatan, lalu klik Save.

   Catatan

   Waktu pemulihan otomatis setelah habis waktu: Jika peristiwa peringatan tidak dipicu lagi dalam periode waktu tertentu, peristiwa peringatan akan secara otomatis dibersihkan.

4. Integrasikan instance Prometheus berdasarkan jenis instansinya dan klik OK.

   Prometheus instances managed by using Prometheus-Operator

   1. Buat file bernama arms-alertmanager-config.yaml di server lokal, lalu tempelkan konten berikut ke dalam file tersebut:

      - scheme: https
        bearer_token: ******
        static_configs:
          - targets: ['alerts.aliyuncs.com']

      Catatan

      Anda bisa mendapatkan nilai dari bearer_token di Konsol ARMS.

   2. Buat rahasia bernama arms-am-config menggunakan file arms-alertmanager-config.yaml.

      kubectl create secret generic arms-am-config --from-file=arms-alertmanager-config.yaml

   3. Buat file bernama prometheus-patch.yaml di server lokal, lalu tempelkan konten berikut ke dalam file tersebut:

      spec:
        additionalAlertManagerConfigs:
          key: arms-alertmanager-config.yaml
          name: arms-am-config

   4. Jalankan perintah berikut untuk mendapatkan objek Prometheus:

      kubectl get prometheus

      Contoh respons:

      NAME                                                VERSION   REPLCAS   AGE
      prometheus-operator-160879-prometheus               v2.18.2   1         4d1h

   5. Jalankan perintah berikut untuk memperbarui konten file prometheus-patch.yaml ke objek Prometheus:

      kubectl patch prometheus prometheus-operator-160879-prometheus --patch "$(cat prometheus-patch.yaml)" --type=merge

   Self-managed Prometheus instances created by using other methods

   1. Ubah file konfigurasi prometheus.yaml.

      Dalam contoh ini, instance Prometheus 2.35 diintegrasikan. Untuk informasi tentang versi lain dari instance Prometheus, lihat Dokumentasi Prometheus.

      alerting:
        alertmanagers:
        - api_version: v1
          authorization:
            type: Bearer
            credentials: ${token}
          scheme: https
          static_configs:
          - targets: ["alerts.aliyuncs.com"]

      Catatan

      Anda bisa mendapatkan nilai dari bearer_token di Konsol ARMS.

   2. Kunjungi halaman konfigurasi instance Prometheus di browser Anda dan periksa apakah file prometheus.yaml telah dimodifikasi.

   Sistem Observabilitas Prometheus Lainnya

   Thanos menggunakan parameter --alertmanagers.config dari perintah thanos rule untuk menentukan file konfigurasi Alertmanager. Lakukan langkah-langkah sebelumnya untuk mengonfigurasi alamat dan token untuk integrasi. Untuk informasi lebih lanjut, lihat Dokumentasi Thanos.

   VictoriaMetric menggunakan parameter -notifier.config dari perintah ./bin/vmalert untuk menentukan file konfigurasi notifier. Lakukan langkah-langkah sebelumnya untuk mengonfigurasi alamat dan token untuk integrasi. Untuk informasi lebih lanjut, lihat Dokumentasi VictoriaMetric.

(Opsional) Langkah 2: Modifikasi integrasi

Manajemen Peringatan menyediakan pemetaan bidang antara sumber peringatan Prometheus dan peristiwa peringatan ARMS. Anda juga dapat menambah atau memodifikasi pemetaan antar bidang di halaman Edit Integration.

1. Di 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. Ini memungkinkan Anda memilih bidang sumber saat mengonfigurasi pemetaan.

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

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 peristiwa peringatan ARMS.

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

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

      Setelah Anda memilih Gunakan Pemrosesan Batch, pilih node array yang akan diproses batch sebagai node root.

      Catatan

      Jika beberapa node array ada di 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.

      • Langsung: Bidang tertentu dari sumber peringatan dipetakan langsung ke bidang peringatan ARMS tertentu.

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

      • Kondisional: Bidang sumber peringatan tertentu dipetakan ke bidang peringatan ARMS hanya jika nilai bidang memenuhi kondisi tertentu.

      • Tabel pemetaan: 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 Langsung.
      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 metrik 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 untuk deduplikasi. Manajemen Peringatan ARMS memungkinkan Anda melihat pratinjau 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

      Uji deduplikasi hanya berlaku pada 10 catatan data terbaru yang diunggah di bagian kiri Event Mapping.

8. Setelah Anda mengonfigurasi pengaturan, klik Save.

Lihat detail peristiwa peringatan

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

2. Di halaman Alert Event History, klik nama peristiwa peringatan untuk melihat detail peristiwa. Untuk informasi lebih lanjut, lihat Lihat peristiwa peringatan historis.

Kelola integrasi

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

• 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. Di pesan yang muncul, klik OK.

  Penting

  Setelah kunci diperbarui, Anda harus mengonfigurasi ulang instance Prometheus yang dikelola sendiri. Untuk informasi lebih lanjut, lihat Konfigurasikan instance Prometheus.

• 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. Di 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 Lainnya di kolom Actions. Di daftar yang muncul, klik Create Notification Policy. Untuk informasi lebih lanjut, lihat Buat dan kelola kebijakan notifikasi.