Serverless App Engine:Manage contacts

Create a contact

Buka halaman manajemen kontak terlebih dahulu: masuk ke Konsol SAE, buka Applications > Applications, pilih Wilayah dan namespace Anda, klik nama aplikasi, lalu pilih Notifications and Alerts > Contact Management di panel navigasi sebelah kiri.

1. Pada halaman Notification Objects, buka tab Contacts dan klik Create Contact.

2. Pada kotak dialog Create Contact, isi detail kontak dan klik OK.

   Tentukan minimal salah satu dari Phone number atau Email. Setiap nomor telepon dan alamat email hanya dapat dimiliki oleh satu kontak. Untuk mengatur chatbot DingTalk, gunakan tab DingTalk/Lark/WeCom sebagai gantinya.

   Parameter	Description
   Name	Nama kontak.
   Phone number	Mengaktifkan notifikasi panggilan telepon dan pesan teks. Hanya nomor telepon yang telah diverifikasi yang dapat digunakan dalam kebijakan notifikasi. Lihat Verify phone numbers.
   Email	Mengaktifkan notifikasi email.
   Contact group	Kelompok kontak tempat kontak ini akan ditambahkan. Lihat Create a contact group.
   Method to resend notifications if phone notifications fail	Metode cadangan ketika panggilan telepon gagal. Atur default global untuk semua kontak di bawah More > Contact Default Configuration pada tab Contacts.
   User ID	Pengidentifikasi yang digunakan untuk pemrosesan data dan kueri.

Setelah membuat kontak, cari, edit, atau hapus kontak tersebut pada tab Contacts.

Verify phone numbers

Nomor telepon harus diverifikasi sebelum dapat digunakan dalam kebijakan notifikasi. Kode verifikasi dikirim ke nomor telepon yang sedang diverifikasi—kontak harus memiliki akses ke nomor tersebut untuk menyelesaikan verifikasi.

1. Pada tab Contacts halaman Notification Objects, pilih kontak yang nomornya ingin Anda verifikasi: SAE akan mengirimkan pesan teks berisi tautan verifikasi ke setiap nomor yang dipilih.

   • Untuk memverifikasi satu nomor, temukan kontak tersebut dan klik Not Verified di samping nomor telepon.

   • Untuk memverifikasi beberapa nomor sekaligus, pilih kontak-kontak tersebut dan klik Batch Verify.

2. Setiap kontak membuka URL dari pesan teks tersebut di browser.

3. Pada halaman verifikasi, kontak memeriksa nomor tersebut dan mengklik Verify.

Set the default fallback method

Ketika notifikasi telepon gagal, SAE menggunakan metode cadangan untuk mengirim ulang peringatan. Atur default global untuk semua kontak:

1. Pada tab Contacts halaman Notification Objects, pilih More > Contact Default Configuration.

2. Pilih metode cadangan dan klik OK.

Kontak individual dapat mengganti default ini dengan menggunakan parameter Method to resend notifications if phone notifications fail saat membuat atau mengedit kontak.

Prerequisites

Harus sudah ada minimal satu kontak. Lihat Create a contact.

Create a contact group

1. Pada tab Contacts halaman Notification Objects, klik Create Contact Group.

2. Pada kotak dialog Create Contact Group, masukkan nama di kolom Group Name, pilih kontak dari daftar Alert Contacts, lalu klik OK.

Kelompok kontak tersebut muncul dalam daftar All Contacts pada tab Contacts.

Manage a contact group

Setelah membuat kelompok kontak, kelola kelompok tersebut dari tab Contacts:

Action	Steps
Edit	Klik > Edit Group di sebelah kanan kelompok. Ubah nama atau anggotanya, lalu klik OK.
View members	Klik ikon di sebelah kiri kelompok.
Delete	Klik > Delete Group di sebelah kanan kelompok, lalu konfirmasi.

Prerequisites

Grup DingTalk dengan chatbot kustom yang telah ditambahkan, serta URL webhook chatbot tersebut. Lihat Get the webhook URL of a DingTalk chatbot.

Add a DingTalk chatbot

1. Pada halaman Notification Objects, klik tab DingTalk/Lark/WeCom, lalu klik DingTalk.

