All Products
Search

This Product

    Application Real-Time Monitoring Service:Integrasikan peringatan Prometheus yang dikelola sendiri

    Document Center

    Application Real-Time Monitoring Service:Integrasikan peringatan Prometheus yang dikelola sendiri

    Last Updated:Aug 25, 2026

    Integrasi Prometheus di ARMS Alert Management menerima event peringatan dari instans Prometheus yang dikelola sendiri dan mengarahkannya melalui pipeline peringatan ARMS. Anda dapat menghubungkan instans Prometheus yang dikelola oleh Prometheus-Operator atau penerapan mandiri lainnya.

    Informasi latar belakang

    Prometheus open source melaporkan peringatan ke Alertmanager. Konfigurasikan <alertmanager_config> dalam file Prometheus.yaml untuk mengirim peringatan ke ARMS Alert Management. Untuk referensi konfigurasi, lihat [alertmanager_config].

    ARMS Alert Management menyediakan titik akhir yang kompatibel dengan Alertmanager untuk Prometheus open source. Saat Anda membuat integrasi Prometheus, ARMS Alert Management menghasilkan alamat integrasi dan bearer token yang digunakan oleh instans Prometheus Anda untuk mengirim peringatan.

    Prasyarat

    • Akses ke Konsol ARMS. Anda memperoleh bearer token untuk otentikasi dari halaman pengaturan integrasi setelah membuat integrasi tersebut.

    • Untuk metode Prometheus-Operator: kubectl telah terinstal dan dikonfigurasi dengan akses ke kluster Kubernetes Anda.

    • Untuk instans Prometheus mandiri lainnya: akses tulis ke file konfigurasi prometheus.yaml pada host Prometheus Anda.

    Langkah 1: Buat integrasi dan hubungkan instans Prometheus yang dikelola sendiri

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

    • Alert IntegrationPrometheus

    1. Pada kotak dialog New Prometheus Integration, masukkan nama dan deskripsi integrasi Prometheus serta waktu pemulihan otomatis untuk event peringatan, lalu klik Save.

      Catatan

      Waktu pemulihan otomatis setelah timeout: Jika event peringatan tidak dipicu lagi dalam periode tertentu, event tersebut akan dihapus secara otomatis.

      Prometheus instances managed by Prometheus-OperatorOther Self-managed Prometheus InstancesOK

    Prometheus instances managed by Prometheus-Operator

    • Buat file arms-alertmanager-config.yaml di mesin lokal Anda, lalu tempel konten berikut ke dalam file tersebut.

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

    Dapatkan nilai bearer_token dari Konsol ARMS setelah integrasi dibuat. Ganti ****** dengan token aktual.

    • Gunakan file arms-alertmanager-config.yaml untuk membuat secret bernama arms-am-config.

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

    • Buat file prometheus-patch.yaml di mesin lokal Anda, lalu tempel konten berikut ke dalam file tersebut.

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

    • Jalankan perintah berikut untuk mendapatkan objek Prometheus.

    kubectl get prometheus

    Contoh respons:

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

    • Jalankan perintah berikut untuk menerapkan file prometheus-patch.yaml ke objek Prometheus. Ganti prometheus-operator-160879-prometheus dengan nama yang dikembalikan pada langkah sebelumnya.

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

    Other Self-managed Prometheus Instances

    • Modifikasi file konfigurasi prometheus.yaml.

      Contoh berikut berlaku untuk Prometheus 2.x. Untuk format konfigurasi versi lainnya, lihat dokumentasi Prometheus.
    alerting:
  alertmanagers:
  - api_version: v1
    authorization:
      type: Bearer
      credentials: <bearer_token>
    scheme: https
    static_configs:
    - targets: ["alerts.aliyuncs.com"]
    Catatan

    Dapatkan bearer token dari Konsol ARMS. Ganti <bearer_token> dengan nilai token aktual.

    • Buka halaman konfigurasi Prometheus di browser Anda dan verifikasi bahwa bagian alerting berisi konfigurasi Alertmanager dengan target alerts.aliyuncs.com.

    Integrasikan sistem observabilitas lain yang kompatibel dengan Prometheus ke ARMS Alert Management

    Thanos menggunakan parameter --alertmanagers.config dari perintah thanos rule untuk menentukan file konfigurasi Alertmanager. Masukkan alamat integrasi dan token seperti yang dijelaskan pada langkah-langkah sebelumnya. Untuk informasi lebih lanjut tentang konfigurasi, lihat dokumentasi Thanos.

    VictoriaMetric menggunakan parameter -notifier.config dari perintah ./bin/vmalert untuk menentukan file konfigurasi notifier. Masukkan alamat integrasi dan token seperti yang dijelaskan pada langkah-langkah sebelumnya. Untuk informasi lebih lanjut tentang konfigurasi, lihat dokumentasi VictoriaMetric.

    (Opsional) Edit integrasi

    ARMS Alert Management telah menetapkan pemetaan bidang antara sumber peringatan Prometheus yang dikelola sendiri dan ARMS Alert Management. Anda dapat menambahkan atau mengubah pemetaan bidang tersebut di halaman Edit Integration sesuai kebutuhan.

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

  • Di bagian Event Mapping, klik Send Test Data.

  • Pada kotak dialog Send Test Data, masukkan konten peringatan dari sumber peringatan 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 peringatan belum dipetakan ke bidang event peringatan ARMS. Data yang dikirim akan ditampilkan di kotak sebelah kiri, sehingga Anda dapat memilih bidang sumber saat mengonfigurasi pemetaan.

    • Jika muncul pesan Uploaded., konten peringatan dilaporkan ke halaman Alert Event History. Untuk informasi lebih lanjut, lihat View alert event history.

  • Pada kotak dialog Send Test Data, klik Disable.

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

    • Di sisi kanan bagian Event Mapping

  • Opsional:Pada bagian Select Root Node, tentukan apakah akan mengaktifkan pemrosesan batch.

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

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

    Catatan

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

  • Pada 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 pembatas untuk menggabungkan beberapa bidang sumber peringatan menjadi satu bidang, lalu memetakan bidang tersebut ke bidang peringatan ARMS yang ditentukan. Hanya karakter khusus yang dapat digunakan sebagai pembatas.

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

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

    Tabel berikut menjelaskan bidang peringatan ARMS.

    Alert field

    Description

    alertname

    Nama peringatan kustom.

    severity

    Tingkat keparahan peringatan. Anda harus mengonfigurasi pemetaan untuk bidang ini. Metode pemetaan harus diatur ke Direct.

    message

    Deskripsi peringatan. Deskripsi ini digunakan sebagai isi pesan peringatan. Panjang deskripsi tidak boleh melebihi 15.000 karakter.

    value

    Nilai sampel metrik.

    imageUrl

    URL grafik garis yang berisi metrik Grafana. URL ini digunakan untuk memetakan grafik garis.

    check

    Item pemeriksaan peringatan. Contoh: CPU, JVM, Application Crash, dan Deployment.

    source

    Sumber peringatan.

    class

    Jenis objek yang memicu event peringatan, misalnya host.

    service

    Layanan sumber peringatan. Contoh: Login Service.

    startat

    Timestamp yang menunjukkan waktu mulai event.

    endat

    Timestamp yang menunjukkan waktu akhir event.

    generatorUrl

    URL detail event.

  • Konfigurasikan deduplikasi bidang untuk event peringatan.

    Untuk mengurangi data duplikat, sistem menggunakan 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 tertentu, event tersebut akan digabung 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 bagian Event Mapping.

  • Setelah mengonfigurasi pengaturan, klik Save.

    • Lihat detail event peringatan

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

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

    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 yang dimaksud, lalu klik barisnya. Pada halaman Integration Details, Anda dapat melihat detail integrasi tersebut.

    • Untuk memperbarui kunci integrasi, pada kolom Actions di sisi kanan integrasi target, pilih More > Update Key. Pada kotak dialog yang muncul, klik Confirm.

    Penting

    Setelah memperbarui kunci, konfigurasi ulang instans Prometheus yang dikelola sendiri menggunakan kunci baru tersebut. Untuk informasi selengkapnya, lihat Configure Prometheus.

  • Ubah integrasi: Temukan integrasi yang dimaksud, lalu klik Edit pada kolom Actions. Pada halaman Integration Details, perbarui informasi integrasi tersebut, kemudian klik Save.

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

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

  • Tambahkan alur pemrosesan event ke integrasi: Temukan integrasi tersebut, lalu klik Add Event Processing Flow pada 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. Pada daftar yang muncul, klik Create Notification Policy. Untuk informasi selengkapnya, lihat Notification policies.

    • Langkah selanjutnya

    Setelah membuat kebijakan notifikasi, sistem akan menghasilkan peringatan dan mengirimkan notifikasi untuk event peringatan yang dilaporkan berdasarkan kebijakan tersebut. Untuk informasi selengkapnya, lihat Notification policies. Di halaman Alert Sending History, Anda dapat melihat peringatan yang dihasilkan berdasarkan kebijakan notifikasi yang telah dikonfigurasi. Untuk informasi lebih lanjut, lihat View alert sending history.