Add Fabric job events to an eventstream (preview)

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

Note

Consuming Fabric and Azure events via eventstream or Fabric Activator is not supported if the capacity region of the eventstream or Activator is in the following regions: Germany West Central, South-Central US, West US2, West US3, West India.

Job events allow you to subscribe to changes produced when Fabric runs a job. For example, you can react to changes when refreshing a semantic model, running a scheduled pipeline, or running a notebook. Each of these activities can generate a corresponding job, which in turn generates a set of corresponding job events.

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

Event types

Event type name Description
Microsoft.Fabric.ItemJobCreated Raised when the Fabric platform creates or triggers a job, manually or scheduled.
Microsoft.Fabric.ItemJobStatusChanged Raised when the job status changes to another non-terminal state.

This event isn't raised if the workload doesn't push when the status changes. The job status might change from created to completed soon.

Microsoft.Fabric.ItemJobSucceeded Raised when the job completes.
Microsoft.Fabric.ItemJobFailed Raised when the job fails, including job getting stuck or canceled.

Prerequisites

  • Get access to a workspace in the Fabric capacity license mode (or) the Trial license mode with Contributor or higher permissions.
  • Create an eventstream if you don't already have an eventstream.

Add Fabric Job events as source

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 Job events tile.

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

Configure and connect to Fabric job events

  1. On the Connect page, for Event types, select the event types that you want to monitor.

    Screenshot that shows the selection of Job event types on the Connect page.

  2. This step is optional. To see the schemas for event types, select View selected event type schemas. If you select it, browse through schemas for the events, and then navigate back to previous page by selecting the backward arrow button at the top.

  3. For Event source, confirm that By item is selected.

  4. For Workspace, select a workspace where the Fabric item is.

  5. For Item, select the Fabric item.

    Screenshot that shows the configuration of source, workspace, and item.

  6. Now, on the Configure connection settings page, you can add filters to set the filter conditions by selecting fields to watch and the alert value. To add a filter:

    1. Select + Filter.

    2. Select a field.

    3. Select an operator.

    4. Select one or more values to match.

      Screenshot that shows the addition of a filter.

  7. Then, select Next at the bottom of the page.

    Screenshot that shows the selection of the Next button.

  8. On the Review + connect page, review settings, select Add.

    Screenshot that shows the Review and create page.

Note

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

View updated eventstream

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

    A screenshot of the Fabric job events source added to the eventstream.

    Note

    Before proceeding with event transformation or routing, ensure that job events have been triggered and successfully sent to the eventstream.

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

    A screenshot of the Fabric job 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.