全部产品
Search
文档中心

Serverless App Engine:Kelola kontak

更新时间:Jul 06, 2025

Ketika aturan dalam kebijakan notifikasi dipicu, Serverless App Engine (SAE) mengirimkan notifikasi peringatan kepada kontak yang telah ditentukan. Topik ini menjelaskan cara mengonfigurasi kontak, grup kontak, chatbot DingTalk, serta mendapatkan URL webhook dari chatbot DingTalk untuk membuat peringatan webhook.

Kontak

Buat kontak

  1. Masuk ke Konsol SAE. Di panel navigasi kiri, pilih Applications > Applications. Pada halaman yang muncul, pilih wilayah di bilah navigasi atas dan namespace dari daftar drop-down Namespace, lalu klik nama aplikasi yang diinginkan.

  2. Di panel navigasi kiri, pilih Notifications and Alerts > Contact Management.

  3. Pada tab Contacts halaman Notification Objects, klik Create Contact.

  4. Dalam kotak dialog Create Contact, konfigurasikan parameter dan klik OK. Tabel berikut menjelaskan parameter tersebut.

    Parameter

    Deskripsi

    Name

    Nama kontak.

    Phone Number

    Setelah Anda menentukan nomor telepon seluler kontak, kontak tersebut dapat diberitahu melalui panggilan telepon dan pesan teks.

    Catatan

    Anda hanya dapat menentukan nomor telepon seluler yang telah diverifikasi dalam kebijakan notifikasi. Untuk informasi lebih lanjut, lihat Verifikasi nomor telepon seluler.

    Email

    Setelah Anda menentukan alamat email kontak, kontak tersebut dapat diberitahu melalui email.

    Contact Group

    Pilih grup kontak tempat Anda ingin menambahkan kontak. Untuk informasi tentang cara membuat grup kontak, lihat Grup kontak.

    Method to Resend Notifications If Phone Notifications Fail

    Pilih metode untuk mengirim ulang notifikasi jika notifikasi telepon gagal. Anda dapat menentukan pengaturan default global untuk parameter ini pada tab Contacts. Untuk informasi lebih lanjut, lihat Tentukan metode default untuk mengirim ulang notifikasi.

    User ID

    ID pengguna digunakan untuk mengidentifikasi pengguna yang berbeda dan memberikan kemudahan dalam memproses data, menanyakan informasi, atau melakukan operasi lainnya.

    Catatan
    • Anda harus menentukan setidaknya salah satu parameter Phone Number atau Email. Setiap nomor telepon atau alamat email hanya dapat digunakan untuk satu kontak.

    • Jika ingin membuat chatbot DingTalk, buat chatbot pada tab DingTalk/Lark/WeCom. Untuk informasi lebih lanjut, lihat Chatbot DingTalk.

    Setelah membuat kontak, Anda dapat mencari, memodifikasi, atau menghapus kontak pada tab Contacts.

Verifikasi nomor telepon seluler

Sebelum menentukan nomor telepon dalam kebijakan notifikasi, Anda harus memverifikasinya.

  1. Masuk ke Konsol SAE. Di panel navigasi kiri, pilih Applications > Applications. Pada halaman yang muncul, pilih wilayah di bilah navigasi atas dan namespace dari daftar drop-down Namespace, lalu klik nama aplikasi yang diinginkan.

  2. Di panel navigasi kiri, pilih Notifications and Alerts > Contact Management.

  3. Pada tab Contacts halaman Notification Objects, pilih satu atau beberapa kontak untuk memverifikasi nomor telepon seluler mereka.

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

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

    Sistem akan mengirimkan pesan teks kepada kontak-kontak tersebut untuk memverifikasi nomor telepon seluler mereka.

  4. Kontak menggunakan browser untuk mengunjungi URL dalam pesan teks.

  5. Pada halaman verifikasi yang muncul, mereka memeriksa nomor dan klik Verify.

Tentukan metode default untuk mengirim ulang notifikasi

Anda dapat menentukan metode default untuk mengirim ulang notifikasi jika notifikasi telepon gagal.

  1. Masuk ke Konsol SAE. Di panel navigasi kiri, pilih Applications > Applications. Pada halaman yang muncul, pilih wilayah di bilah navigasi atas dan namespace dari daftar drop-down Namespace, lalu klik nama aplikasi yang diinginkan.

  2. Di panel navigasi kiri, pilih Notifications and Alerts > Contact Management.

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

  4. Dalam kotak dialog yang muncul, pilih metode untuk mengirim ulang notifikasi dan klik OK.

