Edit

Share via


Add Azure Event Grid Namespace source to an eventstream (Preview)

This article shows you how to add an Azure Event Grid Namespace source to an eventstream.

Prerequisites

  • Access to a workspace in the Fabric capacity license mode (or) the Trial license mode with Member or higher permissions.
  • Enable managed identity on the Event Grid namespace.
  • Enable MQTT and routing on the Event Grid namespace, if you want to receive Message Queuing Telemetry Transport (MQTT) data.
  • Create an eventstream if you don't have one.

To ensure the managed identity of the Event Grid namespace has the required permissions, configure the necessary settings in the Admin portal

  • Select Settings (gear icon) in the top-right corner.

  • Select Admin portal in the Governance and insights section.

    Screenshot that shows the selection of Admin portal link in the Governance and insights section.

  • Activate the following tenant setting to grant the service principal access to Fabric APIs for creating workspaces, connections, or deployment pipelines.

    • On the Tenant settings page, in the Developer settings section, expand Service principal can use Fabric API option.

    • Toggle to Enabled.

    • Apply to the entire organization.

    • Select Apply.

      Screenshot that shows the developer settings.

  • Enable this option to access all other APIs (enabled by default for new tenants):

    • On the Tenant settings page, in the Developer settings section, expand Allow Service principals to create and use profiles option.
    • Toggle to Enabled.
    • Apply to the entire organization.
    • Select Apply.

Launch the Select a data source wizard

If you haven't added any source to your eventstream yet, select Use external source tile.

Screenshot that shows the selection of Use external source tile.

If you're adding the source to an already published eventstream, switch to Edit mode, select Add source on the ribbon, and then select External sources.

Screenshot that shows the selection of Add source to External sources menu.

On the Select a data source page, search for and select Connect on the Azure Event Grid Namespace tile.

Screenshot that shows the selection of Azure Event Grid Namespace as the source type in the Get events wizard.

Configure Azure Event Grid connector

On the Configure connection settings page, follow these steps:

  1. For Subscription, select the Azure subscription that has the Event Grid namespace.

  2. For Namespace name, select your Event Grid namespace from the drop-down list.

  3. The Namespace topic section you see varies depending on whether Message Queuing Telemetry Transport (MQTT) is enabled or not.

    • If MQTT isn't enabled for the namespace topic, create a new topic or select an existing topic.

      Screenshot that shows the configuration settings for the Azure Event Grid namespace.

    • If the namespace has MQTT enabled, a topic, and routing enabled:

      Screenshot that shows the configuration settings for the Azure Event Grid namespace when MQTT and routing are enabled.

    • If the namespace has MQTT enabled, but routing isn't enabled for the namespace:

      Screenshot that shows the configuration settings for the Azure Event Grid namespace when MQTT is enabled but routing isn't enabled.

  4. If you're using Real-Time hub, follow these steps:

    1. In the Stream details section to the right, select the Fabric workspace where you want to save the eventstream that the Wizard is going to create.

    2. For eventstream name, enter a name for the eventstream. The wizard creates an eventstream with the selected Event Grid namespace as a source.

    3. The Stream name is automatically generated for you by appending -stream to the name of the eventstream. You can see this stream on the Real-time hub All data streams page when the wizard finishes.

      Screenshot that shows the Stream details section for the Event Grid namespace.

  5. If you're using the Eventstream editor to add an Event Grid namespace as a source to an event stream, select pencil button under Source name, and enter a source name.

  6. Select Next at the bottom of the page.

  7. On the Review + connect page, review settings, and select Connect.

    Screenshot that shows the Review + connect page for Azure Event Grid connector.

    If the namespace has both MQTT and routing enabled:

    Screenshot that shows the Review + connect page for Azure Event Grid namespace with MQTT and routing enabled.

    If the namespace has MQTT enabled, but routing isn't enabled:

    Screenshot that shows the Review + connect page for Azure Event Grid namespace with MQTT, but routing isn't enabled.

Note

The maximum number of sources and destinations for one eventstream is 11.

View updated eventstream

  1. On the Review + connect page, select Add.

  2. You see that the Event Grid source is added to your eventstream on the canvas in the Edit mode. To implement this newly added Azure Event Grid namespace, select Publish on the ribbon.

    Screenshot that shows the editor with Publish button selected.

  3. After you complete these steps, the Azure Event Grid namespace is available for visualization in the Live view. Select the Event Grid Namespace tile in the diagram to see details about the source.

To learn how to add other sources to an eventstream, see the following article: Add and manage an event source in an eventstream.