Creare e gestire gruppi di azione nel portale di AzureCreate and manage action groups in the Azure portal

• 04/07/2021
• 10 minuti per la lettura
• • d
  • o

Un gruppo di azioni è una raccolta delle preferenze di notifica definite dal proprietario di una sottoscrizione di Azure.An action group is a collection of notification preferences defined by the owner of an Azure subscription. Gli avvisi di Monitoraggio di Azure e di integrità dei servizi usano gruppi di azioni per notificare agli utenti l'attivazione di un avviso.Azure Monitor and Service Health alerts use action groups to notify users that an alert has been triggered. I vari avvisi possono usare lo stesso gruppo di azioni o gruppi di azioni diversi, a seconda delle esigenze dell'utente.Various alerts may use the same action group or different action groups depending on the user's requirements.

Questo articolo illustra come creare e gestire gruppi di azione nel portale di Azure.This article shows you how to create and manage action groups in the Azure portal.

Ogni azione è composta dalle seguenti proprietà:Each action is made up of the following properties:

• Tipo: notifica o azione eseguita.Type: The notification or action performed. Gli esempi includono l'invio di una chiamata vocale, un SMS o un messaggio di posta elettronica oppure l'attivazione di vari tipi di azioni automatizzate.Examples include sending a voice call, SMS, email; or triggering various types of automated actions. Vedere i tipi più avanti in questo articolo.See types later in this article.
• Name: un identificatore univoco all'interno del gruppo di azioni.Name: A unique identifier within the action group.
• Dettagli: dettagli corrispondenti che variano in base al tipo.Details: The corresponding details that vary by type.

Per informazioni sull'uso dei modelli di Azure Resource Manager per configurare i gruppi di azione: Modelli di Resource Manager per il gruppo di azione.For information on how to use Azure Resource Manager templates to configure action groups, see Action group Resource Manager templates.

Creare un gruppo di azione usando il portale di AzureCreate an action group by using the Azure portal

1. Nel portale di Azure cercare e selezionare Monitoraggio.In the Azure portal, search for and select Monitor. Il riquadro Monitoraggio consolida tutte le impostazioni e i dati di monitoraggio in una vista.The Monitor pane consolidates all your monitoring settings and data in one view.

2. Selezionare Avvisi e quindi Gestisci azioni.Select Alerts, then select Manage actions.

   

3. Selezionare Aggiungi gruppo di azioni e compilare i campi pertinenti nell'esperienza della procedura guidata.Select Add action group, and fill in the relevant fields in the wizard experience.

   

Configurare le impostazioni di base del gruppo di azioniConfigure basic action group settings

In Dettagli progetto:Under Project details:

Selezionare la sottoscrizione e il gruppo di risorse in cui viene salvato il gruppo di azioni.Select the Subscription and Resource group in which the action group is saved.

In Dettagli istanza:Under Instance details:

1. Immettere un nome per il gruppo di azioni.Enter an Action group name.

2. Immettere un nome visualizzato.Enter a Display name. Il nome visualizzato viene usato al posto di un nome completo del gruppo di azioni quando le notifiche vengono inviate usando questo gruppo.The display name is used in place of a full action group name when notifications are sent using this group.

   

Configurare le notificheConfigure notifications

1. Fare clic sul pulsante >notifiche per passare alla scheda Notifiche o selezionare la scheda Notifiche nella parte superiore della schermata.Click the Next: Notifications > button to move to the Notifications tab, or select the Notifications tab at the top of the screen.

2. Definire un elenco di notifiche da inviare quando viene attivato un avviso.Define a list of notifications to send when an alert is triggered. Specificare quanto segue per ogni notifica:Provide the following for each notification:

   a.a. Tipo di notifica: selezionare il tipo di notifica da inviare.Notification type: Select the type of notification you want to send. Le opzioni disponibili sono:The available options are:

   • Ruolo Azure Resource Manager di posta elettronica: inviare un messaggio di posta elettronica agli utenti assegnati a determinati ruoli arm a livello di sottoscrizione.Email Azure Resource Manager Role - Send an email to users assigned to certain subscription-level ARM roles.
   • Posta elettronica/SMS/Push/Voce: inviare questi tipi di notifica a destinatari specifici.Email/SMS/Push/Voice - Send these notification types to specific recipients.

   b.b. Nome: immettere un nome univoco per la notifica.Name: Enter a unique name for the notification.

   c.c. Dettagli: in base al tipo di notifica selezionato, immettere un indirizzo di posta elettronica, un numero di telefono e così via.Details: Based on the selected notification type, enter an email address, phone number, etc.

   d.d. Schema di avviso comune: è possibile scegliere di abilitare lo schema di avviso comune, che fornisce il vantaggio di avere un singolo payload degli avvisi estendibile e unificato per tutti i servizi di avviso in Monitoraggio di Azure.Common alert schema: You can choose to enable the common alert schema, which provides the advantage of having a single extensible and unified alert payload across all the alert services in Azure Monitor.

   

