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

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. In una sottoscrizione è possibile configurare fino a 2000 gruppi di azioni.You may configure up to 2,000 action groups in a subscription.

Viene configurata un'azione per inviare una notifica a un utente tramite posta elettronica o SMS, viene ricevuta una conferma che indica che sono stati aggiunti al gruppo di azioni.You configure an action to notify a person by email or SMS, they receive a confirmation indicating they have been added to the action group.

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:

  • Nome: un identificatore univoco all'interno del gruppo di azioni.Name: A unique identifier within the action group.
  • Tipo di azione: Azione eseguita.Action type: The 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.
  • Dettagli: Dettagli corrispondenti che variano in base al tipo di azione.Details: The corresponding details that vary by action 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 selezionare Monitoraggio.In the Azure portal, select Monitor. Il riquadro monitoraggio consolida tutte le impostazioni e i dati di monitoraggio in un'unica visualizzazione.The Monitor pane consolidates all your monitoring settings and data in one view.

    Servizio "Monitoraggio"

  2. Selezionare avvisi quindi selezionare Gestisci azioni.Select Alerts then select Manage actions.

    Pulsante Gestisci azioni

  3. Selezionare Aggiungi gruppo di azione e compilare i campi.Select Add action group, and fill in the fields.

    Comando "Aggiungi gruppo di azione"

  4. Immettere un nome nella casella Nome gruppo di azione e un nome nella casella Nome breve gruppo di azione.Enter a name in the Action group name box, and enter a name in the Short name box. Il nome breve viene usato al posto del nome completo di un gruppo di azione quando le notifiche vengono inviate usando questo gruppo.The short name is used in place of a full action group name when notifications are sent using this group.

    Finestra di dialogo "Aggiungi gruppo di azione"

  5. Nella casella Sottoscrizione viene inserita automaticamente la sottoscrizione corrente.The Subscription box autofills with your current subscription. Il gruppo di azione verrà salvato in questa sottoscrizione.This subscription is the one in which the action group is saved.

  6. Selezionare il gruppo di risorse in cui verrà salvato il gruppo di azione.Select the Resource group in which the action group is saved.

  7. Definire un elenco di azioni.Define a list of actions. Per ogni azione, specificare quanto segue:Provide the following for each action:

    1. Nome: immettere un identificatore univoco per questa azione.Name: Enter a unique identifier for this action.

    2. Tipo di azione: selezionare Messaggio di posta elettronica/SMS/Push/Voce, App per la logica, Webhook, ITSM o Runbook di Automazione.Action Type: Select Email/SMS/Push/Voice, Logic App, Webhook, ITSM, or Automation Runbook.

    3. Dettagli: in base al tipo di azione, immettere un numero di telefono, un indirizzo di posta elettronica, l'URI del webhook, l'app Azure, la connessione ITSM o il runbook di Automazione.Details: Based on the action type, enter a phone number, email address, 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.

    4. Schema di avviso comune: È possibile scegliere di abilitare lo schema di avviso comune, che offre il vantaggio di avere un singolo payload di avviso estendibile e unificato in tutti i servizi di avviso di 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.

  8. Fare clic su OK per creare il gruppo di azione.Select OK to create the action group.

Gestire i gruppi di azioneManage your action groups

Dopo aver creato un gruppo di azione, questo sarà visibile nella sezione gruppi di azioni del riquadro monitoraggio .After you create an action group, it's visible in the Action groups section of the 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

Nota

Vedere limiti del servizio di sottoscrizione per il monitoraggio dei limiti numerici per ognuno degli elementi seguenti.See Subscription Service Limits for Monitoring for numeric limits on each of the items below.

Runbook di AutomazioneAutomation Runbook

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

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

Notifiche push dell'app AzureAzure app Push Notifications

Un gruppo di azioni può contenere un numero limitato di azioni dell'app di 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 un messaggio di posta elettronica ai membri del ruolo della sottoscrizione.Send email to the members of the subscription's role.

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.

FunzioneFunction

I tasti funzione per le app per le funzioni configurate come azioni vengono letti tramite l'API Functions, che attualmente richiede app per le funzioni V2 per configurare l'impostazione dell'app "AzureWebJobsSecretStorageType" su "files".The function keys for Function Apps configured as actions are read through the Functions API, which currently requires v2 function apps to configure the app setting “AzureWebJobsSecretStorageType” to “files”. Per ulteriori informazioni, vedere modifiche alla gestione delle chiavi in funzioni V2.For more information, see Changes to Key Management in Functions V2.

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

ITSMITSM

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 ITSM.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 sicuroSecure Webhook

La funzionalità di Webhook sicura è attualmente disponibile in anteprima.The Secure Webhook functionality is currently in Preview.

L'azione webhook dei gruppi di azione 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 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). Il flusso di lavoro generale per sfruttare questa funzionalità è descritto di seguito.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 https://docs.microsoft.com/azure/active-directory/develop/scenario-protected-web-api-overview.See https://docs.microsoft.com/azure/active-directory/develop/scenario-protected-web-api-overview.

    • Configurare l'API protetta affinché venga 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 del 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 per usare l'ID oggetto dell'applicazione Azure ADModify 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 protetta del gruppo di azione.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.

    Azione di Webhook sicura

Script di PowerShell per il webhook sicuroSecure 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 ($myApp.ObjectId): " + $myApp.ObjectId
Write-Host "My Azure AD Application's Roles"
Write-Host $myApp.AppRoles

smsSMS

Per ulteriori informazioni importanti, vedere le informazioni sulla limitazione della frequenza e il 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.

Chiamata vocaleVoice

Vedere l'articolo relativo alle informazioni sulla limitazione della frequenza .See the rate limiting information article.

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

webhookWebhook

I webhook vengono ripetuti usando le regole seguenti.Webhooks are retried using the following rules. La chiamata al webhook viene ritentata al massimo due volte quando vengono restituiti i codici di stato HTTP seguenti: 408, 429, 503, 504 o l'endpoint HTTP non risponde.The webhook call is retried a maximum of 2 times when the following HTTP status codes are returned: 408, 429, 503, 504 or the HTTP endpoint does not respond. La prima ripetizione del tentativo avviene dopo 10 secondi.The first retry happens after 10 seconds. la seconda dopo 100 secondi.The second retry happens after 100 seconds. Dopo due errori, nessun gruppo di azione chiamerà l'endpoint per 30 minuti.After two failures, no action group will call the endpoint for 30 minutes.

Intervalli di indirizzi IP di origineSource IP address ranges

  • 13.72.19.23213.72.19.232
  • 13.106.57.18113.106.57.181
  • 13.106.54.313.106.54.3
  • 13.106.54.1913.106.54.19
  • 13.106.38.14213.106.38.142
  • 13.106.38.14813.106.38.148
  • 13.106.57.19613.106.57.196
  • 13.106.57.19713.106.57.197
  • 52.244.68.11752.244.68.117
  • 52.244.65.13752.244.65.137
  • 52.183.31.052.183.31.0
  • 52.184.145.16652.184.145.166
  • 51.4.138.19951.4.138.199
  • 51.5.148.8651.5.148.86
  • 51.5.149.1951.5.149.19

Per ricevere gli aggiornamenti relativi alle modifiche apportate a questi indirizzi IP, è consigliabile configurare un avviso di integrità del servizio che monitora le notifiche informative relative al servizio gruppi di azioni.To receive updates about changes to these IP addresses, we recommend you configure a Service Health alert, which monitors for Informational notifications about the Action Groups service.

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

Passaggi successiviNext steps