Tutorial: Responder aos eventos do Barramento de Serviço do Azure recebidos por meio da Grade de Eventos do Azure usando o Azure Functions

Neste tutorial, você aprenderá a responder a eventos do Barramento de Serviço do Azure que são recebidos por meio da Grade de Eventos do Azure usando o Azure Functions e os Aplicativos Lógicos do Azure.

Neste tutorial, você aprenderá como:

Pré-requisitos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Criar um namespace do Barramento de Serviço

Siga as instruções deste tutorial: Início Rápido: Usar o portal do Azure para criar um tópico do Barramento de Serviço e assinaturas para o tópico para executar as seguintes tarefas:

• Criar um namespace premium do Barramento de Serviço.
• Obter a cadeia de conexão.
• Criar um tópico de Barramento de Serviço.
• Crie uma assinatura para o tópico. Você precisa de apenas uma assinatura neste tutorial, portanto, não há necessidade de criar assinaturas S2 e S3.

Enviar mensagens para o tópico do Barramento de Serviço

Nesta etapa, você usa um aplicativo de exemplo para enviar mensagens para o tópico do Barramento de Serviço criado na etapa anterior.

1. Clone o repositório GitHub azure-service-bus ou baixe o arquivo zip e extraia os arquivos dele.

2. No Visual Studio, acesse a pasta \samples\DotNet\Azure.Messaging.ServiceBus\ServiceBusEventGridIntegrationV2 e abra o arquivo SBEventGridIntegration.sln.

3. Na janela Gerenciador de Soluções, expanda o projeto MessageSender e selecione Program.cs.

4. Substitua <SERVICE BUS NAMESPACE - CONNECTION STRING> pela cadeia de conexão do namespace do Barramento de Serviço e <TOPIC NAME> pelo nome do tópico.

   const string ServiceBusConnectionString = "<SERVICE BUS NAMESPACE - CONNECTION STRING>";
   const string TopicName = "<TOPIC NAME>";
   

5. Crie e execute o programa para enviar cinco mensagens de teste (const int numberOfMessages = 5;) para o tópico do Barramento de Serviço.

   

Pré-requisitos adicionais

Instale o Visual Studio 2022 e inclua a carga de trabalho de Desenvolvimento do Azure. Essa carga de trabalho inclui o Azure Function Tools, que você precisa para criar, compilar e implantar projetos do Azure Functions no Visual Studio.

Implantar o aplicativo de funções

1. Abra o arquivo ReceiveMessagesOnEvent.cs por meio do projeto FunctionApp1 da solução SBEventGridIntegration.sln.

2. Substitua <SERVICE BUS NAMESPACE - CONNECTION STRING> pela cadeia de conexão para o namespace do Barramento de Serviço. Ele deverá ser o mesmo que você usou no arquivo Program.cs do projeto MessageSender na mesma solução.

3. Clique com o botão direito do mouse em FunctionApp1 e selecione Publicar.

4. Na página Publicar, selecione Iniciar. Estas etapas podem ser diferentes do que você vê, mas o processo de publicação deve ser semelhante.

5. No assistente de Publicação, na página Destino, selecione Azure em Destino.

6. Na página Destino específico, selecione Aplicativo de Funções do Azure (Windows) .

7. Na página da Instância do Functions, selecione Criar novo.

   

8. Na página Aplicativo de Funções (Windows) , siga estas etapas:

   1. insira um nome para o aplicativo de funções.
   2. Selecione uma assinatura do Azure.
   3. Selecione um grupo de recursos existente ou crie um grupo de recursos. Para este tutorial, selecione o grupo de recursos que tem o namespace do Barramento de Serviço.
   4. Selecione um tipo de plano para o Serviço de Aplicativo.
   5. Selecione um local. Selecione a mesma localização do namespace do Barramento de Serviço.
   6. Escolha um Armazenamento do Azure existente ou selecione Novo para criar uma conta de armazenamento a ser usada pelo aplicativo de funções.
   7. Para Application Insights, selecione uma instância existente do Application Insights para associar à função do Azure ou crie uma.
   8. Selecione Criar para criar o aplicativo de funções.

9. De volta à página Instância do Functions do assistente de Publicação, selecione Concluir.

10. Na página Publicar do Visual Studio, selecione Publicar para publicar o aplicativo do Functions no Azure.

11. Na Janela de Saída, confira as mensagens de build e publicação e confirme se os dois foram bem-sucedidos.

    Se a publicação falhar com um problema de autenticação, verifique se a opção de Publicação de Autenticação Básica do SCM está habilitada para o aplicativo do Azure Functions.

    