Configurare le azioniConfigure actions

1. Fare clic sul pulsante >azioni per passare alla scheda Azioni o selezionare la scheda Azioni nella parte superiore della schermata.Click the Next: Actions > button to move to the Actions tab, or select the Actions tab at the top of the screen.

2. Definire un elenco di azioni da attivare quando viene attivato un avviso.Define a list of actions to trigger when an alert is triggered. Per ogni azione, specificare quanto segue:Provide the following for each action:

   a.a. Tipo di azione: selezionare Runbook di Automazione, Funzione di Azure, ItsM, App per la logica, Webhook sicuro, Webhook.Action type: Select Automation Runbook, Azure Function, ITSM, Logic App, Secure Webhook, Webhook.

   b.b. Nome: immettere un nome univoco per l'azione.Name: Enter a unique name for the action.

   c.c. Dettagli: in base al tipo di azione, immettere un URI del webhook, un'app di Azure, una connessione itsm o un runbook di Automazione.Details: Based on the action type, enter a webhook URI, Azure app, ITSM connection, or Automation runbook. Per l'azione ITSM, specificare anche Elemento di lavoro e altri campi richiesti dallo strumento ITSM.For ITSM Action, additionally specify Work Item and other fields your ITSM tool requires.

   d.d. Schema di avviso comune: è possibile scegliere di abilitare lo schema di avviso comune, che fornisce il vantaggio di avere un singolo payload degli avvisi estendibile e unificato per tutti i servizi di avviso in Monitoraggio di Azure.Common alert schema: You can choose to enable the common alert schema, which provides the advantage of having a single extensible and unified alert payload across all the alert services in Azure Monitor.

   

Creare il gruppo di azioniCreate the action group

1. Volendo è possibile esplorare le impostazioni di Tag.You can explore the Tags settings if you like. Ciò consente di associare coppie chiave/valore al gruppo di azioni per la categorizzazione ed è una funzionalità disponibile per qualsiasi risorsa di Azure.This lets you associate key/value pairs to the action group for your categorization and is a feature available for any Azure resource.

   

2. Fare clic su Rivedi e crea per rivedere le impostazioni.Click Review + create to review the settings. Verrà eseguita una convalida rapida degli input per assicurarsi che tutti i campi obbligatori siano selezionati.This will do a quick validation of your inputs to make sure all the required fields are selected. Se sono presenti problemi, verranno segnalati qui.If there are issues, they'll be reported here. Dopo aver esaminato le impostazioni, fare clic su Crea per effettuare il provisioning del gruppo di azioni.Once you've reviewed the settings, click Create to provision the action group.

   

Gestire i gruppi di azioneManage your action groups

Dopo aver creato un gruppo di azioni, è possibile visualizzare Gruppi di azioni selezionando Gestisci azioni dalla pagina di destinazione Avvisi nel riquadro Monitoraggio.After you create an action group, you can view Action groups by selecting Manage actions from the Alerts landing page in Monitor pane. Selezionare il gruppo di azione da gestire per:Select the action group you want to manage to:

• Aggiungere, modificare o rimuovere azioni.Add, edit, or remove actions.
• Eliminare il gruppo di azione.Delete the action group.

Informazioni specifiche delle azioniAction specific information

Runbook di AutomazioneAutomation Runbook

Vedere i Limiti del servizio per la sottoscrizione di Azure per i limiti sui payload di Runbook.Refer to the Azure subscription service limits for limits on Runbook payloads.

Un Gruppo di azioni può contenere un numero limitato di azioni di tipo Runbook.You may have a limited number of Runbook actions in an Action Group.

