Tutorial: monitorar as alterações de máquinas virtuais usando a Grade de Eventos do Azure e os Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo)

Para monitorar e responder a eventos específicos que ocorrem em recursos do Azure ou recursos externos, você pode usar a Grade de Eventos do Azure e os Aplicativos Lógicos do Azure. Você pode criar um fluxo de trabalho de aplicativo lógico de consumo automatizado com código mínimo usando os Aplicativos Lógicos do Azure. Você pode fazer esses recursos publicarem eventos na Grade de Eventos do Azure. Por sua vez, a Grade de Eventos do Azure envia os eventos aos assinantes com filas, webhooks, ou hubs de eventos como pontos de extremidade. Como assinante, o fluxo de trabalho aguarda esses eventos chegarem na Grade de Eventos do Azure para executar as etapas para processar os eventos.

Veja alguns eventos que os editores podem enviar aos assinantes por meio da Grade de Eventos do Azure:

• Criar, ler, atualizar ou excluir um recurso. Por exemplo, você pode monitorar as alterações que podem incorrer em encargos na sua assinatura do Azure e afetar sua fatura.
• Adicionar ou remover uma pessoa de uma assinatura do Azure.
• Executar uma ação específica no seu aplicativo.
• Exibir uma nova mensagem em uma fila.

Neste tutorial, você criará um recurso de aplicativo lógico de consumo que é executado em Aplicativos Lógicos do Azure de multilocatários. O aplicativo é baseado no modelo de preços de consumo. Usando esse recurso de aplicativo lógico, você cria um fluxo de trabalho que monitora alterações em uma máquina virtual e envia emails sobre essas alterações. Ao criar um fluxo de trabalho com uma assinatura de evento de um recurso do Azure, os eventos são enviados desse recurso por meio da Grade de Eventos do Azure para o fluxo de trabalho.

Neste tutorial, você aprenderá como:

Pré-requisitos

• Uma conta e uma assinatura do Azure. Se você não tem uma assinatura, inscreva-se em uma conta gratuita do Azure.

• Uma conta de email de qualquer serviço de email que funcione com Aplicativos Lógicos do Azure para envio de notificações, como o Office 365 Outlook, o Outlook.com ou o Gmail. Para outros provedores, confira a lista de conectores.

  Este tutorial usa uma conta do Office 365 Outlook. Se você usar uma conta de email diferente, sua interface poderá parecer um pouco diferente.

  Importante

  Se você quiser usar o conector do Gmail, somente as contas comerciais do G Suite poderão usar esse conector sem restrição nos aplicativos lógicos. Se você tiver uma conta de consumidor do Gmail, poderá usar esse conector somente com serviços específicos do Google aprovados ou poderá criar um aplicativo cliente do Google para usar para autenticação com o conector do Gmail. Para obter mais informações, confira Políticas de privacidade e segurança de dados para os conectores do Google nos Aplicativos Lógicos do Azure.

• Uma máquina virtual sozinha em seu próprio grupo de recursos do Azure. Se você precisar de uma máquina virtual, confira Criar uma máquina virtual do Windows no portal do Azure. Para fazer com que a máquina virtual publique eventos, não é necessário fazer mais nada.

• Se você tiver um firewall que limita o tráfego a endereços IP específicos, configure o firewall para permitir o acesso para que os Aplicativos Lógicos do Azure se comuniquem através do firewall. Você precisa permitir o acesso para os endereços IP de entrada e de saída usados pelos Aplicativos Lógicos do Azure na região do Azure em que você cria seu aplicativo lógico.

  Esse exemplo usa conectores gerenciados que exigem que o firewall permita o acesso a todos os endereços IP de saída do conector gerenciado na região do Azure do recurso do aplicativo lógico.

Criar recurso de aplicativo lógico

1. Entre no portal do Azure com sua conta do Azure.

2. Na home page do Azure, selecione Criar um recurso>Integração>Aplicativo Lógico.

   

3. Selecione Consumo>Multilocatário.

4. Em Criar Aplicativo Lógico, forneça informações sobre seu recurso de aplicativo lógico.

   

   Parâmetro	Obrigatório	Valor	Descrição
   Assinatura	Sim	< Nome da assinatura do Azure>	Selecione a mesma assinatura do Azure para todos os serviços neste tutorial.
   Grupo de recursos	Sim	< Azure-resource-group>	O nome do grupo de recursos do Azure para seu aplicativo lógico, que você pode selecionar para todos os serviços neste tutorial.
   Nome do Aplicativo Lógico	Sim	< logic-app-name>	Forneça um nome exclusivo para seu aplicativo lógico.
   Região	Sim	< Região do Azure>	Selecione a mesma região para todos os serviços neste tutorial.

   Observação

   Este tutorial se aplica somente aos aplicativos lógicos de consumo, que seguem uma experiência diferente do usuário. Para obter mais informações, confira Diferenças entre aplicativos lógicos de locatário único padrão versus aplicativos lógicos multilocatário de consumo.

