Edit

Share via


Add Fabric workspace item events to an eventstream

This article shows you how to add Fabric workspace item event source to an eventstream.

Fabric workspace item events are discrete Fabric events that occur when contents of your Fabric Workspace are changed. These changes include creating, updating, or deleting of Fabric items except for the item types listed in the following note.

Note

Currently, Fabric workspace item events for the following Power BI item types (itemKind) are not supported:

  • Semantic Model
  • Paginated report
  • Report
  • App
  • Dashboard

With Fabric eventstreams, you can capture these Fabric workspace events, transform them, and route them to various destinations in Fabric for further analysis. This seamless integration of Fabric workspace events within Fabric eventstreams gives you greater flexibility for monitoring and analyzing activities in your Fabric workspace.

Here are the supported Fabric workspace events:

  • Microsoft.Fabric.ItemCreateSucceeded
  • Microsoft.Fabric.ItemCreateFailed
  • Microsoft.Fabric.ItemUpdateSucceeded
  • Microsoft.Fabric.ItemUpdateFailed
  • Microsoft.Fabric.ItemDeleteSucceeded
  • Microsoft.Fabric.ItemDeleteFailed

Note

Effective March 21, 2025, the Microsoft.Fabric.ItemReadSucceeded and Microsoft.Fabric.ItemReadFailed event types are deprecated. So, users in your organization don't see these event types when creating subscriptions (eventstreams or alerts) for the Fabric workspace.

Existing subscriptions (eventstreams or alerts) for these events will stop receiving events on March 21, 2025.

Prerequisites

  • Access to a workspace in the Fabric capacity license mode (or) the Trial license mode with Contributor or higher permissions.
  • A Fabric workspace with events you want to track.

Add Fabric Workspace Item events as source

If you haven't added any source to your eventstream yet, select the Connect data sources tile. You can also select Add source > Connect data sources on the ribbon.

Screenshot that shows the selection of the tile for using an external source.

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

Screenshot that shows selections for adding external sources.

On the Select a data source page, search for and select Connect on the Fabric Workspace item events tile.

Screenshot that shows the selection of Fabric Workspace item events as the source type in the Select a data source window.

Configure and connect to Fabric Workspace Item events

  1. On the Connect screen, first select Event type(s) of interest that you want to capture in the eventstream. By default, all supported events are captured.

    Screenshot that shows the Connect page for Fabric Workspace item events.

  2. In the next step, select the right Event source. You can choose between streaming all workspace item events in a tenant by selecting the source option as Across this tenant or restrict to specific workspace by choosing By workspace option. To select a workspace for which you want to stream workspace item events, you must be a workspace admin, member, or contributor of that workspace. To receive workspace item events across the tenant, you need to be a Fabric tenant admin

    A screenshot of the Connect screen.

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 updated eventstream

  1. Once the connection is created, you can see the Fabric workspace item events source added to your eventstream in Edit mode. Select Publish to publish the eventstream and capture the workspace events.

    A screenshot of the Fabric workspace item events source added to the eventstream.

    Note

    Before proceeding with event transformation or routing, ensure that workspace events were triggered and successfully sent to the eventstream.

  2. If you want to transform the Fabric workspace events, open your eventstream and select Edit to enter Edit mode. Then you can add operations to transform the Fabric workspace events or route them to a destination such as Lakehouse.

    A screenshot of the Fabric workspace item events in Live view, where you can select Edit.

Known limitations

  • Currently, error messages aren't available when an error occurs on discrete events sources.
  • Currently, the Data Preview feature isn't available for discrete events sources.