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

Um grupo de ação é uma coleção de preferências de notificação definidas pelo proprietário de uma subscrição Azure.An action group is a collection of notification preferences defined by the owner of an Azure subscription. Os alertas Azure Monitor e Service Health utilizam grupos de ação para notificar os utilizadores de que foi desencadeado um alerta.Azure Monitor and Service Health alerts use action groups to notify users that an alert has been triggered. Vários alertas podem utilizar o mesmo grupo de ação ou diferentes grupos de ação, dependendo dos requisitos do utilizador.Various alerts may use the same action group or different action groups depending on the user's requirements.

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

Cada ação é constituída pelas seguintes propriedades:Each action is made up of the following properties:

  • Tipo: A notificação ou ação realizada.Type: The notification or action performed. Exemplos incluem envio de uma chamada de voz, SMS, e-mail; ou desencadeando 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 tarde neste artigo.See types later in this article.
  • Nome: Um identificador único dentro do grupo de ação.Name: A unique identifier within the action group.
  • Detalhes: Os detalhes correspondentes que variam por tipo.Details: The corresponding details that vary by type.

Para obter informações sobre como utilizar modelos do Gestor de Recursos Azure para configurar grupos de ação, consulte os modelos do Gestor de Recursos do grupo action.For information on how to use Azure Resource Manager templates to configure action groups, see Action group Resource Manager templates.

Criar um grupo de ação utilizando o portal AzureCreate an action group by using the Azure portal

  1. No portal Azure,procure e selecione Monitor.In the Azure portal, search for and select Monitor. O painel monitor consolida todas as suas definições e dados de monitorização numa única vista.The Monitor pane consolidates all your monitoring settings and data in one view.

  2. Selecione Alertas e, em seguida, selecione Gerir as ações.Select Alerts, then select Manage actions.

    Gerir botão de ações

  3. Selecione Adicionar grupo de ação e preencha os campos relevantes na experiência do assistente.Select Add action group, and fill in the relevant fields in the wizard experience.

    O comando "Adicionar grupo de ação"

Configurar configurações básicas do grupo de açãoConfigure basic action group settings

Nos detalhes do projeto:Under Project details:

Selecione o grupo de subscrição e recursos no qual o grupo de ação é guardado.Select the Subscription and Resource group in which the action group is saved.

De acordo com os detalhes do exemplo:Under Instance details:

  1. Insira um nome de grupo action.Enter an Action group name.

  2. Introduza um nome de Exibição.Enter a Display name. O nome do visor é utilizado em vez de um nome de grupo de ação completo quando as notificações são enviadas usando este grupo.The display name is used in place of a full action group name when notifications are sent using this group.

    Caixa de diálogo do grupo de ação Add

Configurar notificaçõesConfigure notifications

  1. Clique no seguinte: Notificações > botão para mover para o separador Notificações ou selecione o separador Notificações na parte superior do ecrã.Click the Next: Notifications > button to move to the Notifications tab, or select the Notifications tab at the top of the screen.

  2. Defina uma lista de notificações a enviar quando um alerta é desencadeado.Define a list of notifications to send when an alert is triggered. Fornecer o seguinte para cada notificação:Provide the following for each notification:

    a.a. Tipo de notificação: Selecione o tipo de notificação que pretende enviar.Notification type: Select the type of notification you want to send. As opções disponíveis são:The available options are:

    • Email Azure Resource Manager Role - Envie um e-mail para os utilizadores atribuídos a determinadas funções ARM de nível de subscrição.Email Azure Resource Manager Role - Send an email to users assigned to certain subscription-level ARM roles.
    • Email/SMS/Push/Voice - Envie estes tipos de notificação para destinatários específicos.Email/SMS/Push/Voice - Send these notification types to specific recipients.

    b.b. Nome: Introduza um nome único para a notificação.Name: Enter a unique name for the notification.

    c.c. Detalhes: Com base no tipo de notificação selecionado, insira um endereço de e-mail, número de telefone, etc.Details: Based on the selected notification type, enter an email address, phone number, etc.

    d.d. Esquema comum de alerta: Pode optar por ativar o esquema comum de alerta,que proporciona a vantagem de ter uma única carga de alerta extensível e unificada em todos os serviços de alerta do Monitor 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.

    O separador Notificações