5. Quando terminar, selecione Review + create. Na próxima página, confirme as informações fornecidas e selecione Criar.

Adicionar um gatilho de Grade de Eventos do Azure

Para adicionar a Grade de Eventos do Azure para que você possa monitorar o grupo de recursos para sua máquina virtual, siga estas etapas:

1. No portal do Azure, abra o recurso de aplicativo lógico de Consumo.

2. Na barra lateral do recurso, em Ferramentas de Desenvolvimento, selecione o designer para abrir o fluxo de trabalho.

3. No designer, siga essas etapas gerais para adicionar ao seu fluxo de trabalho o gatilho da Grade de Eventos do Azure chamado Quando ocorre um evento de recurso.

4. No painel Criar conexão, forneça as seguintes informações:

   Parâmetro	Obrigatório	Descrição
   Autenticação	Sim	Selecione o tipo de autenticação a ser exigido para a conexão. Sua seleção determina outros valores de parâmetro que essa conexão requer.

   Por exemplo, com a autenticação OAuth, a lista de IDs de Locatário é exibida e mostra o locatário do Microsoft Entra para sua assinatura do Azure. Confirme se o locatário correto aparece:

   

   Observação

   Se você estiver conectado com uma conta pessoal da Microsoft, como @outlook.com ou @hotmail.com, talvez o gatilho da Grade de Eventos do Azure não apareça corretamente. Como alternativa, selecione Conectar-se à Entidade de Serviço ou autentique-se como membro do Microsoft Entra para sua assinatura do Azure. Por exemplo, user-name@emailoutlook.onmicrosoft.com.

5. Quando terminar, selecione Entrar.

6. Agora, configure seu fluxo de trabalho com uma assinatura para eventos do editor.

   No painel de gatilho, forneça as seguintes informações sobre sua assinatura de evento:

   

   Parâmetro	Obrigatório	Valor	Descrição
   Tipo de recurso	Sim	< event-publisher-Azure-resource-type>	Selecione o tipo de recurso do Azure para o editor de eventos. Confira mais informações em Tipos e provedores de recursos do Azure. Para este tutorial, selecione Microsoft.Resources.ResourceGroups para monitorar grupos de recursos do Azure.
   Assinatura	Sim	< event-publisher-Azure-subscription-name>	Selecione o nome da assinatura do Azure para o editor de eventos. Para este tutorial, selecione o nome da assinatura do Azure de sua máquina virtual.
   Nome do recurso	Sim	< event-publisher-Azure-resource-name>	Selecione o nome do recurso do Azure para o editor de eventos. Essa lista varia de acordo com o tipo de recurso que você selecionou. Para este tutorial, selecione o nome do grupo de recursos do Azure que inclui sua máquina virtual.
   Item do Tipo de Evento	Não	< tipos de evento>	Selecione um ou mais tipos de eventos específicos para filtrar e enviar para a Grade de Eventos do Azure. Por exemplo, você pode, opcionalmente, adicionar estes tipos de evento para detectar quando os recursos são alterados ou excluídos: - Microsoft.Resources.ResourceActionSuccess - Microsoft.Resources.ResourceDeleteSuccess - Microsoft.Resources.ResourceWriteSuccess Para obter mais informações, consulte: - Grupo de recursos do Azure com uma fonte da Grade de Eventos - Compreender a filtragem de eventos - Filtrar eventos para a Grade de Eventos
   Para adicionar parâmetros opcionais, abra a lista Parâmetros avançados e selecione os parâmetros desejados.	Não	{consulte as descrições}	- Filtro de Prefixo: para este tutorial, deixe esse valor vazio. O comportamento padrão corresponde a todos os valores. No entanto, você pode especificar uma cadeia de caracteres de prefixo como filtro, por exemplo, um caminho e um parâmetro para um recurso específico. - Filtro de Sufixo: para este tutorial, deixe esse valor vazio. O comportamento padrão corresponde a todos os valores. No entanto, você pode especificar uma cadeia de caracteres de sufixo como filtro, por exemplo, uma extensão de nome de arquivo, quando quiser tipos específicos de arquivo. - Nome da assinatura: para este tutorial, é possível fornecer um nome exclusivo para a assinatura de evento.

