Criar e gerenciar grupos de ações no portal do AzureCreate and manage action groups in the Azure portal

Um grupo de ações é uma coleção de preferências de notificação definidas pelo proprietário de uma assinatura do Azure.An action group is a collection of notification preferences defined by the owner of an Azure subscription. Alertas do Azure Monitor e da Integridade do Serviço usam grupos de ações para notificar usuários de que um alerta foi disparado.Azure Monitor and Service Health alerts use action groups to notify users that an alert has been triggered. Vários alertas podem usar o mesmo grupo de ação ou grupos de ações diferentes dependendo dos requisitos do usuário.Various alerts may use the same action group or different action groups depending on the user's requirements. Você pode configurar até 2 mil grupos de ação em uma assinatura.You may configure up to 2,000 action groups in a subscription.

Você configura uma ação para notificar uma pessoa por email ou SMS, elas recebem uma confirmação indicando que foram adicionadas ao grupo de ações.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.

Este artigo mostra como criar e gerenciar grupos de ação no Portal do Azure.This article shows you how to create and manage action groups in the Azure portal.

Cada ação é composta das seguintes propriedades:Each action is made up of the following properties:

  • Nome: um identificador exclusivo dentro do grupo de ações.Name: A unique identifier within the action group.
  • Tipo de ação: A ação executada.Action type: The action performed. Exemplos incluem o envio de um email de chamada, SMS, voz; ou disparando vários tipos de ações automatizadas.Examples include sending a voice call, SMS, email; or triggering various types of automated actions. Veja os tipos mais adiante neste artigo.See types later in this article.
  • Detalhes: Os detalhes correspondentes que variam de acordo com o tipo de ação.Details: The corresponding details that vary by action type.

Para saber mais sobre como usar modelos do Azure Resource Manager para configurar grupos de ação, veja Modelos do Resource Manager de grupos de ações.For information on how to use Azure Resource Manager templates to configure action groups, see Action group Resource Manager templates.

Como criar um grupo de ações usando o portal do AzureCreate an action group by using the Azure portal

  1. No portal do Azure, selecione Monitor.In the Azure portal, select Monitor. O painel Monitor consolida todas as suas configurações e dados de monitoramento em uma exibição.The Monitor pane consolidates all your monitoring settings and data in one view.

    O serviço “Monitor”

  2. Selecione alertas e, em seguida, selecione Gerenciar ações.Select Alerts then select Manage actions.

    Botão Gerenciar ações

  3. Selecione Adicionar grupo de ações e preencha os campos.Select Add action group, and fill in the fields.

    O comando "Adicionar grupo de ações"

  4. Insira um nome na caixa Nome do grupo de ação e, em seguida, digite um nome na caixa Nome curto.Enter a name in the Action group name box, and enter a name in the Short name box. O nome curto é usado no lugar de um nome de grupo de ação completo quando as notificações são enviadas usando esse grupo.The short name is used in place of a full action group name when notifications are sent using this group.

    Caixa de diálogo Adicionar grupo de ações

  5. A caixa Assinatura é automaticamente preenchida com a sua assinatura atual.The Subscription box autofills with your current subscription. Esta assinatura é aquela na qual o grupo de ação é salvo.This subscription is the one in which the action group is saved.

  6. Selecione o Grupo de recursos no qual o grupo de ações é salvo.Select the Resource group in which the action group is saved.

  7. Defina uma lista de ações.Define a list of actions. Forneça o seguinte para cada ação:Provide the following for each action:

    1. Nome: insira um identificador exclusivo para esta ação.Name: Enter a unique identifier for this action.

    2. Tipo de ação: selecione Email/SMS/Push/Voz, Aplicativo Lógico, Webhook, ITSM ou Runbook de Automação.Action Type: Select Email/SMS/Push/Voice, Logic App, Webhook, ITSM, or Automation Runbook.

    3. Detalhes: de acordo com o tipo de ação, insira um número de telefone, endereço de email, URI de webhook, aplicativo do Azure, conexão de ITSM ou runbook de Automação.Details: Based on the action type, enter a phone number, email address, webhook URI, Azure app, ITSM connection, or Automation runbook. Para Ação do ITSM, além disso, especifique Item de Trabalho e outros campos necessários para a ferramenta de ITSM.For ITSM Action, additionally specify Work Item and other fields your ITSM tool requires.

    4. Esquema de alerta comum: Você pode optar por habilitar o esquema de alerta comum, que fornece a vantagem de ter uma única carga de alerta extensível e unificada em todos os serviços de alerta no Azure monitor.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. Selecione OK para criar o grupo de ações.Select OK to create the action group.

Gerenciar seus grupos de açãoManage your action groups

Depois de criar um grupo de ações, ele fica visível na seção grupos de ações do painel Monitor .After you create an action group, it's visible in the Action groups section of the Monitor pane. Selecione o grupo de ações que você deseja gerenciar:Select the action group you want to manage to:

  • Adicionar, editar ou remover ações.Add, edit, or remove actions.
  • Excluir o grupo de ação.Delete the action group.

Informações específicas da açãoAction specific information

Observação

Consulte limites de serviço de assinatura para o monitoramento de limites numéricos em cada um dos itens abaixo.See Subscription Service Limits for Monitoring for numeric limits on each of the items below.

Notificações de Envio por Push do Aplicativo AzureAzure app Push Notifications

Você pode ter um número limitado de ações de aplicativo do Azure em um grupo de ação.You may have a limited number of Azure app actions in an Action Group.