Notifiche push dell'app AzureAzure app Push Notifications

Abilitare le notifiche push al app per dispositivi mobili di Azure specificando l'indirizzo di posta elettronica da usare come ID account durante la configurazione del app per dispositivi mobili di Azure.Enable push notifications to the Azure mobile app by providing the email address you use as your account ID when configuring the Azure mobile app.

Un Gruppo di azioni può contenere un numero limitato di azioni dell'app Azure.You may have a limited number of Azure app actions in an Action Group.

EmailEmail

I messaggi di posta elettronica verranno inviati dagli indirizzi di posta elettronica seguenti.Emails will be sent from the following email addresses. Verificare che il filtro della posta elettronica sia configurato correttamenteEnsure that your email filtering is configured appropriately

• azure-noreply@microsoft.com
• azureemail-noreply@microsoft.com
• alerts-noreply@mail.windowsazure.com

Un Gruppo di azioni può contenere un numero limitato di azioni di posta elettronica.You may have a limited number of email actions in an Action Group. Vedere l'articolo relativo alle informazioni sulla limitazione della frequenza.See the rate limiting information article.

Invia un messaggio di posta elettronica al ruolo di Azure Resource ManagerEmail Azure Resource Manager Role

Inviare il messaggio di posta elettronica ai membri del ruolo della sottoscrizione.Send email to the members of the subscription's role. Il messaggio di posta elettronica verrà inviato solo ai membri utente di Azure AD del ruolo.Email will only be sent to Azure AD user members of the role. Il messaggio di posta elettronica non verrà inviato a gruppi di Azure AD o entità servizio.Email will not be sent to Azure AD groups or service principals.

Un messaggio di posta elettronica di notifica viene inviato solo all'indirizzo di posta elettronica primario.A notification email is sent only to the primary email address.

Se non si ricevono notifiche nel messaggio di posta elettronica principale, è possibile provare a seguire questa procedura:If you are not receiving Notifications on your primary email, then you can try following steps:

1. In portale di Azure passare ad Active Directory.In Azure portal go to Active Directory.
2. Fare clic su Tutti gli utenti (nel riquadro sinistro) per visualizzare l'elenco degli utenti (nel riquadro destro).Click on All users (in left pane), you will see list of users (in right pane).
3. Selezionare l'utente per cui si desidera esaminare le informazioni di posta elettronica principali.Select the user for which you want to review the primary email information.

4. In Profilo utente in Contact Info (Info contatto) se la scheda "Email" (Posta elettronica) è vuota, fare clic sul pulsante Edit (Modifica) nella parte superiore e aggiungere il messaggio di posta elettronica principale e premere il pulsante Save (Salva) nella parte superiore. In User profile under Contact Info if "Email" tab is blank then click on edit button on the top and add your primary email and hit save button on the top.

Un Gruppo di azioni può contenere un numero limitato di azioni di posta elettronica.You may have a limited number of email actions in an Action Group. Vedere l'articolo relativo alle informazioni sulla limitazione della frequenza.See the rate limiting information article.

Durante la configurazione del ruolo arm di posta elettronica, è necessario assicurarsi che siano soddisfatte le 3 condizioni seguenti:While setting up Email ARM Role you need to make sure below 3 conditions are met:

1. Il tipo dell'entità assegnata al ruolo deve essere "User".The type of the entity being assigned to the role needs to be “User”.
2. L'assegnazione deve essere eseguita a livello di sottoscrizione.The assignment needs to be done at the subscription level.
3. L'utente deve avere un messaggio di posta elettronica configurato nel proprio profilo AAD.The user needs to have an email configured in their AAD profile.

FunzioneFunction

Chiama un endpoint di trigger HTTP esistente in Funzioni di Azure.Calls an existing HTTP trigger endpoint in Azure Functions. Per gestire una richiesta, l'endpoint deve gestire il verbo HTTP POST.To handle a request, your endpoint must handle the HTTP POST verb.

Un Gruppo di azioni può contenere un numero limitato di funzioni.You may have a limited number of Function actions in an Action Group.

Gestione dei servizi ITITSM

L'azione ITSM richiede una connessione ITSM.ITSM Action requires an ITSM Connection. Informazioni su come creare una connessione ITSM.Learn how to create an ITSM Connection.

