Acties voor automatisch schalen gebruiken om waarschuwingen voor e-mail en webhook te verzenden in Azure Monitor

In dit artikel leest u hoe u meldingen instelt, zodat u specifieke web-URL's kunt aanroepen of e-mailberichten kunt verzenden op basis van acties voor automatisch schalen in Azure.

Webhooks

Met webhooks kunt u HTTP-aanvragen verzenden naar een specifiek URL-eindpunt (callback-URL) wanneer een bepaalde gebeurtenis of trigger plaatsvindt. Met behulp van webhooks kunt u processen automatiseren en stroomlijnen door het automatisch uitwisselen van informatie tussen verschillende systemen of toepassingen mogelijk te maken. Gebruik webhooks om aangepaste code, meldingen of andere acties te activeren die moeten worden uitgevoerd wanneer een gebeurtenis voor automatisch schalen plaatsvindt.

E-mailen

U kunt e-mail verzenden naar elk geldig e-mailadres wanneer er een gebeurtenis voor automatische schaalaanpassing plaatsvindt.

Notitie

Vanaf 3 april 2024 kunt u geen nieuwe co-beheerders toevoegen voor meldingen over automatische schaalaanpassing van Azure. Klassieke Azure-beheerders worden op 31 augustus 2024 buiten gebruik gesteld en u kunt na 31 augustus 2024 geen meldingen over Automatische schaalaanpassing van Azure verzenden met beheerders en co-beheerders. Zie Voorbereiden voor buitengebruikstelling van co-beheerders voor informatie over moe

Meldingen configureren

Gebruik de Azure Portal-, CLI-, PowerShell- of Resource Manager-sjablonen om meldingen te configureren.

Portal

Meldingen instellen met behulp van Azure Portal.

Selecteer het tabblad Waarschuwen op de pagina Instellingen voor automatisch schalen om meldingen te configureren.

Voer een lijst met e-mailadressen in waar u meldingen naartoe wilt verzenden.

Voer een webhook-URI in om een melding naar een webservice te verzenden. U kunt ook aangepaste headers toevoegen aan de webhookaanvraag. U kunt bijvoorbeeld een verificatietoken toevoegen in de header, queryparameters of een aangepaste header toevoegen om de bron van de aanvraag te identificeren.

CLI

Gebruik CLI om meldingen te configureren.

Gebruik de az monitor autoscale update opdracht of de az monitor autoscale create opdracht om meldingen te configureren met behulp van Azure CLI.

De volgende parameters worden gebruikt om meldingen te configureren:

• --add-action - De actie die moet worden uitgevoerd wanneer de regel voor automatisch schalen wordt geactiveerd. De waarde moet of email webhook, gevolgd door het e-mailadres of de webhook-URI.
• --remove-action - Een actie verwijderen die eerder is toegevoegd door --add-action. De waarde moet of email webhook. De parameter is alleen relevant voor de az monitor autoscale update opdracht.

Met de volgende opdracht wordt bijvoorbeeld een e-mailmelding en een webhookmelding toegevoegd aan en de bestaande instelling voor automatisch schalen.

 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

Notitie

U kunt mote dan één e-mail- of webhookmelding toevoegen met behulp van de --add-action parameter meerdere keren. Hoewel meerdere webhookmeldingen worden ondersteund en kunnen worden weergegeven in de JSON, wordt in de portal alleen de eerste webhook weergegeven.

Zie az monitor autoscale voor meer informatie.

Powershell

Gebruik PowerShell om meldingen te configureren.

In het volgende voorbeeld ziet u hoe u een webhook en e-mailmelding configureert.

1. Maak het webhookobject.

2. Maak het meldingsobject.

3. Voeg het meldingsobject toe aan de instelling voor automatisch schalen met behulp van New-AzAutoscaleSetting of Update-AzAutoscaleSetting cmdlets.

# 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

Gebruik Resource Manager-sjablonen om meldingen te configureren.

Wanneer u de Resource Manager-sjablonen of REST API gebruikt, neemt u het notifications element op in de instellingen voor automatisch schalen, bijvoorbeeld:

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

Veld	Verplicht	Beschrijving
operation	Ja	Waarde moet zijn Scale.
sendToSubscriptionAdministrator	Ja	Niet meer ondersteund. Waarde moet zijn false.
sendToSubscriptionCoAdministrators	Ja	Niet meer ondersteund. Waarde moet zijn false.
customEmails	Ja	De waarde kan null [] of een tekenreeksmatrix van e-mailberichten zijn.
webhooks	Ja	Waarde kan null of geldige URI zijn.
serviceUri	Ja	Geldige HTTPS-URI.
properties	Ja	De waarde moet leeg {} zijn of kan sleutel-waardeparen bevatten.

Verificatie in webhooks

De webhook kan worden geverifieerd met behulp van verificatie op basis van tokens, waarbij u de webhook-URI opslaat met een token-id als queryparameter. Bijvoorbeeld: https://mysamplealert/webcallback?tokenid=123-abc456-7890&myparameter2=value123.

Schema voor het automatisch schalen van de webhook van de webhook

Wanneer de melding voor automatisch schalen wordt gegenereerd, worden de volgende metagegevens opgenomen in de nettolading van de webhook:

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

Veld	Verplicht	Beschrijving
status	Ja	Status die aangeeft dat er een actie voor automatische schaalaanpassing is gegenereerd.
schakelapparatuur optimaliseren	Ja	Voor een toename van exemplaren is 'Uitschalen'. Voor een afname in exemplaren is dit 'Inschalen'.
context	Ja	Actiecontext voor automatisch schalen.
timestamp	Ja	Tijdstempel toen de actie voor automatisch schalen werd geactiveerd.
id	Ja	Resource Manager-id van de instelling voor automatische schaalaanpassing.
naam	Ja	Naam van de instelling voor automatische schaalaanpassing.
details	Ja	Uitleg van de actie die de service voor automatisch schalen heeft uitgevoerd en de wijziging in het aantal instanties.
subscriptionId	Ja	Abonnements-id van de doelresource die wordt geschaald.
resourceGroupName	Ja	De naam van de resourcegroep van de doelresource die wordt geschaald.
resourceName	Ja	Naam van de doelresource die wordt geschaald.
resourceType	Ja	Drie ondersteunde waarden: 'microsoft.classiccompute/domainnames/slots/roles' - Azure Cloud Services-rollen, 'microsoft.compute/virtualmachinescalesets' - Azure Virtual Machine Scale Sets en 'Microsoft.Web/serverfarms': web-app-functie van Azure Monitor.
resourceId	Ja	Resource Manager-id van de doelresource die wordt geschaald.
portalLink	Ja	Azure Portal-koppeling naar de overzichtspagina van de doelresource.
oldCapacity	Ja	Huidig (oud) aantal exemplaren wanneer automatisch schalen een schaalactie heeft uitgevoerd.
newCapacity	Ja	Het aantal nieuwe exemplaren waarop automatisch schalen de resource heeft geschaald.
properties	Nee	Optioneel. <Set sleutel-, waardeparen> (bijvoorbeeld woordenlijsttekenreeks<, tekenreeks>). Het veld Eigenschappen is optioneel. In een aangepaste gebruikersinterface of op logische apps gebaseerde werkstroom kunt u sleutels en waarden invoeren die kunnen worden doorgegeven met behulp van de nettolading. Een alternatieve manier om aangepaste eigenschappen weer door te geven aan de uitgaande webhookaanroep is door de webhook-URI zelf te gebruiken (als queryparameters).