Usare le azioni di scalabilità automatica per inviare notifiche di avviso tramite posta elettronica e webhook in Azure Monitor

Questo articolo illustra come configurare le notifiche per consentire di chiamare URL web specifici o inviare messaggi di posta elettronica in base alle azioni di autoscalabilità in Azure.

Webhook

I webhook consentono di inviare richieste HTTP a un endpoint dell'URL specifico (URL di callback) quando si verifica un determinato evento o un trigger. Usando i webhook, è possibile automatizzare e semplificare i processi abilitando lo scambio automatico di informazioni tra diversi sistemi o applicazioni. Usare i webhook per attivare codice personalizzato, notifiche o altre azioni da eseguire quando si verifica un evento di scalabilità automatica.

E-mail

È possibile inviare un messaggio di posta elettronica a qualsiasi indirizzo e-mail valido quando si verifica un evento di scalabilità automatica.

Nota

A partire dal 3 aprile 2024 non sarà possibile aggiungere nuovi co-amministratori per le notifiche di scalabilità automatica di Azure. Gli amministratori classici di Azure verranno ritirati il 31 agosto 2024 e dopo questa data non sarà possibile inviare le notifiche di scalabilità automatica di Azure usando amministratori e co-amministratori. Per altre informazioni, vedere Preparare il ritiro dei co-amministratori

Configurare le notifiche

Usare il portale di Azure, l'interfaccia della riga di comando, PowerShell o i modelli di Resource Manager per configurare le notifiche.

Portale

Configurare le notifiche usando il portale di Azure.

Selezionare la scheda Notifica nella pagina delle impostazioni di scalabilità automatica per configurare le notifiche.

Immettere un elenco di indirizzi di posta elettronica a cui inviare notifiche.

Immettere un URI webhook per inviare una notifica a un servizio Web. È anche possibile aggiungere intestazioni personalizzate alla richiesta webhook. Ad esempio, è possibile aggiungere un token di autenticazione nell'intestazione, i parametri di query o aggiungere un'intestazione personalizzata per identificare l'origine della richiesta.

CLI

Usare l'interfaccia della riga di comando per configurare le notifiche.

Usare az monitor autoscale update o il comando az monitor autoscale create per configurare le notifiche usando l'interfaccia della riga di comando di Azure.

Per configurare le notifiche usare i parametri seguenti:

• --add-action: l'azione da eseguire quando viene attivata la regola di scalabilità automatica. Il valore deve essere email o webhook e deve essere seguito dall'indirizzo e-mail o dall'URI del webhook.
• --remove-action: rimuovere un'azione aggiunta in precedenza da --add-action. Il valore deve essere email o webhook. Il parametro è rilevante solo per il comando az monitor autoscale update.

Ad esempio, il comando seguente aggiunge una notifica tramite posta elettronica e una notifica webhook all'impostazione di scalabilità automatica esistente.

 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

Nota

È possibile aggiungere più volte una notifica tramite posta elettronica o webhook usando il parametro --add-action. Anche se sono supportate più notifiche webhook e possono essere visualizzate nel codice JSON, il portale mostra solo il primo webhook.

Per altre informazioni, vedere az monitor autoscale.

PowerShell

Usare PowerShell per configurare le notifiche.

L'esempio seguente illustra come configurare un webhook e una notifica tramite posta elettronica.

1. Creare l'oggetto webhook.

2. Crea l'oggetto di notifica.

3. Aggiungere l'oggetto notifica all'impostazione di scalabilità automatica usando i cmdlet New-AzAutoscaleSetting o Update-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

Usare i modelli di Resource Manager per configurare le notifiche.

Quando si usano i modelli di Resource Manager o l'API REST, includere l'elemento notifications nelle impostazioni di scalabilità automatica, ad esempio:

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

Campo	Obbligatorio	Descrizione
operation	Sì	Il valore deve essere Scale.
sendToSubscriptionAdministrator	Sì	Non più supportata. Il valore deve essere false.
sendToSubscriptionCoAdministrators	Sì	Non più supportata. Il valore deve essere false.
customEmails	Sì	Il valore può essere null [] o una matrice di stringhe di messaggi di posta elettronica.
webhooks	Sì	Il valore può essere null o un URI valido.
serviceUri	Sì	Un URI HTTPS valido.
properties	Sì	Il valore deve essere vuoto {} o può contenere coppie chiave-valore.

Autenticazione nei webhook

È possibile autenticare il webhook usando l'autenticazione basata su token, che prevede il salvataggio dell'URI del webhook con un ID token come parametro di query. Ad esempio: https://mysamplealert/webcallback?tokenid=123-abc456-7890&myparameter2=value123.

Schema di payload del webhook di notifica di scalabilità automatica

Quando viene generata la notifica di scalabilità automatica, nel payload del webhook vengono inclusi i metadati seguenti:

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

Campo	Obbligatorio	Descrizione
stato	Sì	Stato che indica che è stata generata un'azione di scalabilità automatica.
operazione	Sì	Per l'aumento delle istanze, si usa "Scale Out", mentre per la diminuzione delle istanze, si usa "Scale In".
contesto	Sì	Contesto dell'azione di scalabilità automatica.
Marca temporale	Sì	Timestamp in cui è stata attivata l'azione di scalabilità automatica.
Id	Sì	ID Resource Manager dell'impostazione di scalabilità automatica.
nome	Sì	Nome dell'impostazione di scalabilità automatica.
dettagli	Sì	Spiegazione dell'azione eseguita dal servizio di scalabilità automatica e della modifica del numero di istanze.
ID di sottoscrizione	Sì	ID sottoscrizione della risorsa di destinazione in fase di ridimensionamento.
resourceGroupName	Sì	Nome del gruppo di risorse della risorsa di destinazione in fase di ridimensionamento.
nomeRisorsa	Sì	Nome della risorsa di destinazione in fase di ridimensionamento.
tipo di risorsa	Sì	Tre valori supportati: "microsoft.classiccompute/domainnames/slots/roles" - Ruoli di Servizi cloud di Azure, "microsoft.compute/virtualmachinescalesets" - Set di scalabilità di macchine virtuali di Microsoft Azure e "Microsoft.Web/serverfarms" - Funzionalità app Web di Monitoraggio di Azure.
ID della risorsa	Sì	ID Resource Manager della risorsa di destinazione in fase di ridimensionamento.
portalLink	Sì	Collegamento del portale di Azure alla pagina di riepilogo della risorsa di destinazione.
oldCapacity	Sì	Numero di istanze corrente (precedente) quando la scalabilità automatica ha eseguito un'azione di ridimensionamento
nuovaCapacità	Sì	Numero di nuove istanze in base al quale la scalabilità automatica ha ridimensionato la risorsa.
proprietà	NO	(Facoltativo). Set di coppie <Chiave, Valore> (ad esempio Dizionario <Stringa, Stringa>). Il campo properties è facoltativo. In un flusso di lavoro basato su un'interfaccia utente personalizzata o un'app per la logica, è possibile immettere chiavi e valori che possono essere passati usando il payload. Un metodo alternativo per passare le proprietà personalizzate alla chiamata webhook in uscita è usare l'URI del webhook stesso (come parametri di query).