Add Fabric capacity operation events to an eventstream (preview)

This article shows you how to add Fabric capacity operation event source to an eventstream.

Fabric Capacity Operation Events provide granular, per-operation information about workload activity that consumes capacity units (CUs) on your Fabric capacity. Use these events to create alerts related to your capacity operations via Data Activator or store them in an Eventhouse for granular or historical analysis.

By using Fabric event streams, you can capture these Fabric capacity operation events, transform them, and route them to various destinations in Fabric for further analysis. This seamless integration of Fabric capacity operation events within Fabric event streams gives you granular visibility into which workspaces, items, workloads, and identities are consuming CU on your capacity.

Fabric event streams support the following Fabric capacity operation events:

Event type name Description
Microsoft.Fabric.CapacityOperationEvents.Operation Emitted for every operation that consumes capacity.

Prerequisites

  • Access to a workspace in the Fabric capacity license mode or the Trial license mode with Contributor or higher permissions.
  • A Fabric capacity where you have capacity admin role.

Add Fabric capacity operation events as a 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 > Connect data sources.

Screenshot that shows selections for adding external sources.

On Select a data source, search for and select Connect on the Fabric capacity operation events tile.

Screenshot that shows the selection of Fabric capacity operation events as the source type.

Configure and connect to Fabric capacity operation 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 capacity operation events.

  2. For Event scope, select the Fabric capacity for which you want to stream capacity operation events. You need to be a capacity admin on the selected capacity to stream its capacity operation events.

    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 capacity operation events source added to your eventstream in Edit mode. Select Publish to publish the eventstream and capture capacity operation events.

    A screenshot of the Fabric capacity operation events source added to the eventstream.

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

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

Limitation

  • The Fabric capacity operation events source currently doesn't support CI/CD features, including Git Integration and Deployment Pipeline. Attempting to export or import an Eventstream item with this source to a Git repository might result in errors.