7. Salve seu fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

   Ao salvar seu fluxo de trabalho com um gatilho da Grade de Eventos do Azure, o Azure cria uma assinatura de evento para o seu fluxo de trabalho no recurso selecionado. Quando o recurso publica um evento no serviço da Grade de Eventos do Azure, o serviço envia o evento para o seu fluxo de trabalho. Esse evento dispara e executa o fluxo de trabalho que você define na próxima seção.

Quando você salva o fluxo de trabalho, o recurso do aplicativo lógico fica ativo no portal do Azure e começa a escutar eventos da Grade de Eventos do Azure. No entanto, seu fluxo de trabalho não faz mais nada até que você adicione ações para executar tarefas.

Adicione uma condição

Para executar as ações em seu fluxo de trabalho apenas quando um evento ou operação específica ocorrer, adicione uma condição que verifique esse evento ou operação. Este tutorial verifica a operação Microsoft.Compute/virtualMachines/write. Quando essa condição for verdadeira, outra ação em seu fluxo de trabalho enviará um email que inclui informações sobre a máquina virtual atualizada.

1. No designer, siga estas etapas gerais para adicionar a ação interna denominada Condição ao fluxo de trabalho.

   O designer adiciona uma condição vazia ao fluxo de trabalho, incluindo caminhos de ação a serem seguidos com base em se a condição é verdadeira ou falsa.

   

2. Para renomear a condição, no painel de ações, no título da ação, selecione Condição. Renomeie o título como Se uma máquina virtual em seu grupo de recursos tiver sido alterada.

   

3. Crie uma condição que verifica o evento body para um objeto data em que o parâmetro operationName é igual à operação Microsoft.Compute/virtualMachines/write. Para saber mais, confira Esquema de evento da Grade de Eventos do Azure.

   1. Na primeira linha em E, selecione dentro da caixa esquerda para mostrar as opções de entrada, que são a lista de conteúdo dinâmico (ícone de raio) e o editor de expressão (ícone de função). Selecione o editor de expressão.

      

   2. No editor, verifique se a Função está selecionada. Na caixa do editor, insira a expressão a seguir, que retorna o nome da operação do gatilho e, em seguida, selecione Adicionar:

      triggerBody()?['data']['operationName']

      Por exemplo:

      

   3. Na caixa do meio, mantenha o operador "é igual a" (=).

   4. Na caixa direita, insira a operação que deseja monitorar, que é o seguinte valor para este exemplo:

      Microsoft.Compute/virtualMachines/write

   Agora, sua condição concluída será semelhante a este exemplo:

   

   Se você salvar suas alterações e alternar do modo de exibição do designer para o modo de exibição de código e, em seguida, retornar ao modo de exibição do designer, a expressão na condição será resolvida para o token data.operationName:

   

4. Salve seu fluxo de trabalho.

Enviar notificações por email

Agora, adicione uma ação para que você possa receber um email quando a condição for definida como verdadeira.

1. Na caixa True da condição, selecione +>Adicionar uma ação.

   

2. Na caixa de pesquisa do painel Adicionar uma ação, insira enviar um email. Com base no provedor de email, localize o tipo de conector correspondente. Selecione a ação "enviar email" para o conector. Por exemplo:

   • Para uma conta corporativa ou de estudante do Azure, selecione a ação do conector do Outlook do Office 365 chamada Enviar um email (V2).
   • Para contas pessoais da Microsoft, selecione a ação do conector do Outlook.com chamada Enviar um email (V2).
   • Para contas do Gmail, selecione a ação do conector do Gmail chamada Enviar email (V2).

   Este tutorial continua com a ação do conector do Outlook do Office 365. Se você usar um provedor diferente, as etapas permanecerão as mesmas, mas a interface do usuário poderá parecer ligeiramente diferente.

3. Se você ainda não tiver uma conexão com seu provedor de email, entre em sua conta de email quando for solicitado a autenticar sua identidade.

4. Renomeie a ação de enviar email para o seguinte título: Enviar email quando a máquina virtual for atualizada.