Configure açõesConfigure actions

  1. Clique no Seguinte: As ações > botão para mover-se para o separador Ações ou selecione o separador Ações na parte superior do ecrã.Click the Next: Actions > button to move to the Actions tab, or select the Actions tab at the top of the screen.

  2. Defina uma lista de ações para desencadear quando um alerta é desencadeado.Define a list of actions to trigger when an alert is triggered. Fornecer o seguinte para cada ação:Provide the following for each action:

    a.a. Tipo de ação: Selecione O Runbook automation, Azure Function, ITSM, Logic App, Secure Webhook, Webhook.Action type: Select Automation Runbook, Azure Function, ITSM, Logic App, Secure Webhook, Webhook.

    b.b. Nome: Introduza um nome único para a ação.Name: Enter a unique name for the action.

    c.c. Detalhes: Com base no tipo de ação, introduza um webhook URI, app Azure, conexão ITSM ou livro de automação.Details: Based on the action type, enter a webhook URI, Azure app, ITSM connection, or Automation runbook. Para a AÇÃO ITSM, especifique ainda o Produto de Trabalho e outros campos que a sua ferramenta ITSM necessita.For ITSM Action, additionally specify Work Item and other fields your ITSM tool requires.

    d.d. Esquema comum de alerta: Pode optar por ativar o esquema comum de alerta,que proporciona a vantagem de ter uma única carga de alerta extensível e unificada em todos os serviços de alerta do Monitor 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.

    O separador Ações

Criar o grupo de açãoCreate the action group

  1. Se quiser, pode explorar as definições de Etiquetas.You can explore the Tags settings if you like. Isto permite-lhe associar pares chave/valor ao grupo de ação para a sua categorização e é uma funcionalidade disponível para qualquer recurso Azure.This lets you associate key/value pairs to the action group for your categorization and is a feature available for any Azure resource.

    O separador Tags

  2. Clique em Rever + criar para rever as definições.Click Review + create to review the settings. Isto fará uma validação rápida das suas entradas para garantir que todos os campos necessários são selecionados.This will do a quick validation of your inputs to make sure all the required fields are selected. Se existirem problemas, serão comunicados aqui.If there are issues, they'll be reported here. Depois de rever as definições, clique em Criar para providenciar o grupo de ação.Once you've reviewed the settings, click Create to provision the action group.

    O separador Review + create

Nota

Quando configura uma ação para notificar uma pessoa por e-mail ou SMS, recebe uma confirmação indicando que foi adicionada ao grupo de ação.When 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.

Gerir os seus grupos de açãoManage your action groups

Depois de criar um grupo de ação, pode ver grupos de ação selecionando As ações de Gerir a partir da página de aterragem alertas no painel monitor.After you create an action group, you can view Action groups by selecting Manage actions from the Alerts landing page in Monitor pane. Selecione o grupo de ação que pretende gerir para:Select the action group you want to manage to:

  • Adicione, edite ou remova as ações.Add, edit, or remove actions.
  • Apague o grupo de ação.Delete the action group.

Informação específica da açãoAction specific information

Nota

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

Runbook de AutomatizaçãoAutomation Runbook

Consulte os limites do serviço de subscrição Azure para limites nas cargas executadas.Refer to the Azure subscription service limits for limits on Runbook payloads.

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

Notificações push da aplicação AzureAzure app Push Notifications

Ativar notificações push para a aplicação móvel Azure, fornecendo o endereço de e-mail que utiliza como iD da sua conta ao configurar a aplicação móvel 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.

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

E-mailEmail

Os e-mails serão enviados a partir dos seguintes endereços de e-mail.Emails will be sent from the following email addresses. Certifique-se de que a sua filtragem de e-mail está 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 e-mail em um Grupo de Ação.You may have a limited number of email actions in an Action Group. Consulte o artigo de informação limitativo da taxa.See the rate limiting information article.

Enviar e-mail a Função do Azure Resource ManagerEmail Azure Resource Manager Role

Envie e-mail aos membros da função da subscrição.Send email to the members of the subscription's role. O e-mail só será enviado para os membros do utilizador AZure AD da função.Email will only be sent to Azure AD user members of the role. O e-mail não será enviado aos grupos ou principais de serviço do Azure Active Directory.Email will not be sent to Azure AD groups or service principals.

Um e-mail de notificação é enviado apenas para o endereço de e-mail primário.A notification email is sent only to the primary email address.

Se não estiver a receber Notificações no seu email principal, pode tentar seguir os seguintes passos:If you are not receiving Notifications on your primary email, then you can try following steps:

  1. No portal Azure vai para o Ative Directory.In Azure portal go to Active Directory.
  2. Clique em Todos os utilizadores (no painel esquerdo), verá a lista de utilizadores (no painel direito).Click on All users (in left pane), you will see list of users (in right pane).
  3. Selecione o utilizador para o qual pretende rever as informações de e-mail primárias.Select the user for which you want to review the primary email information.

