Application Real-Time Monitoring Service：Integrasikan sumber peringatan kustom dengan ARMS

Quick start: muatan minimal

Kirim muatan sekecil mungkin untuk memverifikasi konektivitas:

curl -k -H "Content-Type: application/json" -d '{
  "alertname": "test-alert",
  "severity": "P2",
  "message": "Test alert from custom source"
}' "https://alerts.aliyuncs.com/api/v1/integrations/custom/<your-api-key>"

Ganti <your-api-key> dengan Kunci API yang disalin pada langkah sebelumnya.

Contoh muatan lengkap

Perintah curl berikut mengirim event alert lengkap untuk skenario terjadinya error paket TCP pada server. Muatan mencakup metadata bersarang dan array equipments:

curl -k -H "Content-Type: application/json" -d '{
  "trigger-type": "network",
  "trigger-location": "cn-hangzhou",
  "trigger-severity": "MAX",
  "trigger-policy": "package errors > 5%",
  "trigger-event": "inbound tcp package errors is 20%",
  "trigger-check": "tcp package error percentage",
  "trigger-value": "20",
  "trigger-time": "1629702922000",
  "metadata": [
    {
      "agent": "SERVER",
      "ip": "141.219.XX.XX",
      "fqdn": "websrv1.damenport.org",
      "microServiceId": "ms-login-2251",
      "accountId": "1504000433993",
      "service": "login-0"
    },
    {
      "agent": "CONTAINER",
      "ip": "172.1.XX.XX",
      "fqdn": "websrv2.damenport.org",
      "microServiceId": "ms-login-2252",
      "accountId": "129930302939",
      "service": "login-1"
    }
  ],
  "equipments": [
    {
      "equipmentId": "112"
    },
    {
      "equipmentId": "113"
    }
  ]
}' "https://alerts.aliyuncs.com/api/v1/integrations/custom/<your-api-key>"

Tabel berikut menjelaskan field utama dalam muatan ini:

Ganti placeholder berikut dengan nilai aktual Anda:

Kirim data uji

1. Pada halaman Integration Details, di bagian Event Mapping, klik Send Test Data.

2. Pada kotak dialog Send Test Data, tempel muatan JSON dari sumber alert Anda dan klik Send.

   • Jika muncul pesan Uploaded. No events are generated. Configure mappings based on the original data., artinya field belum dipetakan. Data mentah akan muncul di panel kiri sebagai referensi saat mengonfigurasi pemetaan.

   • Jika muncul pesan Uploaded., artinya event berhasil dilaporkan. Lihat event tersebut di halaman Alert Event History. Untuk informasi lebih lanjut, lihat View historical alert events.

   

3. Pada kotak dialog Send Test Data, klik Disable.

Konfigurasikan pemrosesan batch (opsional)

Jika data alert Anda berisi node array (seperti metadata), Anda dapat memproses semua elemen dalam array tersebut sebagai batch.

1. Di panel kiri bagian Event Mapping, klik catatan data untuk melihat detailnya.

2. Di panel kanan, di bawah Select Root Node, pilih Use Batch Processing, lalu pilih node array yang akan digunakan sebagai root node.

Cara pemrosesan batch memengaruhi pemetaan field:

• Batch diaktifkan (misalnya, metadata sebagai root node): Semua nilai $.metadata[*].service dipetakan secara iteratif ke field ARMS target.

• Batch dinonaktifkan: Hanya elemen tertentu (misalnya, $.metadata[0].service atau $.metadata[1].service) yang dipetakan ke field target.

Konfigurasikan event pemulihan alert (opsional)

Untuk secara otomatis menghapus alert ketika event pemulihan tiba, pilih Configure Alert Recovery Events dan definisikan kondisi field.

Ketika ARMS menerima event yang sesuai dengan kondisi Anda, ARMS akan menemukan dan menghapus alert yang sesuai. Field kondisi harus setara dengan severity alert dalam event tersebut. Field $.severity tidak dapat digunakan.

Sebagai contoh, kondisi {$.eventType = "resolved"} akan menghapus semua alert dalam integrasi di mana field eventType bernilai resolved.

Petakan field sumber ke field alert ARMS

Di bagian Map Source Fields to Target Fields, petakan setiap field sumber ke field alert ARMS.

Tabel berikut menjelaskan field alert ARMS:

Metode pemetaan

Klik ikon Map di samping field untuk beralih antara metode pemetaan berikut:

• Direct: Memetakan satu field sumber langsung ke satu field ARMS.

• Series: Menggabungkan beberapa field sumber dengan pembatas (hanya karakter khusus) menjadi satu nilai, lalu memetakannya ke field ARMS. Misalnya, menggabungkan $.trigger-type dan $.trigger-policy dengan garis bawah (_) menghasilkan network_package errors > 5%, yang dipetakan ke alertname.

• Condition: Memetakan field sumber berdasarkan kondisi. Misalnya:

  • Jika $.metadata[*].agent bernilai CONTAINER, petakan $.metadata[*].microServiceId ke field ARMS service.

  • Jika $.metadata[*].agent bernilai SERVER, petakan $.metadata[*].service ke field ARMS service.

• Mapping table: Mengonversi nilai sumber ke nilai ARMS melalui tabel lookup. Hanya digunakan untuk field severity.