12. Agora, na página Publicar, na seção Hospedagem, selecione ... (reticências) e selecione Abrir no portal do Azure.

    

13. No portal do Azure, na página do Aplicativo de funções, selecione EventGridTriggerFunction na lista. Recomendamos que você use o gatilho da Grade de Eventos com o Azure Functions, pois ele oferece alguns benefícios em relação ao uso do gatilho HTTP. Para obter detalhes, confira Função do Azure como um manipulador de eventos para os eventos da Grade de Eventos.

    

14. Na página da Função para o EventGridTriggerFunction, vá para a guia Invocações.

    

    Mantenha essa página aberta em uma guia do navegador da Web. Você a atualizará para ver as invocações dessa função posteriormente.

Conecte a função e o namespace do Barramento de Serviço através da Grade de Eventos

Nesta seção, você une a função e o namespace do Barramento de Serviço usando o portal do Azure.

Para criar uma assinatura da Grade de Eventos do Azure, siga as etapas a seguir:

1. No portal do Azure, vá para seu namespace do Barramento de Serviço e, em seguida, no painel esquerdo, selecione Eventos. A janela do namespace é aberta, com duas assinaturas da Grade de Eventos exibidas no painel direito.

   

2. Selecione + Assinatura de Evento na barra de ferramentas.

3. Na página Criar Assinatura de Eventos, faça o seguinte:

   1. Insira um nome para a assinatura.

   2. Insira um nome para o tópico do sistema. Os tópicos do sistema são tópicos criados para recursos do Azure, como a conta do Armazenamento do Azure e o Barramento de Serviço do Azure. Para saber mais sobre os tópicos do sistema, confira Visão geral dos tópicos do sistema.

   3. Selecione Função do Azure para Tipo de Ponto de Extremidade e escolha Configurar um ponto de extremidade.

      

   4. Na página Selecionar Função do Azure, escolha a assinatura, o grupo de recursos, o aplicativo de funções, o slot e a função e selecione Confirmar seleção.

      

   5. Na página Criar Assinatura de Evento, alterne para a guia Filtros e execute as seguintes tarefas:

      1. Selecione Habilitar filtragem por assunto

      2. Insira o nome da assinatura ao tópico do Barramento de Serviço criado anteriormente. Na captura de tela a seguir, o nome da assinatura é mysub.

      3. Selecione o botão Criar.

         

4. Alterne para a guia Assinaturas de Evento da página Eventos e confirme se você vê a assinatura de evento na lista.

   

Monitorar o aplicativo de funções

As mensagens que você enviou para o tópico do Barramento de Serviço anteriormente são encaminhadas para a assinatura (S1). A Grade de Eventos encaminha as mensagens na assinatura para a função do Azure. Nesta etapa do tutorial, você confirmará se a função foi invocada e verá as mensagens informativas registradas em log.

1. Na página do aplicativo de funções do Azure, alterne para a guia Invocações caso ela ainda não esteja ativa. Você deverá ver uma entrada para cada mensagem postada no tópico do Barramento de Serviço. Se você não as vir, atualize a página depois de aguardar alguns minutos.

   

2. Selecione a invocação na lista para ver os detalhes.

   

   Você também pode usar a guia Logs para ver as informações de registro em log conforme as mensagens são enviadas. Pode haver algum atraso, então aguarde alguns minutos para ver as mensagens registradas.

   

Solucionar problemas

Se você não vir nenhuma invocação da função depois de aguardar e atualizar a página por algum tempo, siga estas etapas:

1. Confirme se as mensagens chegaram no tópico do Barramento de Serviço. Confira o contador mensagens de entrada na página Tópico do Barramento de Serviço. Nesse caso, executei o aplicativo MessageSender duas vezes e, portanto, vejo dez mensagens (cinco mensagens para cada execução).

   

2. Confirme se não há nenhuma mensagem ativa na assinatura do Barramento de Serviço. Se você não vir nenhum evento nessa página, verifique se a página Assinatura do Barramento de Serviço não mostra nenhuma Contagem de mensagens ativas. Se o número desse contador for maior que zero, as mensagens da assinatura não serão encaminhadas para a função de manipulador (manipulador de assinaturas de evento) por algum motivo. Verifique se você configurou a assinatura de evento corretamente.

   

3. Você também verá os eventos entregues na página Eventos do namespace do Barramento de Serviço.

   

4. Você também verá que os eventos são entregues na página Assinatura de Evento. Acesse essa página selecionando a assinatura de evento na página Eventos.

   

Conteúdo relacionado

• Saiba mais sobre a Grade de Eventos do Azure.
• Saiba mais sobre o Azure Functions.
• Saiba mais sobre o Barramento de Serviço do Azure.