Explore Job events in Fabric Real-Time hub (preview)
Real-Time hub allows you to discover and 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.
Job events allow you to monitor job results in time and set up alerts using Data Activator alerting capabilities. For example, when the scheduler triggers a new job, or a job fails, you can receive an email alert. This way, even if you aren't in front of the computer, you can still get the information you care about.
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.
View Job events detail page
In Real-Time hub, select Fabric events.
Select Job events from the list.
You should see the detail view for Job events.
Actions
At the top of the detail page, you see the following two actions.
Create eventstream, which lets you create an eventstream based on events from the selected Job.
Set alert, which lets you set an alert when an operation is done for a Job, such as a job is created or changed.
See what's using this category
This section shows the artifacts using Job events. Here are the columns and their descriptions:
Column | Description |
---|---|
Name | Name of the artifact that's using Job events. |
Type | Artifact type – Data Activator or Eventstream |
Workspace | Workspace where the artifact lives. |
Source | Name of the workspace that is source of the events. |
Job events profile
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 directly. |
Microsoft.Fabric.ItemJobSucceeded | Raised when the job completes successfully. |
Microsoft.Fabric.ItemJobFailed | Raised when the job fails, including job getting stuck or canceled. |
Schemas
An event has the following top-level data:
Property | Type | Description | Example |
---|---|---|---|
source |
string | Identifies the context in which an event happened. A tenant ID. | aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb |
subject |
string | Identifies the subject of the event in the context of the event producer. | /workspaces/<WORKSPACEID>/items/<ARTIFACTID>/jobs/instances/{JOBID} |
type |
string | One of the registered event types for this event source. | Microsoft.Fabric.ItemJobCreated |
time |
timestamp | The time the event is generated based on the provider's UTC time. | 2017-06-26T18:41:00.9584103Z |
id |
string | Unique identifier for the event. | bbbbbbbb-1111-2222-3333-cccccccccccc |
data |
object | Event data. | See the next table for details. |
specversion |
string | The version of the Cloud Event spec. | 1.0 |
dataschemaversion |
string | The version of the data schema. | 1.0 |
capacityId |
guid | The capacity ID. | bbbbbbbb-1111-2222-3333-cccccccccccc |
The data
object has the following properties:
Property | Type | Description | Example |
---|---|---|---|
data.itemId |
guid | The ID of the item or artifact. | cccccccc-8888-9999-0000-dddddddddddd |
data.itemKind |
string | The kind or type of the item or artifact. | Lakehouse |
data.itemName |
string | The item or artifact name. | myitem |
data.workspaceId |
guid | The ID of the workspace. | aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb |
data.workspaceName |
string | The name of the workspace. | myworkspace |
data.executingPricipalId |
guid | ID of the service principal used to execute the job. | a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1 |
data.executingPriciplaType |
string | The type of the executing principal ID. | User or Service Principal |
data.jobInstanceId |
guid | The ID of the job. | dddddddd-3333-4444-5555-eeeeeeeeeeee |
data.jobStatus |
string | The status of this job. | InProgress |
data.jobType |
string | The type of this job. | RunNotebook |
data.jobInovkeType |
string | The invocation type of this job. | Scheduled or Manual |
data.jobScheduleTime |
timestamp | The job's schedule time. | 2017-06-26T18:41:00.9584103Z |
data.jobStartTime |
timestamp | The job's start time. | 2017-06-26T18:41:00.9584103Z |
data.jobEndTime |
timestamp | The job's end time. | 2017-06-26T18:41:00.9584103Z |