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

Artikel
11/05/2024

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

Webhook

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.

Email

Du kan skicka e-post till valfri giltig e-postadress när en autoskalningshändelse inträffar.

Kommentar

Från och med den 3 april 2024 kan du inte lägga till några nya medadministratörer för Azure Autoscale Notifications. Klassiska Azure-administratörer dras tillbaka den 31 augusti 2024 och du skulle inte kunna skicka Azure Autoscale-meddelanden med administratörer och medadministratörer efter den 31 augusti 2024. Information om att förbereda för medadministratörer finns i Förbereda för medadministratörer

Konfigurera meddelanden

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

Konfigurera meddelanden med hjälp av Azure Portal.

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

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 webhooksbegäran. Du kan till exempel lägga till en autentiseringstoken i rubriken, frågeparametrar eller lägga till ett anpassat huvud för att identifiera källan till begäran.

Använd CLI för att konfigurera meddelanden.

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 webhookoch följt av e-postadressen eller webhook-URI:n.
--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 ett e-postmeddelande och ett webhook-meddelande till och en befintlig autoskalningsinställning.

 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

Kommentar

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.

Använd PowerShell för att konfigurera meddelanden.

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

Skapa webhook-objektet.
Skapa meddelandeobjektet.
Lägg till meddelandeobjektet i inställningen autoskalning 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" `
-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"

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

När du använder Resource Manager-mallar eller REST-API:et inkluderar du 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	beskrivning
`operation`	Ja	Värdet måste vara `Scale`.
`sendToSubscriptionAdministrator`	Ja	Stöds inte längre. Värdet måste vara `false`.
`sendToSubscriptionCoAdministrators`	Ja	Stöds inte längre. Värdet måste vara `false`.
`customEmails`	Ja	Värdet kan vara null [] eller en strängmatris med e-postmeddelanden.
`webhooks`	Ja	Värdet kan vara null eller giltig URI.
`serviceUri`	Ja	Giltig HTTPS-URI.
`properties`	Ja	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 webhooks-URI:n med ett token-ID som frågeparameter. 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/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/ffffffff-eeee-dddd-cccc-bbbbbbbbbbb0/resourceGroups/rg-001/providers/Microsoft.Web/serverfarms/ScaleableAppServicePlan",
        "resourceRegion": "West Central US",
        "oldCapacity": "1",
        "newCapacity": "2"
    },
    "properties": {
        "key1": "value1",
        "key2": "value2"
    }   
}

Fält	Obligatorisk	beskrivning
status	Ja	Status som anger att en autoskalningsåtgärd har genererats.
operation	Ja	För en ökning av instanser är det "Skala ut". För en minskning av instanser är det "Skala in".
sammanhang	Ja	Autoskalningsåtgärdskontext.
timestamp	Ja	Tidsstämpel när autoskalningsåtgärden utlöstes.
id	Ja	Resource Manager-ID för autoskalningsinställningen.
name	Ja	Namn på autoskalningsinställningen.
information	Ja	Förklaring av den åtgärd som autoskalningstjänsten vidtog och ändringen av instansantalet.
subscriptionId	Ja	Prenumerations-ID för målresursen som skalas.
resourceGroupName	Ja	Resursgruppens namn på målresursen som skalas.
resourceName	Ja	Namnet på målresursen som skalas.
resourceType	Ja	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	Ja	Resource Manager-ID för målresursen som skalas.
portalLänk	Ja	Azure Portal länk till sammanfattningssidan för målresursen.
oldCapacity	Ja	Aktuellt (gammalt) instansantal när autoskalning vidtog en skalningsåtgärd.
newCapacity	Ja	Antal nya instanser som autoskalning av resursen skalades till.
egenskaper	Nej	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 webhooksanropet är att använda själva webhooks-URI:n (som frågeparametrar).

Dela via