Personalizar as notificações de alerta usando Aplicativos Lógicos

Este artigo mostra como criar um aplicativo lógico e integrá-lo a um alerta do Azure Monitor. Você pode usar os Aplicativos Lógicos do Azure para compilar e personalizar fluxo de trabalho para integração. Use os Aplicativos Lógicos para personalizar as notificações de alerta. Você pode:

• Personalize o email de alertas usando seu próprio assunto e formato de corpo de email.

• Personalize os metadados de alerta pesquisando as tags dos recursos afetados ou obtendo um resultado de pesquisa através de uma consulta de log. Para obter informações sobre como acessar as linhas de resultado da pesquisa que contêm dados de alertas, consulte:

  • Formato de resposta da API do Log Analytics do Azure Monitor
  • Resposta HTTP da consulta/gerenciamento

• Integre-se a serviços externos usando os conectores existentes como Outlook, Microsoft Teams, Slack e PagerDuty. Você também pode configurar o aplicativo lógico para seus próprios serviços.

Este exemplo cria um aplicativo lógico que usa o esquema de alertas comuns para enviar os detalhes do alerta.

Criar um aplicativo lógico

1. No portal do Azure, crie um novo aplicativo lógico. Na barra de pesquisa na parte superior da página, digite Aplicativos lógicos e selecione-o no menu suspenso.

2. Na página Aplicativos Lógicos, selecione Adicionar.

3. Em Consumo, selecione Multi-tenant.

4. Na próxima página, selecione a Assinatura e o grupo de recursos para seu aplicativo lógico.

5. Defina um nome de Aplicativo Lógico e escolha uma Região.

6. Selecione Examinar + criar>Criar.

   

7. Selecione Ir para o recurso após a conclusão da implantação.

Configurar um gatilho

1. Na página do aplicativo Logic, selecione Editar na barra de ações superior.

2. Selecione Adicionar um gatilho, pesquise quando uma solicitação HTTP é recebida e selecione-a nos resultados da pesquisa.

   

3. Cole o esquema de alerta comum no campo Esquema JSON do Corpo da Solicitação do seguinte JSON:

    {
       "type": "object",
       "properties": {
           "schemaId": {
               "type": "string"
           },
           "data": {
               "type": "object",
               "properties": {
                   "essentials": {
                       "type": "object",
                       "properties": {
                           "alertId": {
                               "type": "string"
                           },
                           "alertRule": {
                               "type": "string"
                           },
                           "severity": {
                               "type": "string"
                           },
                           "signalType": {
                               "type": "string"
                           },
                           "monitorCondition": {
                               "type": "string"
                           },
                           "monitoringService": {
                               "type": "string"
                           },
                           "alertTargetIDs": {
                               "type": "array",
                               "items": {
                                   "type": "string"
                               }
                           },
                           "originAlertId": {
                               "type": "string"
                           },
                           "firedDateTime": {
                               "type": "string"
                           },
                           "resolvedDateTime": {
                               "type": "string"
                           },
                           "description": {
                               "type": "string"
                           },
                           "essentialsVersion": {
                               "type": "string"
                           },
                           "alertContextVersion": {
                               "type": "string"
                           }
                       }
                   },
                   "alertContext": {
                       "type": "object",
                       "properties": {}
                   }
               }
           }
       }
   }
   

   