Grup kontak

Saat membuat kebijakan notifikasi, Anda dapat menentukan grup kontak sebagai objek notifikasi. Jika aturan dalam kebijakan notifikasi dipicu, modul Manajemen Peringatan SAE mengirimkan notifikasi peringatan kepada kontak dalam grup kontak melalui panggilan telepon, pesan teks, email, atau chatbot DingTalk.

Prasyarat

Kontak telah dibuat. Untuk informasi lebih lanjut, lihat Buat Kontak.

Buat grup kontak

  1. Masuk ke Konsol SAE. Di panel navigasi kiri, pilih Applications > Applications. Pada halaman yang muncul, pilih wilayah di bilah navigasi atas dan namespace dari daftar drop-down Namespace, lalu klik nama aplikasi yang diinginkan.

  2. Di panel navigasi kiri, pilih Notifications and Alerts > Contact Management.

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

  4. Dalam kotak dialog Create Contact Group, masukkan nama grup di bidang Group Name, pilih kontak dalam daftar Alert Contacts, lalu klik OK.

    Setelah membuat grup kontak, grup tersebut akan ditampilkan dalam daftar All Contacts pada tab Contacts.

Kelola grup kontak

Setelah membuat grup kontak, Anda dapat mencari, memodifikasi, atau menghapus grup kontak pada tab Contacts.

  • Untuk memodifikasi grup kontak, pilih 更多图标 > Edit Group di sebelah kanan grup kontak. Dalam kotak dialog yang muncul, modifikasi nama atau kontak grup, lalu klik OK.

  • Untuk melihat kontak dalam grup kontak, klik ikon Down arrow di sebelah kiri grup kontak.

  • Untuk menghapus grup kontak, pilih 更多图标 > Delete Group di sebelah kanan grup kontak. Dalam pesan yang muncul, klik OK.

    Penting
    • Sebelum menghapus grup kontak, pastikan bahwa grup tersebut tidak ditambahkan ke kebijakan notifikasi. Jika tidak, pengiriman notifikasi peringatan mungkin gagal.

    • Anda hanya dapat menghapus grup kontak yang dibuat menggunakan akun saat ini.

Chatbot DingTalk

Setelah membuat chatbot DingTalk untuk fitur manajemen peringatan di SAE, Anda dapat menentukan grup DingTalk yang sesuai untuk menerima notifikasi peringatan dalam kebijakan notifikasi. Jika aturan dalam kebijakan notifikasi dipicu, sistem secara otomatis mengirimkan notifikasi peringatan ke grup DingTalk yang telah ditentukan. Setelah menerima notifikasi peringatan di grup DingTalk, Anda dapat mengelola peringatan di grup tersebut.

Buat grup DingTalk yang digunakan untuk menerima notifikasi peringatan di Konsol SAE

  1. Buat chatbot kustom di grup DingTalk yang Anda buat di klien DingTalk Anda dan dapatkan URL webhook dari chatbot tersebut. Untuk informasi lebih lanjut, lihat Dapatkan URL Webhook Chatbot DingTalk.

  2. Masuk ke Konsol SAE. Di panel navigasi kiri, pilih Applications > Applications. Pada halaman yang muncul, pilih wilayah di bilah navigasi atas dan namespace dari daftar drop-down Namespace, lalu klik nama aplikasi yang diinginkan.

  3. Di panel navigasi kiri, pilih Notifications and Alerts > Contact Management. Pada halaman Notification Objects, klik tab DingTalk/Lark/WeCom, lalu klik DingTalk.

  4. Dalam panel Create DingTalk Chatbot, konfigurasikan parameter dan klik OK. Tabel berikut menjelaskan parameter tersebut.

    Catatan

    Untuk menerima notifikasi peringatan di grup DingTalk, Anda harus menyetel parameter Notification Methods ke DingTalk dalam kebijakan notifikasi. Untuk informasi lebih lanjut, lihat Konfigurasikan Kebijakan Notifikasi.

    Parameter

    Deskripsi

    Nama

    Tentukan nama untuk chatbot DingTalk.

    Kunci Tanda Tangan

    Opsional. Jika Anda menentukan kunci tanda tangan, autentikasi DingTalk dilakukan menggunakan kunci tanda tangan. Jika Anda tidak menentukan kunci tanda tangan, daftar putih digunakan untuk autentikasi secara default. Kata kunci daftar putih adalah Peringatan.

    URL Webhook Chatbot DingTalk

    Masukkan URL webhook chatbot DingTalk.

    Apakah Chatbot DingTalk Mengirim Statistik Harian

    Jika Anda memilih opsi ini, Anda harus memasukkan waktu pengiriman statistik harian. Pisahkan beberapa waktu dengan koma (,). Tentukan waktu dalam format HH:SS. Informasi yang dikirim ARMS pada waktu yang ditentukan termasuk jumlah total peringatan yang dihasilkan pada hari itu, jumlah peringatan yang diselesaikan, dan jumlah peringatan yang harus diselesaikan.

    Konfigurasi Konten Kartu

    Kustomisasi gaya dan konten kartu notifikasi peringatan.

