Personalizar 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 criar e personalizar fluxos de trabalho para integração. Use Aplicativos lógicos para personalizar suas notificações de alerta. Pode:

• Personalize o e-mail de alertas usando seu próprio assunto de e-mail e formato de corpo.
• Personalize os metadados de alerta procurando tags para recursos afetados ou buscando um resultado de pesquisa de consulta de log. Para obter informações sobre como acessar as linhas de resultados de pesquisa que contêm dados de alertas, consulte:
  • Formato de resposta da API do Azure Monitor Log Analytics
  • Resposta HTTP de consulta/gerenciamento
• Integre com serviços externos usando 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 detalhes do alerta.

Criar uma aplicação lógica

1. No portal do Azure, crie um novo aplicativo lógico. Na barra de pesquisa na parte superior da página, digite Logic App.

2. Na página Aplicativo Lógico, selecione Adicionar.

3. Selecione o grupo Assinatura e Recursos para seu aplicativo lógico.

4. Defina o nome do aplicativo lógico. Em Tipo de plano, selecione Consumo.

5. Selecione Rever + criar>Criar.

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

   

7. Na página Designer de Aplicativos Lógicos , selecione Quando uma solicitação HTTP é recebida.

   

8. 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": {}
                   }
               }
           }
       }
   }
   

   

9. (Opcional). Você pode personalizar a notificação de alerta extraindo informações sobre o recurso afetado no qual o alerta foi acionado, por exemplo, as tags do recurso. Em seguida, você pode incluir essas tags de recursos na carga útil do alerta e usar as informações em suas expressões lógicas para enviar as notificações. Para dar este passo, iremos:

   • Crie uma variável para as IDs de recursos afetadas.
   • Divida o ID do recurso em uma matriz para que possamos usar seus vários elementos (por exemplo, assinatura e grupo de recursos).
   • Use o conector do Azure Resource Manager para ler os metadados do recurso.
   • Buscar as tags do recurso, que podem ser usadas nas etapas subsequentes do aplicativo lógico.

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

   2. No campo Pesquisar, procure 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 Adicionar conteúdo dinâmico. Selecione a guia Expressão e insira a cadeia de caracteres split(triggerBody()?['data']?['essentials']?['alertTargetIDs'][0], '/').

      

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

   7. No campo Pesquisar, procure e selecione Azure Resource Manager>Ler um recurso.

   8. Preencha os campos da ação Ler um recurso com os valores de matriz da AffectedResource variável. Em cada um dos campos, selecione o campo e role para baixo até Inserir um valor personalizado. Selecione Adicionar conteúdo dinâmico e, em seguida, selecione a guia Expressão . Insira as cadeias de caracteres desta tabela:

      Campo	Valor da cadeia de caracteres
      Subscrição	variables('AffectedResource')[2]
      Grupo de Recursos	variables('AffectedResource')[4]
      Fornecedor de Recursos	variables('AffectedResource')[6]
      ID de recurso curto	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 seu tipo de recurso, selecione o link da visualização JSON no canto superior direito da página de visão geral do recurso. A página JSON de recursos é exibida com a versão ResourceID e API na parte superior da página.

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

10. Envie um e-mail ou publique uma mensagem do Teams.

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

    

Enviar um e-mail

1. No campo de pesquisa, procure o Outlook.

2. Selecione Office 365 Outlook.

   

3. Selecione Enviar um e-mail (V2) na lista de ações.

4. Entre no Office 365 quando for solicitado a criar uma conexão.

5. Crie o Corpo do e-mail inserindo texto estático e incluindo conteúdo retirado da carga útil do alerta escolhendo campos na lista Conteúdo dinâmico. Por exemplo:

   • Um alerta tem condição de monitoramento: Selecione monitorCondition na lista Conteúdo dinâmico .
   • Data de disparo: Selecione firedDateTime na lista Conteúdo dinâmico .
   • Recursos afetados: selecione alertTargetIDs na lista Conteúdo dinâmico .

6. No campo Assunto, crie o texto do assunto inserindo texto estático e incluindo conteúdo retirado da carga útil do alerta escolhendo campos na lista Conteúdo dinâmico. Por exemplo:

   • Alerta: Selecione alertRule na lista Conteúdo dinâmico .
   • com gravidade: selecione a severidade na lista Conteúdo dinâmico.
   • has condition: Selecione monitorCondition na lista Conteúdo dinâmico .

7. Digite o endereço de e-mail para enviar o alerta para o campo Para .

8. Selecione Guardar.

   

Você criou um aplicativo lógico que envia um e-mail para o endereço especificado, com detalhes do alerta que o disparou.

A próxima etapa é criar um grupo de ação para acionar seu aplicativo lógico.

Publicar uma mensagem do Teams

1. No campo de pesquisa, procure Microsoft Teams.

2. Selecione Microsoft Teams.

   

3. Selecione Publicar mensagem em um chat ou canal na lista de ações.

4. Inicie sessão no Teams quando lhe for pedido para criar uma ligação.

5. Selecione Usuário na lista suspensa Publicar como .

6. Selecione Bate-papo em grupo na lista suspensa Publicar em .

7. Selecione seu grupo na lista suspensa Bate-papo em grupo.

8. Crie o texto da mensagem no campo Mensagem inserindo texto estático e incluindo conteúdo retirado da carga útil do alerta escolhendo campos na lista Conteúdo dinâmico . Por exemplo:

   1. Alerta: Selecione alertRule na lista Conteúdo dinâmico .
   2. com gravidade: selecione a severidade na lista Conteúdo dinâmico.
   3. foi disparado para: Selecione firedDateTime na lista Conteúdo dinâmico.
   4. Adicione mais campos de acordo com as suas necessidades.

9. Selecione Guardar.

   

Você criou um aplicativo lógico que envia uma mensagem do Teams para o grupo especificado, com detalhes do alerta que o disparou.

A próxima etapa é criar um grupo de ação para acionar seu aplicativo lógico.

Criar um grupo de ações

Para acionar seu aplicativo lógico, crie um grupo de ações. Em seguida, crie um alerta que use esse grupo de ações.

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

2. Selecione Grupos>de ação Criar.

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

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

5. Selecione o separador 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 na lista suspensa.

8. Defina Ativar esquema de alerta comum como Sim. Se você selecionar Não, o tipo de alerta determinará qual esquema de alerta será usado. Para obter mais informações sobre esquemas de alerta, consulte Esquemas de alerta específicos do contexto.

9. Selecione OK.

10. Insira um nome no campo Nome .

11. Selecione Rever + criar>Criar.

    

Testar o seu grupo de ação

1. Selecione seu grupo de ações.

2. Na seção Aplicativo Lógico, selecione Grupo de ações de teste (visualização).

   

3. Selecione um tipo de alerta de exemplo na lista suspensa Selecionar tipo de amostra.

4. Selecione Teste.

   

   O seguinte e-mail é enviado para a conta especificada:

   

Criar uma regra usando seu grupo de ações

1. Crie uma regra para um dos seus recursos.

2. Na guia Ações da regra, escolha Selecionar grupos de ações.

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

4. Escolha Selecionar.

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

   

Próximos passos

• Saiba mais sobre grupos de ação
• Saiba mais sobre o esquema de alerta comum