4. (Opcional). Você pode personalizar a notificação de alerta extraindo informações sobre o recurso afetado que disparou o alerta, por exemplo, as marcas do recurso. Em seguida, você pode incluir essas marcas de recursos no conteúdo do alerta e usar as informações em suas expressões lógicas para enviar as notificações. Para realizar esta etapa, iremos:

   • Crie uma variável para as IDs de recurso afetadas.
   • Dividir a ID do recurso em uma matriz para que possamos usar todos os seus elementos (por exemplo, assinatura e grupo de recursos).
   • Use o conector do Azure Resource Manager para ler os metadados do recurso.
   • Obter as tags do recurso, que podem ser usadas nas próximas etapas do aplicativo de lógica.

   1. Selecione +>Adicionar uma ação para inserir uma nova etapa.

   2. No campo Pesquisar, pesquise e selecione Inicializar variável.

   3. No campo Nome, insira o nome da variável, como AffectedResource.

   4. No campo Tipo, selecione Matriz.

   5. No campo Valor, selecione fx para abrir a janela de pop-up de função. Insira a cadeia de caracteres split(triggerBody()?['data']?['essentials']?['alertTargetIDs'][0], '/') no campo vazio na parte superior e selecione Adicionar.

      

   6. Selecione +>Adicionar uma ação para inserir outra etapa.

   7. No campo Pesquisar , pesquise e selecione o Azure Resource Manager>Para ver mais>, leia um recurso.

   8. Selecione um método de Autenticação e entre.

   9. Preencha os campos da ação Ler um recurso com os valores da matriz da variável AffectedResource. Em cada um dos campos, selecione o campo e role para baixo até a opção Inserir um valor personalizado. Selecione fx para abrir a janela pop-up Função. Insira a cadeia de caracteres correspondente desta tabela no campo vazio na parte superior e selecione Adicionar.

      Campo	Valor da cadeia de caracteres
      Assinatura	variables('AffectedResource')[2]
      Grupo de recursos	variables('AffectedResource')[4]
      Provedor de recursos	variables('AffectedResource')[6]
      ID de recurso curta	concat(variables('AffectedResource')[7], '/', variables('AffectedResource')[8])
      Versão da API do cliente	Versão da API do tipo de recurso

      Para localizar a versão da API do tipo de recurso, selecione o link de exibição JSON no lado superior direito da página de visão geral do recurso.

      A página JSON do Recurso é exibida com ResourceID e a versão da API na parte superior da página.

   O conteúdo dinâmico agora inclui marcas do recurso afetado. Você pode usar essas marcas ao configurar suas notificações, conforme descrito nas etapas a seguir.

Configurar uma ação

Selecione +>Adicionar uma ação para inserir uma nova etapa.

Criar um grupo de ações

Para disparar o aplicativo lógico, crie um grupo de ações. Em seguida, crie um alerta que usa esse grupo de ações.

1. Vá para a página Azure Monitor e selecione Alertas no painel à esquerda.

2. Selecione Grupo de ações>Criar.

3. Selecione valores para Assinatura, Grupo de recursos e Região.

4. Insira um nome para o Nome do grupo de ações e Nome de exibição.

5. Selecione a guia Ações.

   

6. Na guia Ações em Tipo de ação, selecione Aplicativo Lógico.

7. Na seção Aplicativo lógico, selecione seu aplicativo lógico no menu suspenso.

8. DefinaHabilitar esquema de alerta comum como Sim. Se você selecionar Não, o tipo de alerta determina qual esquema de alerta será usado. Para obter mais informações sobre esquemas de alerta, veja Esquemas de alerta específicos ao contexto.

9. Selecione OK.

10. Insira um nome no campo Nome.

11. Selecione Examinar + criar>Criar.

    

Testar seu grupo de ações

1. Vá para a página Azure Monitor e selecione Alertas no painel à esquerda.

2. Vá para grupos de ações e selecione seu aplicativo lógico.

3. Selecione Testar na barra de ações superior.

4. Selecione um tipo de alerta de amostra no menu suspenso Selecionar tipo de amostra.

5. Selecione Testar.

   

   O seguinte email é enviado para a conta especificada:

   

Crie uma regra usando seu grupo de ações

1. Crie uma regra de alerta para um de seus recursos.

2. Na guia Ações de sua regra, escolha Usar grupos de ações.

3. Selecione o grupo de ações na lista.

4. Escolha Selecionar.

5. Conclua a criação da sua regra.

   

Próximas etapas

• Saiba mais sobre grupos de ações.
• Saiba mais sobre o esquema de alerta comum.