Menggunakan tindakan penskalaan otomatis untuk mengirim pemberitahuan surel dan pemberitahuan webhook di Azure Monitor

Artikel ini memperlihatkan kepada Anda cara menyiapkan pemberitahuan sehingga Anda dapat memanggil URL web tertentu atau mengirim email berdasarkan tindakan skala otomatis di Azure.

Webhook

Webhook memungkinkan Anda mengirim permintaan HTTP ke titik akhir URL tertentu (URL panggilan balik) saat peristiwa atau pemicu tertentu terjadi. Dengan menggunakan webhook, Anda dapat mengotomatiskan dan menyederhanakan proses dengan mengaktifkan pertukaran informasi otomatis antara sistem atau aplikasi yang berbeda. Gunakan webhook untuk memicu kode kustom, pemberitahuan, atau tindakan lain untuk dijalankan saat peristiwa skala otomatis terjadi.

Email

Anda dapat mengirim email ke alamat email yang valid saat peristiwa skala otomatis terjadi. Administrator dan rekan administrator langganan tempat aturan berjalan juga diberi tahu.

Mengonfigurasi Pemberitahuan

Gunakan templat portal Azure, CLI, PowerShell, atau Resource Manager untuk mengonfigurasi pemberitahuan.

Portal

Siapkan pemberitahuan menggunakan portal Azure.

Pilih tab Beri tahu pada halaman pengaturan skala otomatis untuk mengonfigurasi pemberitahuan.

Pilih kotak centang untuk mengirim email ke administrator langganan atau rekan administrator. Anda juga dapat memasukkan daftar alamat email untuk mengirim pemberitahuan.

Masukkan URI webhook untuk mengirim pemberitahuan ke layanan web. Anda juga dapat menambahkan header kustom ke permintaan webhook. Misalnya, Anda dapat menambahkan token autentikasi di header, parameter kueri, atau menambahkan header kustom untuk mengidentifikasi sumber permintaan.

CLI

Gunakan CLI untuk mengonfigurasi pemberitahuan.

az monitor autoscale update Gunakan perintah atau az monitor autoscale create untuk mengonfigurasi pemberitahuan menggunakan Azure CLI.

Parameter berikut digunakan untuk mengonfigurasi pemberitahuan:

• --add-action - Tindakan yang harus diambil ketika aturan skala otomatis dipicu. Nilainya harus sebesar email atau webhook.
• --email-administrator {false, true} - Kirim email ke administrator langganan.
• --email-coadministrators {false, true} - Kirim email ke rekan administrator langganan.
• --remove-action - Hapus tindakan yang sebelumnya ditambahkan oleh --add-action. Nilainya harus sebesar email atau webhook. Parameter hanya relevan untuk az monitor autoscale update perintah .

Misalnya, perintah berikut menambahkan pemberitahuan email dan pemberitahuan webhook ke dan pengaturan skala otomatis yang ada. Perintah ini juga mengirim email ke administrator langganan.

 az monitor autoscale update \
--resource-group <resource group name> \
--name <autoscale setting name> \
--email-administrator true \
--add-action email pdavis@contoso.com \
--add-action webhook http://myservice.com/webhook-listerner-123

Catatan

Anda dapat menambahkan mote dari satu email atau pemberitahuan webhook dengan menggunakan --add-action parameter beberapa kali. Meskipun beberapa pemberitahuan webhook didukung dan dapat dilihat di JSON, portal hanya menampilkan webhook pertama.

Untuk informasi selengkapnya, lihat skala otomatis monitor az.

PowerShell

Gunakan PowerShell untuk mengonfigurasi pemberitahuan.

Contoh berikut menunjukkan cara mengonfigurasi webhook dan pemberitahuan email.

1. Buat objek webhook.

2. Buat objek pemberitahuan.

3. Tambahkan objek pemberitahuan ke pengaturan skala otomatis menggunakan New-AzAutoscaleSetting cmdlet atau Update-AzAutoscaleSetting .

# Assumining you have already created a profile object and have a vmssName, resourceGroup, and subscriptionId

 $webhook=New-AzAutoscaleWebhookNotificationObject  `
-Property @{"method"='GET'; "headers"= '"Authorization", "tokenvalue-12345678abcdef"'} `
-ServiceUri "http://myservice.com/webhook-listerner-123"

$notification=New-AzAutoscaleNotificationObject `
-EmailCustomEmail "pdavis@contoso.com" `
-EmailSendToSubscriptionAdministrator $true ` -EmailSendToSubscriptionCoAdministrator $true `
-Webhook $webhook


New-AzAutoscaleSetting -Name autoscalesetting2 `
-ResourceGroupName $resourceGroup `
-Location eastus `
-Profile $profile `
-Enabled -Notification $notification `
-PropertiesName "autoscalesetting" `
-TargetResourceUri "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/$vmssName"

Resource Manager

Gunakan templat Resource Manager untuk mengonfigurasi pemberitahuan.

Saat Anda menggunakan templat Resource Manager atau REST API, sertakan notifications elemen dalam pengaturan skala otomatis Anda, misalnya:

