Tutorial: Respond to Azure Service Bus events received via Azure Event Grid by using Azure Logic Apps

Article
12/09/2022
5 minutes to read

In this tutorial, you learn how to respond to Azure Service Bus events that are received via Azure Event Grid by using Azure Logic Apps.

Prerequisites

If you don't have an Azure subscription, create a free account before you begin.

Create a Service Bus namespace

Follow instructions in this tutorial: Quickstart: Use the Azure portal to create a Service Bus topic and subscriptions to the topic to do the following tasks:

Create a premium Service Bus namespace.
Get the connection string.
Create a Service Bus topic.
Create a subscription to the topic. You need only one subscription in this tutorial, so no need to create subscriptions S2 and S3.

Send messages to the Service Bus topic

In this step, you use a sample application to send messages to the Service Bus topic you created in the previous step.

Clone the GitHub azure-service-bus repository or download the zip file and extract files from it.
In Visual Studio, go to the \samples\DotNet\Azure.Messaging.ServiceBus\ServiceBusEventGridIntegrationV2 folder, and then open the SBEventGridIntegration.sln file.
In the Solution Explorer window, expand the MessageSender project, and select Program.cs.
Replace <SERVICE BUS NAMESPACE - CONNECTION STRING> with the connection string to your Service Bus namespace and <TOPIC NAME> with the name of the topic.
```
const string ServiceBusConnectionString = "<SERVICE BUS NAMESPACE - CONNECTION STRING>";
const string TopicName = "<TOPIC NAME>";
```
Build and run the program to send 5 test messages (const int numberOfMessages = 5;) to the Service Bus topic.

Receive messages by using Logic Apps

In this step, you create an Azure logic app that receives Service Bus events via Azure Event Grid.

Create a logic app in the Azure portal.
1. Select + Create a resource, select Integration, and then select Logic App.
2. Select your Azure subscription.
3. Select Use existing for the Resource group, and select the resource group that you used for other resources (like Azure function, Service Bus namespace) that you created earlier.
4. For Type, select Consumption.
5. Enter a name for the logic app.
6. Select the Region for the logic app.
7. Select Review + Create.
8. On the Review + Create page, select Create to create the logic app.
9. On the Deployment complete page, select Go to resource.
On the Logic Apps Designer page, select Blank Logic App under Templates.

Add a step receive messages from Service Bus via Event Grid

On the designer, do the following steps:
1. Search for Event Grid.
2. Select When a resource event occurs - Azure Event Grid.
Select Sign in, enter your Azure credentials, and select Allow Access.
On the When a resource event occurs page, do the following steps:
1. Select your Azure subscription.
2. For Resource Type, select Microsoft.ServiceBus.Namespaces.
3. For Resource Name, select your Service Bus namespace.
4. Select Add new parameter, select Suffix Filter, and then move the focus outside drop-down list.
5. For Suffix Filter, enter the name of your Service Bus topic subscription.
Select + New Step in the designer, and do the following steps:
1. Search for Service Bus.
2. Select Service Bus in the list.
3. Select for Get messages in the Actions list.
4. Select Get messages from a topic subscription (peek-lock).
5. Follow these steps:
  1. Enter a name for the connection. For example: Get messages from the topic subscription.
  2. Confirm that Authentication Type is set to Access Key.
  3. For Connection String, copy and paste the connection string to the Service Bus namespace that you saved earlier.
  4. Select Create.
6. Select your topic and subscription.

Add a step to process and complete received messages

In this step, you'll add steps to send the received message in an email and then complete the message. In a real-world scenario, you'll process a message in the logic app before completing the message.

Add a foreach loop

Select + New step.
Search for and then select Control.
In the Actions list, select For each.
For Select an output from previous steps (click inside text box if needed), select Body under Get messages from a topic subscription (peek-lock).

Add a step inside the foreach loop to send an email with the message body

Within For Each loop, select Add an action.
In the Search connectors and actions text box, enter Office 365.
Select Office 365 Outlook in the search results.
In the list of actions, select Send an email (V2).
In the Send an email (V2) window, follow these steps:
Select inside the text box for Body, and follow these steps:
1. For To, enter an email address.
2. For Subject, enter Message received from Service Bus topic's subscription.
3. Switch to Expression.
4. Enter the following expression:
```
base64ToString(items('For_each')?['ContentData'])
```
5. Select OK.

Add another action in the foreach loop to complete the message

Within For Each loop, select Add an action.
1. Select Service Bus in the Recent list.
2. Select Complete the message in a topic subscription from the list of actions.
3. Select your Service Bus topic.
4. Select a subscription to the topic.
5. For Lock token of the message, select Lock Token from the Dynamic content.
Select Save on the toolbar on the Logic Apps Designer to save the logic app.

Test the app

If you haven't already sent test messages to the topic, follow instructions in the Send messages to the Service Bus topic section to send messages to the topic.
Switch to the Overview page of your logic app and then switch to the Runs history tab in the bottom pane. You see the logic app runs messages that were sent to the topic. It could take a few minutes before you see the logic app runs. Select Refresh on the toolbar to refresh the page.
Select a logic app run to see the details. Notice that it processed 5 messages in the for loop.
You should get an email for each message that's received by the logic app.

Troubleshoot

If you don't see any invocations after waiting and refreshing for sometime, follow these steps:

Confirm that the messages reached the Service Bus topic. See the incoming messages counter on the Service Bus Topic page. In this case, I ran the MessageSender application twice, so I see 10 messages (5 messages for each run).
Confirm that there are no active messages at the Service Bus subscription. If you don't see any events on this page, verify that the Service Bus Subscription page doesn't show any Active message count. If the number for this counter is greater than zero, the messages at the subscription aren't forwarded to the handler function (event subscription handler) for some reason. Verify that you've set up the event subscription properly.
You also see delivered events on the Events page of the Service Bus namespace.
You can also see that the events are delivered on the Event Subscription page. You can get to this page by selecting the event subscription on the Events page.