Skip to content

Commit bbf0705

Browse files
jpvottaclaudeflippedcoder
authored
Clarify fairness state is largely preserved across server restarts (#4386)
* Clarify that fairness state is largely preserved across server restarts The previous limitation implied fairness stats were never persisted, which is no longer accurate. Temporal now preserves counters for up to 100 active fairness keys across restarts, making disruption generally unnoticeable. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Avoid hardcoding the number of persisted fairness keys Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Clarify restart behavior: backlog is durable, describe actual failure mode Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * Remove "largely" — fairness is fully preserved for tracked keys Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com> Co-authored-by: Milecia McG <47196133+flippedcoder@users.noreply.github.com>
1 parent b90ff3b commit bbf0705

1 file changed

Lines changed: 1 addition & 1 deletion

File tree

docs/develop/task-queue-priority-fairness.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -641,4 +641,4 @@ Weight overrides are stored per Task Queue, including type, so they must be set
641641
- Task Queues are internally [partitioned](/task-queue#task-ordering) and Tasks are distributed to partitions randomly. This could interfere with fairness. Depending on your use case, you can reach out to Temporal Support to get your Task Queues set to a single partition.
642642
- The fairness weight applies at schedule time, not at dispatch time. So it only affects newly-scheduled Tasks, not currently backlogged ones. This means if you need to throttle a single fairness key in the existing backlog of Tasks, you won't be able to.
643643
- When you use Worker Versioning and you're moving Workflows from one version to another, Priority will still apply between versions. Fairness isn't guaranteed between versions. For example, you may have Tasks that were originally queued on Worker version _alpha_, Tasks that were queued on Worker version _beta_, and some Tasks were moved from _alpha_ to _beta_. Fairness is only guaranteed when Tasks are originally queued on the same Worker version. So there might be some discrepancies on the Tasks moved from _alpha_ to _beta_.
644-
- Fairness stats are not persisted, so server deployments can cause temporary lack of Fairness and misordered tasks.
644+
- Backlogged tasks are durable and unaffected by server restarts. Fairness ordering is preserved across restarts for the most active keys; less active keys may briefly dispatch new tasks ahead of their existing backlog until ordering normalizes.

0 commit comments

Comments
 (0)