Skip to main content
Concurrency events cover two categories: CRUD lifecycle events emitted when concurrency limits are created, updated, or deleted, and slot events emitted when concurrency slots are acquired and released. For more on concurrency limits, see Global concurrency limits.

Concurrency limit lifecycle events

prefect.concurrency-limit.created

Emitted when a new concurrency limit is created.

Resource

This event has no related resources.

Payload

For global (v2) concurrency limits: For tag-based (v1) concurrency limits:

prefect.concurrency-limit.updated

Emitted when a concurrency limit’s configuration is changed.

Resource

Same as prefect.concurrency-limit.created. This event has no related resources.

Payload

Same as prefect.concurrency-limit.created.

prefect.concurrency-limit.deleted

Emitted when a concurrency limit is deleted.

Resource

Same as prefect.concurrency-limit.created. This event has no related resources.

Payload

Same as prefect.concurrency-limit.created.

Slot events

prefect.concurrency-limit.acquired

Emitted when concurrency slots are acquired for a named limit.

Resource

Payload

This event has no payload.

prefect.concurrency-limit.released

Emitted when concurrency slots are released for a named limit. Uses the follows field to link back to the corresponding acquired event.

Resource

Same as prefect.concurrency-limit.acquired. Same as prefect.concurrency-limit.acquired.

Payload

This event has no payload.

Legacy v1 concurrency events

These events are emitted by the legacy tag-based concurrency limit system. For new concurrency limits, use global concurrency limits which emit the events documented above.

prefect.concurrency-limit.v1.acquired

Emitted when a legacy tag-based concurrency slot is acquired.

Resource

Payload

This event has no payload.

prefect.concurrency-limit.v1.released

Emitted when a legacy tag-based concurrency slot is released.

Resource

Same as prefect.concurrency-limit.v1.acquired. Same as prefect.concurrency-limit.v1.acquired.

Payload

This event has no payload.