Exemplo sobre como rever o perfil do utilizador.

  1. No perfil do Utilizador em Informação de Contacto se o separador "Email" estiver em branco, clique no botão de edição na parte superior e adicione o seu e-mail primário e clique no botão de guardar na parte superior.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.

Exemplo sobre como adicionar e-mail primário.

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

FunçãoFunction

Chama um ponto final de gatilho HTTP existente em Funções Azure.Calls an existing HTTP trigger endpoint in Azure Functions. Para lidar com um pedido, o seu ponto final deve manusear o verbo HTTP POST.To handle a request, your endpoint must handle the HTTP POST verb.

Pode ter um número limitado de ações de função num Grupo de Ação.You may have a limited number of Function actions in an Action Group.

ITSMITSM

A AÇÃO ITSM requer uma Ligação ITSM.ITSM Action requires an ITSM Connection. Saiba como criar uma ligação ITSM.Learn how to create an ITSM Connection.

Poderá ter um número limitado de ações ITSM num Grupo de Ação.You may have a limited number of ITSM actions in an Action Group.

Aplicação LógicaLogic App

Você pode ter um número limitado de ações de Aplicação Lógica em um Grupo de Ação.You may have a limited number of Logic App actions in an Action Group.

Webhook SeguroSecure Webhook

A ação Action Groups Secure Webhook permite-lhe aproveitar o Azure Ative Directory para garantir a ligação entre o seu grupo de ação e a sua API web protegida (webhook endpoint).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). O fluxo de trabalho global para tirar partido desta funcionalidade é descrito abaixo.The overall workflow for taking advantage of this functionality is described below. Para obter uma visão geral das aplicações ad da Azure e dos principais serviços, consulte a plataforma de identidade da Microsoft (v2.0).For an overview of Azure AD Applications and service principals, see Microsoft identity platform (v2.0) overview.

Nota

A utilização da ação webhook requer que o ponto final do webhook alvo não exija que os detalhes do alerta funcionem com sucesso ou é capaz de analisar as informações de contexto de alerta fornecidas como parte da operação POST.Using the webhook action requires that the target webhook endpoint either doesn't require details of the alert to function successfully or it's capable of parsing the alert context information that's provided as part of the POST operation. Se o ponto final do webhook não conseguir lidar com as informações de contexto de alerta por si só, pode utilizar uma solução como uma ação da Logic App para uma manipulação personalizada das informações de contexto de alerta para corresponder ao formato de dados esperado do webhook.If the webhook endpoint can't handle the alert context information on its own, you can use a solution like a Logic App action for a custom manipulation of the alert context information to match the webhook's expected data format.

  1. Crie uma Aplicação AD Azure para a sua API web protegida.Create an Azure AD Application for your protected web API. Ver API web protegida: registo de aplicações.See Protected web API: App registration.

  2. Ative os Grupos de Ação para utilizar a sua aplicação AD Azure.Enable Action Groups to use your Azure AD Application.

    Nota

    Você deve ser um membro da função de Administrador de Aplicação AD Azure para executar este script.You must be a member of the Azure AD Application Administrator role to execute this script.

    • Modifique a chamada de Connect-AzureAD do script PowerShell para usar o seu ID do inquilino Azure.Modify the PowerShell script's Connect-AzureAD call to use your Azure AD Tenant ID.
    • Modifique a variável $myAzureADApplicationObjectId do script PowerShell para utilizar o ID do objeto da sua aplicação AD Azure.Modify the PowerShell script's variable $myAzureADApplicationObjectId to use the Object ID of your Azure AD Application.
    • Executar o script modificado.Run the modified script.
  3. Configure a ação do Action Group Secure Webhook.Configure the Action Group Secure Webhook action.

    • Copie o valor $myApp.ObjectId a partir do script e introduza-o no campo de ID do objeto de aplicação na definição de ação 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 Segura webhook

Script Seguro Webhook PowerShellSecure 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

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

Pode ter um número limitado de ações de SMS num Grupo de Ação.You may have a limited number of SMS actions in an Action Group.

Nota

Se a interface de utilizador do grupo de ação do portal Azure não o permitir selecionar o seu código país/região, então o SMS não é suportado para o seu país/região.If the Azure portal action group user interface does not let you select your country/region code, then SMS is not supported for your country/region. Se o código país/região não estiver disponível, pode votar para que o seu país/região seja adicionado à voz do utilizador.If your country/region code is not available, you can vote to have your country/region added at user voice. Entretanto, um trabalho em torno é fazer com que o seu grupo de ação ligue para um webhook a um fornecedor de SMS de terceiros com apoio no seu país/região.In the meantime, a work around is to have your action group call a webhook to a third-party SMS provider with support in your country/region.