2. Pada panel Create DingTalk chatbot, konfigurasikan parameter dan klik OK.

   Untuk menerima peringatan di grup DingTalk, atur Notification methods menjadi DingTalk dalam kebijakan notifikasi. Lihat Configure a notification policy.

   Parameter	Description
   Name	Nama untuk chatbot DingTalk.
   Signature key	Opsional. Jika ditentukan, DingTalk melakukan autentikasi permintaan menggunakan kunci tanda tangan. Jika dibiarkan kosong, autentikasi menggunakan daftar putih dengan kata kunci Alert.
   Chatbot webhook URL	URL webhook chatbot DingTalk.
   Whether DingTalk chatbot sends daily statistics	Jika diaktifkan, masukkan waktu pengiriman ringkasan harian. Format: HH:SS, dipisahkan koma. Setiap ringkasan mencakup total peringatan yang dihasilkan hari itu, peringatan yang terselesaikan, dan peringatan yang belum terselesaikan.
   Card content configuration	Sesuaikan gaya dan konten kartu pemberitahuan peringatan.

Manage alerts in a DingTalk group

Setelah menerima pemberitahuan peringatan di grup DingTalk, lihat dan kelola peringatan tersebut langsung di grup. Untuk detailnya, lihat Handle alerts in the specified group chat.

Step 1: Get a webhook URL

1. Buka Lark dan masuk.

2. Klik + > New group untuk membuat grup penerima peringatan.

3. Buka Group settings, buka tab BOTs, lalu klik Add Bot.

4. Pilih Custom Bot, atur nama dan deskripsi, lalu klik Add.

5. Salin URL webhook. Di bawah Set keywords, masukkan Alert dan klik Save.

Step 2: Create a webhook in SAE

1. Pada halaman Notification Objects, buka tab Webhook Integration dan klik Create Webhook.

2. Pada panel Create Webhook, konfigurasikan parameter. Contoh templat notifikasi (Lark):

   Parameter	Description
   Webhook name	Nama webhook.
   Post/Get	Metode permintaan. URL tidak boleh melebihi 100 karakter. Untuk Lark, pilih Post dan tempel URL webhook dari Langkah 1.
   Header/Param	Header permintaan atau parameter tambahan. Maksimal 6 entri total; maksimal 200 karakter gabungan. Header default adalah Content-Type: text/plain; charset=UTF-8. Untuk Lark, tambahkan Arms-Content-Type: json dan Content-Type: application/json.
   Notification template	Isi pesan yang dikirim saat peringatan dipicu (hanya POST). Gunakan $content sebagai placeholder untuk konten peringatan. Maksimal 500 karakter. Lihat Configure a notification template and a webhook template.
   Template to clear alerts	Isi pesan yang dikirim saat peringatan terselesaikan (hanya POST). Maksimal 500 karakter.

   {
     "msg_type": "text",
     "content": {
       "text": "Nama peringatan: {{ .commonLabels.alertname }}\n{{if .commonLabels.clustername }}Nama kluster: {{ .commonLabels.clustername }}\n{{ end }}{{if eq \"app\" .commonLabels._aliyun_arms_involvedObject_kind }}Nama aplikasi: {{ .commonLabels._aliyun_arms_involvedObject_name }}\n{{ end }}Waktu saat peringatan diselesaikan: {{ .endTime }} \nKebijakan notifikasi: {{ .dispatchRuleName }} \nIsi notifikasi: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
     }
   }

   Contoh templat untuk menghapus peringatan (Lark):

   {
     "msg_type": "text",
     "content": {
       "text": "Alert name: {{ .commonLabels.alertname }}\n{{if .commonLabels.clustername }}Cluster name: {{ .commonLabels.clustername }}\n{{ end }}{{if eq \"app\" .commonLabels._aliyun_arms_involvedObject_kind }}Application name: {{ .commonLabels._aliyun_arms_involvedObject_name }}\n{{ end }}Time when the alert is resolved: {{ .endTime }} \nNotification policy: {{ .dispatchRuleName }} \nNotification content: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
     }
   }

3. Klik Send Test untuk memverifikasi webhook berfungsi, lalu klik OK.

   Webhook memiliki timeout 5 detik. Jika tidak ada tanggapan dalam 5 detik, notifikasi gagal.

Step 3: Attach the webhook to a notification policy

Saat membuat atau mengedit kebijakan notifikasi, atur Notification object menjadi Universal Webhook dan pilih webhook Anda. Untuk detailnya, lihat Configure a notification policy.