Un Gruppo di azioni può contenere un numero limitato di azioni di gestione dei servizi IT.You may have a limited number of ITSM actions in an Action Group.

App per la logicaLogic App

Un Gruppo di azioni può contenere un numero limitato di azioni dell'app per la logica.You may have a limited number of Logic App actions in an Action Group.

Webhook protettoSecure Webhook

L'azione Webhook sicuro gruppi di azioni consente di sfruttare Azure Active Directory per proteggere la connessione tra il gruppo di azioni e l'API Web protetta (endpoint webhook).The Action Groups Secure Webhook action enables you to take advantage of Azure Active Directory to secure the connection between your action group and your protected web API (webhook endpoint). Di seguito è descritto il flusso di lavoro generale per sfruttare questa funzionalità.The overall workflow for taking advantage of this functionality is described below. Per una panoramica delle applicazioni Azure AD e delle entità servizio, vedere Panoramica di Microsoft Identity Platform (v 2.0).For an overview of Azure AD Applications and service principals, see Microsoft identity platform (v2.0) overview.

1. Creare un'applicazione Azure AD per l'API Web protetta.Create an Azure AD Application for your protected web API. Vedere Api Web protetta: Registrazione dell'app.See Protected web API: App registration.

   • Configurare l'API protetta in modo che sia chiamata da un'app daemon.Configure your protected API to be called by a daemon app.

2. Abilitare i gruppi di azioni per l'uso dell'applicazione Azure AD.Enable Action Groups to use your Azure AD Application.

   Nota

   Per eseguire questo script, è necessario essere un membro del ruolo di amministratore dell'applicazione Azure AD.You must be a member of the Azure AD Application Administrator role to execute this script.

   • Modificare la chiamata a Connect-AzureAD dello script di PowerShell per usare l'ID tenant di Azure AD.Modify the PowerShell script's Connect-AzureAD call to use your Azure AD Tenant ID.
   • Modificare la variabile dello script di PowerShell $myAzureADApplicationObjectId usare l'ID oggetto dell'Azure AD App.Modify the PowerShell script's variable $myAzureADApplicationObjectId to use the Object ID of your Azure AD Application.
   • Eseguire lo script modificato.Run the modified script.

3. Configurare l'azione del Webhook protetto del Gruppo di azioni.Configure the Action Group Secure Webhook action.

   • Copiare il valore $myApp.ObjectId dallo script e immetterlo nel campo ID oggetto applicazione nella definizione dell'azione Webhook.Copy the value $myApp.ObjectId from the script and enter it in the Application Object ID field in the Webhook action definition.

   

Script di PowerShell per il Webhook protettoSecure Webhook PowerShell Script

Connect-AzureAD -TenantId "<provide your Azure AD tenant ID here>"
    
# This is your Azure AD Application's ObjectId. 
$myAzureADApplicationObjectId = "<the Object ID of your Azure AD Application>"
    
# This is the Action Groups Azure AD AppId
$actionGroupsAppId = "461e8683-5575-4561-ac7f-899cc907d62a"
    
# This is the name of the new role we will add to your Azure AD Application
$actionGroupRoleName = "ActionGroupsSecureWebhook"
    
# Create an application role of given name and description
Function CreateAppRole([string] $Name, [string] $Description)
{
    $appRole = New-Object Microsoft.Open.AzureAD.Model.AppRole
    $appRole.AllowedMemberTypes = New-Object System.Collections.Generic.List[string]
    $appRole.AllowedMemberTypes.Add("Application");
    $appRole.DisplayName = $Name
    $appRole.Id = New-Guid
    $appRole.IsEnabled = $true
    $appRole.Description = $Description
    $appRole.Value = $Name;
    return $appRole
}
    
# Get my Azure AD Application, it's roles and service principal
$myApp = Get-AzureADApplication -ObjectId $myAzureADApplicationObjectId
$myAppRoles = $myApp.AppRoles
$actionGroupsSP = Get-AzureADServicePrincipal -Filter ("appId eq '" + $actionGroupsAppId + "'")

Write-Host "App Roles before addition of new role.."
Write-Host $myAppRoles
    
