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 o próprio assunto do email e o formato do corpo.
- Personalize os metadados de alerta pesquisando as marcas dos recursos afetados ou buscando um resultado de pesquisa de consulta de log. Para obter informações sobre como acessar as linhas de resultado da pesquisa que contêm dados de alertas, veja:
- 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
No portal do Azure, crie um novo aplicativo lógico. Na barra de Pesquisa na parte superior da página, insira Aplicativo Lógico.
Na página Aplicativo Lógico, selecione Adicionar.
Selecione a Assinatura e o Grupo de recursos do aplicativo lógico.
Defina o nome do Aplicativo Lógico. Para Tipo de plano, selecione Consumo.
Selecione Examinar + criar>Criar.
Selecione Ir para o recurso depois que a implantação for concluída.
Na página Designer de Aplicativos Lógicos, selecione Quando uma solicitação HTTP for recebida.
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": {} } } } } }
(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).
- Usar o conectar do Azure Resource Manager para ler os metadados do recurso.
- Buscar as marcas do recurso, que podem ser usadas nas próximas etapas do aplicativo lógico.
Selecione +>Adicionar uma ação para inserir uma nova etapa.
No campo Pesquisar, pesquise e selecione Inicializar variável.
No campo Nome, insira o nome da variável, como AffectedResource.
No campo Tipo, selecione Matriz.
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], '/').
Selecione +>Adicionar uma ação para inserir outra etapa.
No campo Pesquisar, pesquise e selecione Azure Resource Manager>Ler um recurso.
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 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 Subscription 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 Exibição JSON no canto 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 as marcas do recurso afetado. Você pode usar essas marcas ao configurar suas notificações, conforme descrito nas etapas a seguir.
Envie um email ou publique uma mensagem do Teams.
Selecione +>Adicionar uma ação para inserir uma nova etapa.
No campo de pesquisa, pesquise Outlook.
Selecione Office 365 Outlook.
Selecione Enviar um email (V2) na lista de ações.
Entre no Office 365 quando for solicitado a criar uma conexão.
Crie o Corpo do email inserindo o texto estático e incluindo o conteúdo obtido da carga do alerta escolhendo os 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 disparada: selecione firedDateTime na lista Conteúdo dinâmico.
- Recursos afetados: selecione alertTargetIDs na lista Conteúdo dinâmico.
No campo Assunto, crie o texto do assunto inserindo o texto estático e incluindo o conteúdo obtido da carga de alerta escolhendo os campos na lista Conteúdo dinâmico. Por exemplo:
- Alerta: selecione alertRule na lista Conteúdo dinâmico.
- com severidade: selecione severidade na lista Conteúdo dinâmico.
- tem condição: selecione monitorCondition na lista Conteúdo dinâmico.
Insira o endereço de email para enviar o alerta no campo Para.
Clique em Salvar.
Você criou um aplicativo lógico que envia um email ao endereço especificado, com os detalhes do alerta que o disparou.
A próxima etapa é criar um grupo de ações para disparar o aplicativo lógico.
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.
Vá para a página Azure Monitor e selecione Alertas no painel à esquerda.
Selecione Grupo de ações>Criar.
Selecione valores para Assinatura, Grupo de recursos e Região.
Insira um nome para o Nome do grupo de ações e Nome de exibição.
Selecione a guia Ações.
Na guia Ações em Tipo de ação, selecione Aplicativo Lógico.
Na seção Aplicativo Lógico, selecione o aplicativo lógico do menu suspenso.
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.
Selecione OK.
Insira um nome no campo Nome.
Selecione Examinar + criar>Criar.
Testar o grupo de ações
Selecione o grupo de ações.
Na seção Aplicativo Lógico, selecione Testar grupo de ações (versão prévia).
Selecione um tipo de alerta de exemplo no menu suspenso Selecionar tipo de exemplo.
Selecione Testar.
O seguinte email é enviado para a conta especificada:
Criar uma regra usando o grupo de ações
Crie uma regra para um dos seus recursos.
Na guia Ações da regra, escolha Selecionar grupos de ações.
Selecione o grupo de ações na lista.
Escolha Selecionar.
Conclua a criação da regra.