Kelola peringatan di grup DingTalk

Setelah menerima notifikasi peringatan di grup DingTalk, Anda dapat melihat dan mengelola peringatan terkait di grup tersebut. Untuk informasi lebih lanjut, lihat Tangani Peringatan di Obrolan Grup Tertentu.

Dapatkan URL webhook chatbot DingTalk

Sebelum mengonfigurasi chatbot DingTalk untuk grup DingTalk atau kontak untuk menerima notifikasi peringatan, Anda harus mendapatkan URL webhook chatbot DingTalk di grup DingTalk Anda. Bagian ini menjelaskan cara mendapatkan URL webhook chatbot DingTalk.

  1. Jalankan klien DingTalk di PC, buka grup DingTalk tempat Anda ingin menambahkan chatbot, dan klik ikon Group Settings di pojok kanan atas.

  2. Di panel Group Settings, klik Bot. Di panel Manajemen Robot, klik Add Robot.

  3. Di kotak dialog Robot, klik Add Robot, lalu klik Custom. image.png

  4. Di kotak dialog Robot, klik Add Robot. Lalu, pilih Custom.

  5. Di kotak dialog Robot details, klik Add.

  6. Di kotak dialog Add Robot, lakukan langkah-langkah berikut:

    1. Tentukan gambar profil dan nama untuk chatbot.

    2. Pilih Custom Keywords untuk parameter Security Settings. Lalu, tentukan SAE sebagai kata kunci.

    3. Baca syarat layanan dan pilih I have read and accepted <<DingTalk Custom Robot Service Terms of Service>>.

    4. Klik Finished.

      Catatan

      Untuk informasi lebih lanjut tentang chatbot DingTalk, lihat Chatbot Kustom.

  7. Di kotak dialog Add Robot, salin URL webhook chatbot DingTalk dan klik Finished.

Gunakan webhook untuk mengirim notifikasi peringatan kustom

Saat membuat kebijakan notifikasi, Anda dapat menentukan URL webhook kustom untuk menerima notifikasi peringatan. Modul Manajemen Peringatan SAE memungkinkan Anda mengirim notifikasi peringatan ke grup Lark, WeChat, dan DingTalk menggunakan URL webhook. Topik ini menjelaskan cara menggunakan webhook untuk mengirim notifikasi peringatan ke grup Lark.

Langkah 1: Dapatkan URL webhook

  1. Buka dan masuk ke Lark.

  2. Klik ikon + lalu klik New group untuk membuat grup Lark yang digunakan untuk menerima notifikasi peringatan.

  3. Klik ikon Pengaturan Grup. Lalu, klik tab BOTs. Pada tab BOTs, klik Add Bot.

  4. Di panel Add Bot, pilih Custom Bot. Lalu, konfigurasikan parameter Bot name dan Description dan klik Add.

  5. Salin URL webhook, pilih Set keywords, masukkan kata kunci Alert, lalu klik Save.