Os preços dos países/regiões apoiados constam da página de preços do Azure Monitor.Pricing for supported countries/regions is listed in the Azure Monitor pricing page.

Lista de países onde a notificação por SMS é suportadaList of Countries where SMS Notification is supported

Código do PaísCountry Code Nome do PaísCountry Name
6161 AustráliaAustralia
4343 ÁustriaAustria
3232 BélgicaBelgium
5555 BrasilBrazil
11 CanadáCanada
5656 ChileChile
8686 ChinaChina
420420 República ChecaCzech Republic
4545 DinamarcaDenmark
372372 EstóniaEstonia
358358 FinlândiaFinland
3333 FrançaFrance
4949 AlemanhaGermany
852852 RAE de Hong KongHong Kong
9191 ÍndiaIndia
353353 IrlandaIreland
972972 IsraelIsrael
3939 ItáliaItaly
8181 JapãoJapan
352352 LuxemburgoLuxembourg
6060 MalásiaMalaysia
5252 MéxicoMexico
3131 Países BaixosNetherlands
6464 Nova ZelândiaNew Zealand
4747 NoruegaNorway
351351 PortugalPortugal
11 Porto RicoPuerto Rico
4040 RoméniaRomania
6565 SingapuraSingapore
2727 África do SulSouth Africa
8282 Coreia do SulSouth Korea
3434 EspanhaSpain
4141 SuíçaSwitzerland
886886 TaiwanTaiwan
4444 Reino UnidoUnited Kingdom
11 Estados Unidos da AméricaUnited States

VozVoice

Consulte o artigo de informação limitativo da taxa para um comportamento adicional importante.See the rate limiting information article for additional important behavior.

Pode ter um número limitado de ações de voz num Grupo de Ação.You may have a limited number of Voice actions in an Action Group.

Nota

Se a interface de utilizador do grupo de ação do portal Azure não permitir que selecione o seu código país/região, então as chamadas de voz não são suportadas para o seu país/região.If the Azure portal action group user interface does not let you select your country/region code, then voice calls are not supported for your country/region. Se o código país/região não estiver disponível, pode votar para que o seu país/região seja adicionado à voz do utilizador.If your country/region code is not available, you can vote to have your country/region added at user voice. Entretanto, um trabalho em torno é fazer com que o seu grupo de ação ligue para um webhook para um fornecedor de chamadas de voz de terceiros com apoio no seu país/região.In the meantime, a work around is to have your action group call a webhook to a third-party voice call provider with support in your country/region.
O único código country suportado hoje no grupo de ação do portal Azure para notificação de voz é +1 (Estados Unidos).Only Country code supported today in Azure portal action group for Voice Notification is +1(United States).

Os preços dos países/regiões apoiados constam da página de preços do Azure Monitor.Pricing for supported countries/regions is listed in the Azure Monitor pricing page.

WebhookWebhook

Nota

A utilização da ação webhook requer que o ponto final do webhook alvo não exija que os detalhes do alerta funcionem com sucesso ou é capaz de analisar as informações de contexto de alerta fornecidas como parte da operação POST.Using the webhook action requires that the target webhook endpoint either doesn't require details of the alert to function successfully or it's capable of parsing the alert context information that's provided as part of the POST operation. Se o ponto final do webhook não conseguir lidar com as informações de contexto de alerta por si só, pode utilizar uma solução como uma ação da Logic App para uma manipulação personalizada das informações de contexto de alerta para corresponder ao formato de dados esperado do webhook.If the webhook endpoint can't handle the alert context information on its own, you can use a solution like a Logic App action for a custom manipulation of the alert context information to match the webhook's expected data format.

Webhooks são processados usando as seguintes regrasWebhooks are processed using the following rules

  • Uma chamada webhook é tentada no máximo 3 vezes.A webhook call is attempted a maximum of 3 times.
  • A chamada será novamente experimentada se não for recebida uma resposta dentro do prazo de tempo ou se um dos seguintes códigos de estado HTTP for devolvido: 408, 429, 503 ou 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.
  • A primeira chamada esperará 10 segundos por uma resposta.The first call will wait 10 seconds for a response.
  • A segunda e terceira tentativas esperarão 30 segundos por uma resposta.The second and third attempts will wait 30 seconds for a response.
  • Após as 3 tentativas de ligar para o webhook, nenhum grupo de ação ligará para o ponto final durante 15 minutos.After the 3 attempts to call the webhook have failed no action group will call the endpoint for 15 minutes.

Consulte os endereços IP do Grupo action para obter intervalos de endereço IP de origem.Please see Action Group IP Addresses for source IP address ranges.

Passos seguintesNext steps