5. No painel de ações, forneça as seguintes informações sobre o email a ser enviado:

   Dica

   Para selecionar a saída de operações anteriores (gatilho e ações) em seu fluxo de trabalho, siga estas etapas:

   1. Selecione dentro de uma caixa de texto para mostrar as opções de entrada, que são a lista de conteúdo dinâmico (ícone de raio) e o editor de expressão (ícone de função). Selecione a lista de conteúdo dinâmico.
   2. Localize e selecione as saídas que você deseja incluir. Para mais resultados, selecione Ver mais para cada seção na lista.

   Parâmetro	Obrigatório	Valor	Descrição
   Para	Sim	< bcipient@domain>	Insira o endereço de email do destinatário. Para fins de teste, você pode usar seu próprio endereço de email.
   Assunto	Sim	Recurso atualizado:[Assunto]	Insira o conteúdo do assunto do email. Para este tutorial, insira o texto especificado e selecione o campo Assunto do evento. Aqui, o assunto do email inclui o nome do recurso atualizado (máquina virtual).
   Corpo	Sim	Recurso:[Tópico] Tipo de evento:[Tipo de Evento] ID do Evento:[ID] Hora:[Hora do Evento]	Insira o conteúdo do corpo do email. Para este tutorial, insira o texto especificado e selecione as saídas Tópico, Tipo de Evento, ID e Hora do Evento do evento para que seu email inclua o recurso que disparou o evento, o tipo de evento, o carimbo de data/hora do evento e a ID do evento para a atualização. Para este tutorial, o recurso é o grupo de recursos do Azure selecionado no gatilho. Para adicionar linhas em branco ao conteúdo, pressione Shift + Enter.

   Observação

   Se você selecionar um campo que representa uma matriz, o designer adiciona automaticamente um loop para cada em torno da ação que faz referência à matriz. Dessa forma, seu fluxo de trabalho executará essa ação em cada item de matriz.

   A ação do email pode ser semelha a este exemplo:

   

   Seu fluxo de trabalho concluído agora se parece com o seguinte exemplo:

   

6. Salve seu fluxo de trabalho.

   Suas atualizações de fluxo de trabalho agora estão ativas. O gatilho de fluxo de trabalho aguarda alterações em sua máquina virtual antes de fazer qualquer coisa. Para testar o seu fluxo de trabalho agora, siga para a próxima seção.

Testar seu fluxo de trabalho

1. Para verificar se o seu fluxo de trabalho está obtendo os eventos especificados, atualize sua máquina virtual.

   Por exemplo, você pode redimensionar sua máquina virtual.

   Você receberá um email em alguns instantes. Por exemplo:

2. Para examinar o histórico de execuções ou o histórico de gatilhos do fluxo de trabalho, na barra lateral do recurso, selecione Visão Geral.

3. Na página de Visão Geral, selecione Histórico de execuções. Para exibir mais detalhes sobre uma execução de fluxo de trabalho, selecione essa execução.

   

4. Para exibir as entradas e saídas de cada operação, selecione essa operação.

   Essas informações podem ajudar você a diagnosticar e depurar problemas em seu fluxo de trabalho.

   

Parabéns! Você criou e executou um fluxo de trabalho que monitora eventos de recursos da Grade de Eventos do Azure e envia emails quando esses eventos ocorrem. Você também aprendeu como é fácil criar fluxos de trabalho que automatizam processos e integram sistemas e serviços de nuvem.

Você pode monitorar outras alterações de configuração com grades de eventos e fluxos de trabalho, por exemplo:

• Uma máquina virtual obtém permissões de RBAC (controle de acesso baseado em função) do Azure.
• As alterações são feitas em um grupo de segurança de rede (NSG) em um adaptador de rede (NIC).
• Discos para uma máquina virtual são adicionados ou removidos.
• Um endereço IP público é atribuído a uma máquina virtual NIC.

Limpar os recursos

Este tutorial usa recursos e executa ações que geram encargos na sua assinatura do Azure. Quando terminar o tutorial e o teste, desabilite ou exclua todos os recursos que não devem gerar encargos.

• Para interromper a execução do seu fluxo de trabalho sem excluir o seu trabalho, desabilite o aplicativo. Na barra lateral do aplicativo lógico, selecione Visão Geral. Na barra de ferramentas, selecione Desabilitar.

  

  Dica

  Se você não vir a barra lateral do aplicativo lógico, tente voltar para a página inicial do portal do Azure e reabra o recurso do aplicativo lógico.

• Para excluir permanentemente seu aplicativo lógico, no menu da barra lateral, selecione Visão Geral. Na barra de ferramentas, selecione Excluir. Confirme que você deseja excluir o aplicativo lógico e selecione Excluir.

Conteúdo relacionado

• Encaminhar eventos personalizados para o ponto de extremidade da Web com a CLI do Azure e com a Grade de Eventos

Para obter exemplos sobre como publicar eventos e consumir eventos com a Grade de Eventos do Azure usando linguagens de programação diferentes, confira os seguintes exemplos:

• Exemplos da Grade de Eventos do Azure para .NET
• Exemplos da Grade de Eventos do Azure para Java
• Exemplos da Grade de Eventos do Azure para Python
• Exemplos da Grade de Eventos do Azure para JavaScript
• Exemplos da Grade de Eventos do Azure para TypeScript