Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.prefect.io/llms.txt

Use this file to discover all available pages before exploring further.

Concurrency events track when slots are acquired and released for named concurrency limits. For more on concurrency limits, see Global concurrency limits.

prefect.concurrency-limit.acquired

Emitted when concurrency slots are acquired for a named limit.

Resource

LabelDescription
prefect.resource.idprefect.concurrency-limit.{uuid}
prefect.resource.nameConcurrency limit name
slots-acquiredNumber of slots acquired in this request
limitMaximum number of slots for this limit
Resource ID patternRoleWhen present
prefect.concurrency-limit.{uuid}concurrency-limitOne entry per other limit in the same acquisition batch (when acquiring multiple limits at once)

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

LabelDescription
prefect.resource.idprefect.concurrency-limit.v1.{uuid}
prefect.resource.nameTag name
limitMaximum number of slots
task_run_idID of the task run acquiring the slot
Resource ID patternRoleWhen present
prefect.concurrency-limit.v1.{uuid}concurrency-limitOne entry per other limit in the same acquisition batch

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.