# Create the role if it doesn't exist
if ($myAppRoles -match "ActionGroupsSecureWebhook")
{
    Write-Host "The Action Groups role is already defined.`n"
}
else
{
    $myServicePrincipal = Get-AzureADServicePrincipal -Filter ("appId eq '" + $myApp.AppId + "'")
    
    # Add our new role to the Azure AD Application
    $newRole = CreateAppRole -Name $actionGroupRoleName -Description "This is a role for Action Groups to join"
    $myAppRoles.Add($newRole)
    Set-AzureADApplication -ObjectId $myApp.ObjectId -AppRoles $myAppRoles
}
    
# Create the service principal if it doesn't exist
if ($actionGroupsSP -match "AzNS AAD Webhook")
{
    Write-Host "The Service principal is already defined.`n"
}
else
{
    # Create a service principal for the Action Groups Azure AD Application and add it to the role
    $actionGroupsSP = New-AzureADServicePrincipal -AppId $actionGroupsAppId
}
    
New-AzureADServiceAppRoleAssignment -Id $myApp.AppRoles[0].Id -ResourceId $myServicePrincipal.ObjectId -ObjectId $actionGroupsSP.ObjectId -PrincipalId $actionGroupsSP.ObjectId
    
Write-Host "My Azure AD Application (ObjectId): " + $myApp.ObjectId
Write-Host "My Azure AD Application's Roles"
Write-Host $myApp.AppRoles

smsSMS

Per altre informazioni importanti, vedere le informazioni sulla limitazione della frequenza e sul comportamento degli avvisi SMS.See the rate limiting information and SMS alert behavior for additional important information.

Un Gruppo di azioni può contenere un numero limitato di azioni SMS.You may have a limited number of SMS actions in an Action Group.

I prezzi per i paesi/regioni supportati sono elencati nella pagina relativa ai prezzi di Monitoraggio di Azure.Pricing for supported countries/regions is listed in the Azure Monitor pricing page.

Elenco dei paesi in cui è supportata la notifica SMSList of Countries where SMS Notification is supported

Chiamata vocaleVoice

Per altre informazioni importanti, vedere le informazioni sulla limitazione della frequenza.See the rate limiting information article for additional important behavior.

Un Gruppo di azioni può contenere un numero limitato di azioni Voce.You may have a limited number of Voice actions in an Action Group.

I prezzi per i paesi/regioni supportati sono elencati nella pagina relativa ai prezzi di Monitoraggio di Azure.Pricing for supported countries/regions is listed in the Azure Monitor pricing page.

webhookWebhook

I webhook vengono elaborati usando le regole seguentiWebhooks are processed using the following rules

• Viene tentata una chiamata webhook per un massimo di 3 volte.A webhook call is attempted a maximum of 3 times.
• La chiamata verrà ritentata se non viene ricevuta una risposta entro il periodo di timeout o se viene restituito uno dei codici di stato HTTP seguenti: 408, 429, 503 o 504.The call will be retried if a response is not received within the timeout period or one of the following HTTP status codes is returned: 408, 429, 503 or 504.
• La prima chiamata attenderà 10 secondi per una risposta.The first call will wait 10 seconds for a response.
• Il secondo e il terzo tentativo attenderanno 30 secondi per una risposta.The second and third attempts will wait 30 seconds for a response.
• Dopo che i 3 tentativi di chiamare il webhook hanno avuto esito negativo, nessun gruppo di azioni chiamerà l'endpoint per 15 minuti.After the 3 attempts to call the webhook have failed no action group will call the endpoint for 15 minutes.

Vedere Indirizzi IP del gruppo di azioni per gli intervalli di indirizzi IP di origine.Please see Action Group IP Addresses for source IP address ranges.

Passaggi successiviNext steps

• Altre informazioni sul Comportamento degli avvisi SMS.Learn more about SMS alert behavior.
• Leggere le informazioni sullo schema webhook degli avvisi del log attività.Gain an understanding of the activity log alert webhook schema.
• Altre informazioni sul connettore itsm.Learn more about ITSM Connector.
• Altre informazioni sulla limitazione della frequenza degli avvisi.Learn more about rate limiting on alerts.
• Leggere una panoramica degli avvisi del log attività e informazioni su come ricevere gli avvisi.Get an overview of activity log alerts, and learn how to receive alerts.
• Informazioni su come configurare gli avvisi ogni volta che viene inviata una notifica sull'integrità del servizio.Learn how to configure alerts whenever a service health notification is posted.