Langkah 2: Buat webhook

  1. Masuk ke Konsol SAE. Di panel navigasi kiri, pilih Applications > Applications. Pada halaman yang muncul, pilih wilayah di bilah navigasi atas dan namespace dari daftar drop-down Namespace, lalu klik nama aplikasi yang diinginkan.

  2. Di panel navigasi kiri, pilih Notifications and Alerts > Contact Management.

  3. Pada tab Webhook Integration halaman Notification Objects, klik Create Webhook.

  4. Di panel Create Webhook, konfigurasikan parameter dan klik OK. Tabel berikut menjelaskan parameter tersebut.

  5. Setelah mengonfigurasi pengaturan, klik Send Test untuk memeriksa apakah webhook dikonfigurasi. Lalu, klik OK.

    Parameter

    Deskripsi

    Webhook Name

    Nama webhook.

    Post/Get

    Metode permintaan. URL tidak boleh melebihi 100 karakter.

    Dalam contoh ini, Post dipilih, dan URL webhook yang disalin di Langkah 1: Dapatkan URL webhook ditempelkan.

    Header/Param

    Header permintaan. Panjangnya tidak boleh melebihi 200 karakter. Klik Add untuk menambahkan header atau parameter. Header permintaan default adalah Content-Type: text/plain; charset=UTF-8. Jumlah total header dan parameter tidak boleh melebihi enam.

    Dalam contoh ini, header berikut digunakan:

    • Arms-Content-Type: json

    • Content-Type: application/json

    Notification Template

    Template notifikasi yang digunakan saat peringatan dipicu. Parameter ini hanya tersedia jika Anda memilih Post. Anda dapat menggunakan placeholder $content untuk menentukan konten notifikasi. Kontennya tidak boleh melebihi 500 karakter. Untuk informasi lebih lanjut, lihat Konfigurasikan template notifikasi dan template webhook.

    Tentukan template notifikasi dalam format berikut:

    {
    "Nama Peringatan":"{{ .commonLabels.alertname }}{{if .commonLabels.clustername }}",
    "Nama Kluster":"{{ .commonLabels.clustername }} {{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}",
    "Nama Aplikasi":"{{ .commonLabels._aliyun_arms_involvedObject_name }} {{ end }}",
    "Kebijakan Notifikasi":"{{ .dispatchRuleName }}",
    "Waktu Peringatan":"{{ .startTime }}",
    "Konten Notifikasi":"{{ for .alerts }} {{ .annotations.message }} {{ end }}"
    }

    Dalam contoh ini, Anda dapat menentukan konten notifikasi dalam format berikut untuk Lark:

    {
      "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 }}Kebijakan Notifikasi: {{ .dispatchRuleName }} \nWaktu Peringatan: {{ .startTime }} \nKonten Notifikasi: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
      }
    }

    Template to Clear Alerts

    Template notifikasi yang digunakan saat peringatan dihapus. Parameter ini hanya tersedia jika Anda memilih Post. Anda dapat menggunakan placeholder $content untuk menentukan konten notifikasi. Kontennya tidak boleh melebihi 500 karakter. Untuk informasi lebih lanjut, lihat Konfigurasikan template notifikasi dan template webhook.

    Tentukan template notifikasi dalam format berikut:

    {
    "Nama Peringatan":"{{ .commonLabels.alertname }}{{if .commonLabels.clustername }}",
    "Nama Kluster":"{{ .commonLabels.clustername }} {{ end }}{{if eq "app" .commonLabels._aliyun_arms_involvedObject_kind }}",
    "Nama Aplikasi":"{{ .commonLabels._aliyun_arms_involvedObject_name }} {{ end }}",
    "Kebijakan Notifikasi":"{{ .dispatchRuleName }}",
    "Waktu Peringatan Diselesaikan":"{{ .endTime }}",
    "Konten Notifikasi":"{{ for .alerts }} {{ .annotations.message }} {{ end }}"
    }

    Dalam contoh ini, Anda dapat menentukan konten notifikasi dalam format berikut untuk Lark:

    {
      "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 Peringatan Diselesaikan: {{ .startTime }} \nKebijakan Notifikasi: {{ .dispatchRuleName }} \nKonten Notifikasi: {{ for .alerts }} {{ .annotations.message }}\n {{ end }}"
      }
    }

Langkah 3: Konfigurasikan kebijakan notifikasi

Saat membuat atau memodifikasi kebijakan notifikasi, setel parameter Notification Object ke Universal Webhook, dan pilih webhook. Untuk informasi lebih lanjut, lihat Konfigurasikan Kebijakan Notifikasi.

Catatan

Batas waktu untuk notifikasi peringatan yang dikirim menggunakan webhook adalah 5 detik. Jika webhook tidak menerima respons dalam 5 detik setelah notifikasi dikirim, pengiriman notifikasi gagal.