EmailEmail

Os emails serão enviados dos endereços de email a seguir.Emails will be sent from the following email addresses. Certifique-se de que a filtragem de email esteja configurada adequadamenteEnsure that your email filtering is configured appropriately

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

Você pode ter um número limitado de ações de email em um grupo de ações.You may have a limited number of email actions in an Action Group. Consulte o artigo informações de limitação de taxa .See the rate limiting information article.

ITSMITSM

Ação de ITSM exige uma Conexão de ITSM.ITSM Action requires an ITSM Connection. Saiba como criar uma Conexão de ITSM.Learn how to create an ITSM Connection.

Você pode ter um número limitado de ações de ITSM em um grupo de ações.You may have a limited number of ITSM actions in an Action Group.

Aplicativo LógicoLogic App

Você pode ter um número limitado de ações de aplicativo lógico em um grupo de ação.You may have a limited number of Logic App actions in an Action Group.

FunçãoFunction

As chaves de função para aplicativos de funções configuradas como ações são lidas por meio da API do functions, que atualmente requer que os aplicativos de função v2 definam a configuração do aplicativo "AzureWebJobsSecretStorageType" como "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”. Para obter mais informações, consulte alterações no gerenciamento de chaves no functions v2.For more information, see Changes to Key Management in Functions V2.

Você pode ter um número limitado de ações de função em um grupo de ações.You may have a limited number of Function actions in an Action Group.

Runbook de AutomaçãoAutomation Runbook

Consulte os limites do serviço de assinatura do Azure para limites em cargas de runbook.Refer to the Azure subscription service limits for limits on Runbook payloads.

Você pode ter um número limitado de ações de runbook em um grupo de ações.You may have a limited number of Runbook actions in an Action Group.

SMSSMS

Consulte as informações de limitação de taxa e o comportamento de alerta do SMS para obter informações importantes adicionais.See the rate limiting information and SMS alert behavior for additional important information.

Você pode ter um número limitado de ações de SMS em um grupo de ações.You may have a limited number of SMS actions in an Action Group.

VozVoice

Consulte o artigo informações de limitação de taxa .See the rate limiting information article.

Você pode ter um número limitado de ações de voz em um grupo de ações.You may have a limited number of Voice actions in an Action Group.

WebhookWebhook

Os WebHooks são repetidos usando as regras a seguir.Webhooks are retried using the following rules. A chamada de webhook é repetida no máximo duas vezes quando os seguintes códigos de status HTTP são retornados: 408, 429, 503, 504 ou quando o ponto de extremidade HTTP não responder.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. A primeira nova tentativa ocorre após 10 segundos.The first retry happens after 10 seconds. A segunda tentativa ocorre após 100 segundos.The second retry happens after 100 seconds. Após duas falhas, nenhum grupo de ação chamará o ponto de extremidade por 30 minutos.After two failures, no action group will call the endpoint for 30 minutes.

Intervalos de endereços IP de fonteSource 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

Para receber atualizações sobre alterações nesses endereços IP, recomendamos que você configure um alerta de integridade do serviço, que monitora as notificações informativas sobre o serviço de grupos de ação.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.

Você pode ter um número limitado de ações de webhook em um grupo de ações.You may have a limited number of Webhook actions in an Action Group.

Proteger webhookSecure Webhook

A funcionalidade proteger webhook está atualmente em versão prévia.The Secure Webhook functionality is currently in Preview.

A ação de webhook de grupos de ações permite que você aproveite Azure Active Directory para proteger a conexão entre o grupo de ação e a API Web protegida (ponto de extremidade do 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). O fluxo de trabalho geral para aproveitar essa funcionalidade é descrito abaixo.The overall workflow for taking advantage of this functionality is described below. Para obter uma visão geral dos aplicativos do Azure AD e das entidades de serviço, consulte visão geral da plataforma Microsoft Identity (v 2.0).For an overview of Azure AD Applications and service principals, see Microsoft identity platform (v2.0) overview.

  1. Crie um aplicativo do Azure AD para sua API Web protegida.Create an Azure AD Application for your protected web API. Consulte 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.

    • Configure sua API protegida para ser chamada por um aplicativo daemon.Configure your protected API to be called by a daemon app.
  2. Habilite grupos de ação para usar seu aplicativo do Azure AD.Enable Action Groups to use your Azure AD Application.

    Observação

    Você deve ser membro da função de administrador de aplicativos do Azure ad para executar esse script.You must be a member of the Azure AD Application Administrator role to execute this script.

    • Modifique a chamada Connect-AzureAD do script do PowerShell para usar sua ID de locatário do Azure AD.Modify the PowerShell script's Connect-AzureAD call to use your Azure AD Tenant ID.
    • Modifique a variável do script do PowerShell $myAzureADApplicationObjectId para usar a ID de objeto do seu aplicativo do Azure ADModify the PowerShell script's variable $myAzureADApplicationObjectId to use the Object ID of your Azure AD Application
    • Execute o script modificado.Run the modified script.
  3. Configure a ação de webhook do grupo de ações.Configure the Action Group Webhook action.

    • Copie o valor $myApp. ObjectId do script e insira-o no campo ID de objeto do aplicativo na definição de ação do webhook.Copy the value $myApp.ObjectId from the script and enter it in the Application Object ID field in the Webhook action definition.

    Ação proteger webhook

Script do PowerShell de webhook seguroSecure 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

Próximas etapasNext steps