"notifications": [
      {
        "operation": "Scale",
        "email": {
          "sendToSubscriptionAdministrator": false,
          "sendToSubscriptionCoAdministrators": false,
          "customEmails": [
              "user1@mycompany.com",
              "user2@mycompany.com"
              ]
        },
        "webhooks": [
          {
            "serviceUri": "https://my.webhook.example.com?token=abcd1234",
            "properties": {
              "optional_key1": "optional_value1",
              "optional_key2": "optional_value2"
            }
          }
        ]
      }
    ]

Bidang	Wajib	Deskripsi
operasi	Ya	Nilai harus "Skala."
sendToSubscriptionAdministrator	Ya	Nilai harus "true" atau "false."
sendToSubscriptionCoAdministrators	Ya	Nilai harus "true" atau "false."
customEmails	Ya	Nilainya bisa null [] atau array string email.
webhook	Ya	Nilai dapat berupa URI null atau valid.
serviceUri	Ya	URI HTTPS yang valid.
properti	Ya	Nilai harus kosong {} atau dapat berisi pasangan kunci-nilai.

Autentikasi dalam webhook

Webhook dapat mengautentikasi dengan menggunakan autentikasi berbasis token, tempat Anda menyimpan URI webhook dengan ID token sebagai parameter kueri. Contohnya,https://mysamplealert/webcallback?tokenid=123-abc456-7890&myparameter2=value123.

Skema payload webhook pemberitahuan penskalaan otomatis

Ketika pemberitahuan penskalaan otomatis dibuat, metadata berikut disertakan dalam payload webhook:

{
    "version": "1.0",
    "status": "Activated",
    "operation": "Scale Out",
    "context": {
        "timestamp": "2023-06-22T07:01:47.8926726Z",
        "id": "/subscriptions/123456ab-9876-a1b2-a2b1-123a567b9f8767/resourceGroups/rg-001/providers/microsoft.insights/autoscalesettings/AutoscaleSettings-002",
        "name": "AutoscaleSettings-002",
        "details": "Autoscale successfully started scale operation for resource 'ScaleableAppServicePlan' from capacity '1' to capacity '2'",
        "subscriptionId": "123456ab-9876-a1b2-a2b1-123a567b9f8767",
        "resourceGroupName": "rg-001",
        "resourceName": "ScaleableAppServicePlan",
        "resourceType": "microsoft.web/serverfarms",
        "resourceId": "/subscriptions/123456ab-9876-a1b2-a2b1-123a567b9f8767/resourceGroups/rg-001/providers/Microsoft.Web/serverfarms/ScaleableAppServicePlan",
        "portalLink": "https://portal.azure.com/#resource/subscriptions/123456ab-9876-a1b2-a2b1-123a567b9f8767/resourceGroups/rg-001/providers/Microsoft.Web/serverfarms/ScaleableAppServicePlan",
        "resourceRegion": "West Central US",
        "oldCapacity": "1",
        "newCapacity": "2"
    },
    "properties": {
        "key1": "value1",
        "key2": "value2"
    }   
}

Bidang	Wajib	Deskripsi
status	Ya	Status yang menunjukkan bahwa tindakan skala otomatis dibuat.
operasi	Ya	Untuk peningkatan instans, ini adalah "Peluasan Skala." Untuk penurunan instans, ini adalah "Scale In."
konteks	Ya	Konteks tindakan skala otomatis.
tanda waktu	Ya	Stempel waktu saat tindakan skala otomatis dipicu.
id	Ya	Resource Manager ID pengaturan skala otomatis.
nama	Ya	Nama pengaturan skala otomatis.
detail	Ya	Penjelasan tentang tindakan yang diambil layanan skala otomatis dan perubahan jumlah instans.
subscriptionId	Ya	ID langganan sumber daya target yang sedang diskalakan.
resourceGroupName	Ya	Nama grup sumber daya dari sumber daya target yang sedang diskalakan.
resourceName	Ya	Nama sumber daya target yang sedang diskalakan.
resourceType	Ya	Tiga nilai yang didukung: "microsoft.classiccompute/domainnames/slots/roles" - Peran Azure Cloud Services, "microsoft.compute/virtualmachinescalesets" - Azure Virtual Machine Scale Sets, dan "Microsoft.Web/serverfarms" - Fitur Aplikasi Web Azure Monitor.
resourceId	Ya	Resource Manager ID sumber daya target yang sedang diskalakan.
portalLink	Ya	portal Azure tautan ke halaman ringkasan sumber daya target.
oldCapacity	Ya	Jumlah instans saat ini (lama) saat skala otomatis mengambil tindakan skala.
newCapacity	Ya	Jumlah instans baru tempat skala otomatis menskalakan sumber daya.
properti	Tidak	Opsional. Kumpulan pasangan <Kunci, Nilai> (misalnya, Kamus <String, String>). Bidang properti bersifat opsional. Dalam antarmuka pengguna kustom atau alur kerja berbasis aplikasi logika, Anda dapat memasukkan kunci dan nilai yang dapat diteruskan dengan menggunakan payload. Cara alternatif untuk meneruskan properti kustom kembali ke panggilan webhook keluar adalah dengan menggunakan URI webhook itu sendiri (sebagai parameter kueri).