Get events from Azure Service Bus into Real-Time hub (preview)

This article describes how to get events from an Azure Service Bus queue or a topic's subscription into Real-Time hub.

Prerequisites

• Access to a workspace in the Fabric capacity license mode or trial license mode with Contributor or higher permissions.
• Appropriate permission to get access keys for the Service Bus namespace, queues, or topics. The Service Bus namespace should be publicly accessible and not behind a firewall or secured in a virtual network. If it resides in a protected network, connect to it by using Eventstream connector virtual network injection.

Get events from Azure Service Bus

You can get events from an Azure Service Bus into Real-Time hub in one of the ways:

• Using the Data sources page
• Using the Microsoft sources page

Data sources page

1. Sign in to Microsoft Fabric.

2. If you see Power BI at the bottom-left of the page, switch to the Fabric workload by selecting Power BI and then by selecting Fabric.

   

3. Select Real-Time on the left navigation bar.

   

4. The Streaming data page opens by default. Click on the Add data button to get to the Data sources page.

   

   You can also get to the Data sources page directly by selecting the Add data option in the left navigation bar.

   

4. On the Data sources page, select Microsoft sources category at the top, and then select Connect on the Azure Service Bus tile.

   

   Now, follow instructions from the Configure Azure Service Bus source section.

Azure sources page

1. In Real-Time hub, select Azure sources on the left navigation menu. You can use the search box to the type your resource name or use filters (Source, Subscription, Resource group, Region) to search for your resource.

2. For Source at the top, select Azure Service Bus from the drop-down list.

3. For Subscription, select an Azure subscription that has the resource group with your queue to topic's subscription.

4. For Resource group, select a resource group that has your queue or topic's subscription.

5. For Region, select a location where your Service Bus queue or topic's subscription is located.

6. Now, move the mouse over the name of the Service Bus queue that you want to connect to Real-Time hub in the list of Service Bus namespaces, and select the Connect button, or select ... (ellipsis), and then select Connect data source.

   

Configure Azure Service Bus source

1. On the Connect page, select New connection.

   

   If there's an existing connection to your Azure Service Bus resource, select that existing connection, and then move on to configuring Service Bus Type in the following steps.

   

2. In the Connection settings section, for Host Name, enter the host name for your service bus. You can get the name from the Overview page of your Service Bus namespace. It's in the form of NAMESPACENAME.servicebus.windows.net.

   

3. In the Connection credentials section, follow these steps:

   1. For Connection name, enter a name for the connection to the Service Bus queue or topic.

   2. For Authentication kind, confirm that Shared Access Key is selected.

   3. For Shared access key name, enter the name of the shared access key.

   4. For Shared Access Key, enter the value of the shared access key.

      To get the access key's name and value, follow these steps:

      1. In the Azure portal, go to the page for your Service Bus namespace.
      2. On the left menu, select Shared access policies.
      3. Select the access key from the list. Note the name of the access key.
      4. Select the copy button next to the Primary key value.

   5. Select Connect.

   

4. In the Configure Azure Service Bus Source section, follow these steps:

   1. For Service Bus Type, select Topic (default) or Queue.

   2. If you selected Topic:

      1. For Topic name, enter the name of the topic.
      2. For Subscription, enter the name of the subscription to that topic.

      

      If you selected Queue, enter the name of the queue.

Stream or source details

1. On the Connect page, follow one of these steps based on whether you're using Eventstream or Real-Time hub.

   • Eventstream:

     In the Source details pane to the right, follow these steps:

     1. For Source name, select the Pencil button to change the name.

     2. Notice that Eventstream name and Stream name are read-only.

   • Real-Time hub:

     In the Stream details section to the right, follow these steps:

     1. Select the Fabric workspace where you want to create the eventstream.

     2. For Eventstream name, select the Pencil button, and enter a name for the eventstream.

     3. The Stream name value is automatically generated for you by appending -stream to the name of the eventstream. This stream appears on the real-time hub's All data streams page when the wizard finishes.

2. Select Next at the bottom of the Configure page.

Review and connect

On the Review + connect screen, review the summary, and select Add (Eventstream) or Connect (Real-Time hub).

View data stream details

1. On the Review + connect page, if you select Open eventstream, the wizard opens the eventstream that it created for you with the selected Service Bus resource as a source. To close the wizard, select Finish at the bottom of the page.

   

2. You should see the stream in the Recent streaming data section of the Real-Time hub home page. For detailed steps, see View details of data streams in Fabric Real-Time hub.

   

Related content

To learn about consuming data streams, see the following articles:

• Process data streams
• Analyze data streams
• Set alerts on data streams