Automation events track the lifecycle of automation triggers and the actions they
execute. For more on automations, see Automations.
Trigger state events
prefect.automation.triggered
Emitted when an automation’s trigger condition is met and the automation enters
the triggered state.
Resource
| Label | Description |
|---|
prefect.resource.id | prefect.automation.{uuid} |
prefect.resource.name | Automation name |
prefect.posture | Trigger posture: Reactive, Proactive, or Metric (for event triggers only) |
| Resource ID pattern | Role | When present |
|---|
prefect.event.{uuid} | triggering-event | When the trigger was fired by a specific event |
Payload
| Field | Type | Description |
|---|
triggering_labels | object | Labels from the triggering event that matched the trigger’s for_each criteria |
triggering_event | object or null | Full serialized event that caused the trigger to fire |
prefect.automation.resolved
Emitted when an automation’s trigger condition is no longer met and the automation
returns to the resolved state (for example, a proactive trigger that previously
fired because events stopped now sees events resume).
Resource
Same as prefect.automation.triggered.
Same as prefect.automation.triggered.
Payload
Same as prefect.automation.triggered.
Action lifecycle events
prefect.automation.action.triggered
Emitted when an automation action begins execution.
Resource
| Label | Description |
|---|
prefect.resource.id | prefect.automation.{uuid} |
prefect.resource.name | Automation name |
prefect.trigger-type | Trigger type (for example, event, compound, sequence, metric) |
prefect.posture | Trigger posture (for event triggers only) |
| Resource ID pattern | Role | When present |
|---|
prefect.event.{uuid} | automation-triggered-event | Links to the automation.triggered or automation.resolved event that prompted this action |
prefect.event.{uuid} | triggering-event | The original event that caused the automation to fire |
Payload
| Field | Type | Description |
|---|
action_index | integer | Index of the action within the automation’s action list |
action_type | string | Action type (for example, run-deployment, send-notification, call-webhook) |
invocation | string | Unique ID for this action invocation |
prefect.automation.action.executed
Emitted when an automation action completes successfully. Uses the follows field
to link back to the corresponding action.triggered event.
Resource
Same as prefect.automation.action.triggered.
Same as prefect.automation.action.triggered.
Payload
| Field | Type | Description |
|---|
action_index | integer | Index of the action |
action_type | string | Action type |
invocation | string | Invocation ID |
run-deployment action).
prefect.automation.action.failed
Emitted when an automation action fails. Uses the follows field to link back to
the corresponding action.triggered event.
Resource
Same as prefect.automation.action.triggered.
Same as prefect.automation.action.triggered.
Payload
| Field | Type | Description |
|---|
action_index | integer | Index of the action |
action_type | string | Action type |
invocation | string | Invocation ID |
reason | string | Description of why the action failed |
Prefect Cloud automation events
The following events are only available in Prefect Cloud.
prefect-cloud namespace.
These are structurally identical to the OSS events above but use different event
names.
prefect-cloud.automation.triggered
Cloud equivalent of prefect.automation.triggered. Emitted when an automation
enters the triggered state.
prefect-cloud.automation.resolved
Cloud equivalent of prefect.automation.resolved. Emitted when an automation
returns to the resolved state.
prefect-cloud.automation.action.triggered
Cloud equivalent of prefect.automation.action.triggered.
prefect-cloud.automation.action.executed
Cloud equivalent of prefect.automation.action.executed.
prefect-cloud.automation.action.failed
Cloud equivalent of prefect.automation.action.failed.
prefect-cloud.automation.action.disabled
Emitted when an automation action is disabled (for example, after repeated
failures). This event is specific to Prefect Cloud. 
