Automatikus skálázási műveletek használata e-mail- és webhookriasztási értesítések küldéséhez az Azure Monitorban

Ez a cikk bemutatja, hogyan állíthat be értesítéseket, hogy adott webes URL-címeket hívhat meg, vagy e-maileket küldjön az Azure automatikus skálázási műveletei alapján.

Webhookok

A webhookok lehetővé teszik, hogy HTTP-kéréseket küldjön egy adott URL-végpontra (visszahívási URL-címre) egy adott esemény vagy eseményindító bekövetkezésekor. A webhookok használatával automatizálhatja és egyszerűsítheti a folyamatokat a különböző rendszerek vagy alkalmazások közötti automatikus információcsere engedélyezésével. Webhookok használatával egyéni kódot, értesítéseket vagy más műveleteket indíthat el, amelyeket automatikus skálázási esemény bekövetkezésekor futtathat.

E-mail

Automatikus skálázási esemény esetén bármilyen érvényes e-mail-címre küldhet e-mailt. A szabályt futtató előfizetés rendszergazdái és társadminisztrátorai is értesítést kapnak.

Értesítések konfigurálása

Az értesítések konfigurálásához használja a Azure Portal, a parancssori felület, a PowerShell vagy Resource Manager sablonokat.

Portál

Értesítések beállítása a Azure Portal használatával.

Az értesítések konfigurálásához válassza az Értesítés lapot az automatikus skálázási beállítások lapján.

Jelölje be a jelölőnégyzeteket, ha e-mailt szeretne küldeni az előfizetés rendszergazdájának vagy társadminisztrátorának. Megadhatja azoknak az e-mail-címeknek a listáját is, amelybe értesítéseket szeretne küldeni.

Adjon meg egy webhook URI-t, hogy értesítést küldjön egy webszolgáltatásnak. A webhook-kérelemhez egyéni fejléceket is hozzáadhat. Hozzáadhat például egy hitelesítési jogkivonatot a fejléchez, lekérdezési paramétereket, vagy hozzáadhat egy egyéni fejlécet a kérés forrásának azonosításához.

Parancssori felület

Az értesítések konfigurálásához használja a parancssori felületet.

Az vagy a az monitor autoscale update paranccsal konfigurálhatja az az monitor autoscale create értesítéseket az Azure CLI használatával.

Az értesítések konfigurálásához a következő paraméterek használhatók:

• --add-action – Az automatikus skálázási szabály aktiválásakor végrehajtandó művelet. Az értéknek vagy webhookértéknek kell lennieemail.
• --email-administrator {false, true} – Küldjön e-mailt az előfizetés rendszergazdájának.
• --email-coadministrators {false, true} – Küldjön e-mailt az előfizetés társadminisztrátorainak.
• --remove-action- Távolítsa el a korábban hozzáadott műveletet.--add-action Az értéknek vagy webhookértéknek kell lennieemail. A paraméter csak a az monitor autoscale update parancs szempontjából releváns.

A következő parancs például hozzáad egy e-mail-értesítést és egy webhookértesítést, valamint egy meglévő automatikus skálázási beállítást. A parancs e-mailt is küld az előfizetés rendszergazdájának.

 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

Megjegyzés

A paraméterrel --add-action többször is hozzáadhat mote e-mail- vagy webhookértesítést. Bár a JSON-ban több webhookértesítés is támogatott, a portál csak az első webhookot jeleníti meg.

További információkért lásd az az monitor autoscale (automatikus skálázás monitorozása) című témakört.

PowerShell

Az értesítések konfigurálásához használja a PowerShellt.

Az alábbi példa bemutatja, hogyan konfigurálhat webhookot és e-mailes értesítést.

1. Hozza létre a webhook objektumot.

2. Hozza létre az értesítési objektumot.

3. Adja hozzá az értesítési objektumot az automatikus skálázási beállításhoz a vagy Update-AzAutoscaleSetting parancsmagok használatávalNew-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

Az értesítések konfigurálásához Resource Manager sablonokat használhat.

Ha a Resource Manager-sablonokat vagy a REST API-t használja, vegye fel az elemet az notificationsautomatikus skálázási beállításokba, például:

"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"
            }
          }
        ]
      }
    ]

Mező	Kötelező	Description
művelet	Yes	Az értéknek "Skálázás" értékűnek kell lennie.
sendToSubscriptionAdministrator	Yes	Az értéknek "igaz" vagy "hamis" értékűnek kell lennie.
sendToSubscriptionCoAdministrators	Yes	Az értéknek "igaz" vagy "hamis" értékűnek kell lennie.
customEmails	Yes	Az érték lehet null [] vagy e-mailek sztringtömbje.
webhookok	Yes	Az érték lehet null értékű vagy érvényes URI.
serviceUri	Yes	Érvényes HTTPS URI.
properties	Yes	Az értéknek üresnek {} kell lennie, vagy kulcs-érték párokat kell tartalmaznia.

Hitelesítés webhookokban

A webhook jogkivonatalapú hitelesítéssel végezhet hitelesítést, ahol a webhook URI-ját egy jogkivonat-azonosítóval mentheti lekérdezési paraméterként. Például: https://mysamplealert/webcallback?tokenid=123-abc456-7890&myparameter2=value123.

Automatikus skálázási értesítési webhook hasznos adatséma

Az automatikus skálázási értesítés létrehozásakor a webhook hasznos adatai a következő metaadatokat tartalmazzák:

{
    "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"
    }   
}

Mező	Kötelező	Description
status	Yes	Az automatikus skálázási művelet létrejöttét jelző állapot.
művelet	Yes	A példányok számának növelése érdekében a következő: "Vertikális felskálázás". A példányok csökkenéséhez a következő: "Skálázás".
Összefüggésben	Yes	Automatikus skálázási műveletkörnyezet.
időbélyeg	Yes	Az automatikus skálázási művelet aktiválásának időbélyege.
id	Yes	Resource Manager automatikus skálázási beállítás azonosítója.
name	Yes	Az automatikus skálázási beállítás neve.
részletek	Yes	Az automatikus skálázási szolgáltatás által végrehajtandó művelet és a példányszám változásának magyarázata.
subscriptionId	Yes	A skálázandó célerőforrás előfizetés-azonosítója.
resourceGroupName	Yes	A skálázandó célerőforrás erőforráscsoport-neve.
resourceName	Yes	A skálázandó célerőforrás neve.
resourceType	Yes	Három támogatott érték: "microsoft.classiccompute/domainnames/slots/roles" – Azure Cloud Services szerepkörök, "microsoft.compute/virtualmachinescalesets" – Azure Virtual Machine Scale Sets és "Microsoft.Web/serverfarms" – Az Azure Monitor webalkalmazás-funkciója.
resourceId	Yes	Resource Manager skálázni kívánt célerőforrás azonosítója.
portalLink	Yes	Azure Portal hivatkozás a célerőforrás összefoglaló oldalára.
oldCapacity	Yes	Aktuális (régi) példányok száma, amikor az automatikus skálázás skálázási műveletet végzett.
newCapacity	Yes	Új példányok száma, amelyekre az automatikus skálázás skálázta az erőforrást.
properties	No	Választható. Kulcskészlet <, értékpárok> (például szótári <sztring, sztring>). A tulajdonságok mező nem kötelező. Egyéni felhasználói felületen vagy logikaialkalmazás-alapú munkafolyamatban a hasznos adatokkal átadható kulcsokat és értékeket adhat meg. Az egyéni tulajdonságok kimenő webhookhívásnak való átadásának másik módja, ha magát a webhook URI-t használja (lekérdezési paraméterekként).