E-mail- és webhookriasztási értesítések automatikus méretezési műveletek használata az Azure Monitorban

Ez a cikk bemutatja, hogyan állíthat be értesítéseket, hogy konkrét 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 HTTP-kérések küldését 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 automatikus skálázási esemény bekövetkezésekor.

E-mail

Automatikus skálázási esemény bekövetkezésekor bármilyen érvényes e-mail-címre küldhet e-mailt.

Feljegyzés

2024. április 3-tól nem fog tudni új társ-rendszergazdákat hozzáadni az Azure automatikus skálázási értesítéseihez. A klasszikus Azure-rendszergazdák 2024. augusztus 31-én megszűnnek, és 2024. augusztus 31-e után nem küldhet azure-beli automatikus skálázási értesítéseket rendszergazdák és társadminisztrátorok használatával. További információkért lásd: Felkészülés a társadminisztrátorok nyugdíjba vonulására

Értesítések konfigurálása

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

Portál

Értesítések beállítása az Azure Portalon.

Az értesítések konfigurálásához válassza az Automatikus méretezési beállítások lapon az Értesítés lapot.

Adja meg az értesítések küldéséhez szükséges e-mail-címek listáját.

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

CLI

A parancssori felület használatával konfigurálhatja az értesítéseket.

Az értesítések azure CLI-vel történő konfigurálásához használja a az monitor autoscale updateaz monitor autoscale create parancsot.

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

• --add-action – Az automatikus méretezési szabály aktiválásakor végrehajtandó művelet. Az értéknek vagy emailaz e-mail-címnek vagy a webhook URI-jának kell lenniewebhook.
• --remove-action - Távolítsa el a korábban hozzáadott --add-actionműveletet. Az értéknek vagy emailwebhooka . 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 méretezési beállítást.

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

Feljegyzés

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

További információért lásd: az monitor autoscale.

PowerShell

A PowerShell használatával konfigurálhatja az értesítéseket.

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

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 méretezési beállításhoz parancsmagok vagy New-AzAutoscaleSetting parancsmagok használatávalUpdate-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" `
-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

A Resource Manager-sablonok használatával konfigurálhatja az értesítéseket.

A Resource Manager-sablonok vagy a REST API használatakor 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@contoso.com",
              "user2@contoso.com"
              ]
        },
        "webhooks": [
          {
            "serviceUri": "https://my.webhook.example.com?token=abcd1234",
            "properties": {
              "optional_key1": "optional_value1",
              "optional_key2": "optional_value2"
            }
          }
        ]
      }
    ]

Mező	Kötelező	Leírás
operation	Igen	Az értéknek meg kell lennie Scale.
sendToSubscriptionAdministrator	Igen	A továbbiakban nem támogatott. Az értéknek meg kell lennie false.
sendToSubscriptionCoAdministrators	Igen	A továbbiakban nem támogatott. Az értéknek meg kell lennie false.
customEmails	Igen	Az érték lehet null [] vagy az e-mailek sztringtömbje.
webhooks	Igen	Az érték lehet null értékű vagy érvényes URI.
serviceUri	Igen	Érvényes HTTPS URI.
properties	Igen	Az értéknek üresnek {} kell lennie, vagy kulcs-érték párokat tartalmazhat.

Hitelesítés webhookokban

A webhook jogkivonatalapú hitelesítéssel hitelesíthető, ahol a webhook URI-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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "resourceGroupName": "rg-001",
        "resourceName": "ScaleableAppServicePlan",
        "resourceType": "microsoft.web/serverfarms",
        "resourceId": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.Web/serverfarms/ScaleableAppServicePlan",
        "portalLink": "https://portal.azure.com/#resource/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/rg-001/providers/Microsoft.Web/serverfarms/ScaleableAppServicePlan",
        "resourceRegion": "West Central US",
        "oldCapacity": "1",
        "newCapacity": "2"
    },
    "properties": {
        "key1": "value1",
        "key2": "value2"
    }   
}

Mező	Kötelező	Leírás
státusz	Igen	Az automatikus skálázási művelet létrejöttét jelző állapot.
művelet	Igen	A példányok számának növeléséhez a következő: "Vertikális felskálázás". A példányok számának csökkenéséhez a következő: "Scale In".
kontextus	Igen	Automatikus méretezési műveletkörnyezet.
időbélyeg	Igen	Időbélyeg az automatikus skálázási művelet aktiválásakor.
azonosító	Igen	Az automatikus skálázási beállítás Resource Manager-azonosítója.
név	Igen	Az automatikus méretezési beállítás neve.
részletek	Igen	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.
Előfizetésazonosító	Igen	A skálázandó célerőforrás előfizetés-azonosítója.
erőforráscsoport neve	Igen	A skálázni kívánt célerőforrás erőforráscsoportjának neve.
erőforrás neve	Igen	A skálázni kívánt célerőforrás neve.
erőforrástípus	Igen	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.
erőforrás-azonosító	Igen	A skálázandó célerőforrás Resource Manager-azonosítója.
portalLink	Igen	Az Azure Portal hivatkozása a célerőforrás összefoglaló oldalára.
régiKapacitás	Igen	A jelenlegi (régi) példányok száma, amikor az automatikus skálázás skálázási műveletet végzett.
újKapacitás	Igen	Az új példányok száma, amelyre az automatikus skálázás skálázta az erőforrást.
tulajdonságok	Nem	Opcionális. Kulcs- <és értékpárok> (például szótári <sztring, sztring>) készlete. A tulajdonságok mező nem kötelező. Egyéni felhasználói felületen vagy logikai alkalmazáson alapuló munkafolyamatban megadhatja a hasznos adatokkal átadható kulcsokat és értékeket. Az egyéni tulajdonságok kimenő webhook-hí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).