Använda autoskalningsåtgärder för att skicka aviseringsaviseringar för e-post och webhook i Azure Monitor

Den här artikeln visar hur du konfigurerar aviseringar så att du kan anropa specifika webb-URL:er eller skicka e-postmeddelanden baserat på autoskalningsåtgärder i Azure.

Webhooks

Med webhooks kan du skicka HTTP-begäranden till en specifik URL-slutpunkt (motringnings-URL) när en viss händelse eller utlösare inträffar. Med hjälp av webhooks kan du automatisera och effektivisera processer genom att aktivera automatiskt utbyte av information mellan olika system eller program. Använd webhooks för att utlösa anpassad kod, meddelanden eller andra åtgärder som ska köras när en autoskalningshändelse inträffar.

E-post

Du kan skicka e-post till valfri giltig e-postadress när en autoskalningshändelse inträffar. Administratörer och medadministratörer för prenumerationen där regeln körs meddelas också.

Konfigurera meddelanden

Använd mallarna Azure Portal, CLI, PowerShell eller Resource Manager för att konfigurera meddelanden.

Portal

Konfigurera meddelanden med hjälp av Azure Portal.

Välj fliken Meddela på sidan med autoskalningsinställningar för att konfigurera meddelanden.

Markera kryssrutorna för att skicka ett e-postmeddelande till prenumerationsadministratören eller medadministratörerna. Du kan också ange en lista med e-postadresser som du vill skicka meddelanden till.

Ange en webhook-URI för att skicka ett meddelande till en webbtjänst. Du kan också lägga till anpassade rubriker i webhook-begäran. Du kan till exempel lägga till en autentiseringstoken i rubriken, frågeparametrarna eller lägga till en anpassad rubrik för att identifiera källan för begäran.

CLI

Använd CLI för att konfigurera aviseringar.

az monitor autoscale update Använd kommandot eller az monitor autoscale create för att konfigurera meddelanden med hjälp av Azure CLI.

Följande parametrar används för att konfigurera meddelanden:

• --add-action – Den åtgärd som ska vidtas när autoskalningsregeln utlöses. Värdet måste vara email eller webhook.
• --email-administrator {false, true} – Skicka e-post till prenumerationsadministratören.
• --email-coadministrators {false, true} – Skicka e-post till prenumerationens medadministratörer.
• --remove-action – Ta bort en åtgärd som tidigare lagts till av --add-action. Värdet måste vara email eller webhook. Parametern är endast relevant för az monitor autoscale update kommandot .

Följande kommando lägger till exempel till ett e-postmeddelande och ett webhook-meddelande till och en befintlig autoskalningsinställning. Kommandot skickar också ett e-postmeddelande till prenumerationsadministratören.

 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

Anteckning

Du kan lägga till mote än ett e-postmeddelande eller webhook-meddelande med hjälp av parametern --add-action flera gånger. Även om flera webhook-meddelanden stöds och kan visas i JSON, visar portalen bara den första webhooken.

Mer information finns i az monitor autoscale.

PowerShell

Använd PowerShell för att konfigurera meddelanden.

I följande exempel visas hur du konfigurerar en webhook och ett e-postmeddelande.

1. Skapa webhook-objektet.

2. Skapa meddelandeobjektet.

3. Lägg till meddelandeobjektet i autoskalningsinställningen med hjälp av New-AzAutoscaleSetting eller Update-AzAutoscaleSetting cmdletar.

# 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

Använd Resource Manager mallar för att konfigurera meddelanden.

När du använder Resource Manager mallar eller REST API ska du inkludera elementet notifications i inställningarna för autoskalning, till exempel:

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

Fält	Obligatorisk	Description
operation	Yes	Värdet måste vara "Skala".
sendToSubscriptionAdministrator	Yes	Värdet måste vara "true" eller "false".
sendToSubscriptionCoAdministrators	Yes	Värdet måste vara "true" eller "false".
customEmails	Yes	Värdet kan vara null [] eller en strängmatris med e-postmeddelanden.
webhooks	Yes	Värdet kan vara null eller giltig URI.
serviceUri	Yes	Giltig HTTPS-URI.
properties	Yes	Värdet måste vara tomt {} eller innehålla nyckel/värde-par.

Autentisering i webhooks

Webhooken kan autentisera med hjälp av tokenbaserad autentisering, där du sparar webhook-URI:n med ett token-ID som en frågeparameter. Till exempel https://mysamplealert/webcallback?tokenid=123-abc456-7890&myparameter2=value123.

Webhook-nyttolastschema för autoskalningsmeddelande

När autoskalningsmeddelandet genereras inkluderas följande metadata i webhook-nyttolasten:

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

Fält	Obligatorisk	Description
status	Yes	Status som anger att en autoskalningsåtgärd genererades.
operation	Yes	För en ökning av instanser är det "Skala ut". För en minskning i instanser är det "Skala in".
Sammanhang	Yes	Åtgärdskontext för autoskalning.
timestamp	Yes	Tidsstämpel när autoskalningsåtgärden utlöstes.
id	Yes	Resource Manager ID för autoskalningsinställningen.
name	Yes	Namnet på autoskalningsinställningen.
information	Yes	Förklaring av den åtgärd som autoskalningstjänsten vidtog och ändringen av antalet instanser.
subscriptionId	Yes	Prenumerations-ID för målresursen som skalas.
resourceGroupName	Yes	Resursgruppens namn på målresursen som skalar.
resourceName	Yes	Namnet på målresursen som skalas.
resourceType	Yes	Tre värden som stöds: "microsoft.classiccompute/domainnames/slots/roles" – Azure Cloud Services roller, "microsoft.compute/virtualmachinescalesets" – Azure Virtual Machine Scale Sets och "Microsoft.Web/serverfarms" – Webbappfunktionen i Azure Monitor.
resourceId	Yes	Resource Manager ID för målresursen som skalas.
portalLänk	Yes	Azure Portal länk till sammanfattningssidan för målresursen.
oldCapacity	Yes	Aktuellt (gammalt) instansantal när autoskalning vidtog en skalningsåtgärd.
newCapacity	Yes	Antal nya instanser som automatiskt skalade resursen till.
properties	No	Valfritt. Uppsättning nyckel <, värdepar> (till exempel ordlistesträng <, sträng>). Egenskapsfältet är valfritt. I ett anpassat användargränssnitt eller ett logikappbaserat arbetsflöde kan du ange nycklar och värden som kan skickas med hjälp av nyttolasten. Ett alternativt sätt att skicka tillbaka anpassade egenskaper till det utgående webhook-anropet är att använda själva webhook-URI:n (som frågeparametrar).