Skip to content

Commit c590e26

Browse files
committed
Add the beta.24 changelog entry
1 parent 66b1612 commit c590e26

File tree

1 file changed

+50
-0
lines changed

1 file changed

+50
-0
lines changed

docs/upgrade-to-v4.mdx

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1125,3 +1125,53 @@ We recommend enabling this option and testing in a staging or preview environmen
11251125
- Fail fast in CI when running deploy with missing `TRIGGER_ACCESS_TOKEN` and add useful error message with link to docs ([#2258](https://github.com/triggerdotdev/trigger.dev/pull/2258))
11261126

11271127
</Update>
1128+
1129+
<Update label="July 22, 2025" description="v4.0.0-beta.24">
1130+
[Release
1131+
v4.0.0-beta.24](https://github.com/triggerdotdev/trigger.dev/releases/tag/trigger.dev%404.0.0-v4-beta.24).
1132+
1133+
- Removes the `releaseConcurrencyOnWaitpoint` option on queues and the `releaseConcurrency` option on various wait functions. Replaced with the following default behavior: ([#2284](https://github.com/triggerdotdev/trigger.dev/pull/2284))
1134+
1135+
- Concurrency is never released when a run is first blocked via a waitpoint, at either the env or queue level.
1136+
- Concurrency is always released when a run is checkpointed and shutdown, at both the env and queue level.
1137+
1138+
Additionally, environment concurrency limits now have a new "Burst Factor", defaulting to 2.0x. The "Burst Factor" allows the environment-wide concurrency limit to be higher than any individual queue's concurrency limit. For example, if you have an environment concurrency limit of 100, and a Burst Factor of 2.0x, then you can execute up to 200 runs concurrently, but any one task/queue can still only execute 100 runs concurrently.
1139+
1140+
We've done some work cleaning up the run statuses. The new statuses are:
1141+
1142+
- `PENDING_VERSION`: Task is waiting for a version update because it cannot execute without additional information (task, queue, etc.)
1143+
- `QUEUED`: Task is waiting to be executed by a worker
1144+
- `DEQUEUED`: Task has been dequeued and is being sent to a worker to start executing.
1145+
- `EXECUTING`: Task is currently being executed by a worker
1146+
- `WAITING`: Task has been paused by the system, and will be resumed by the system
1147+
- `COMPLETED`: Task has been completed successfully
1148+
- `CANCELED`: Task has been canceled by the user
1149+
- `FAILED`: Task has failed to complete, due to an error in the system
1150+
- `CRASHED`: Task has crashed and won't be retried, most likely the worker ran out of resources, e.g. memory or storage
1151+
- `SYSTEM_FAILURE`: Task has failed to complete, due to an error in the system
1152+
- `DELAYED`: Task has been scheduled to run at a specific time
1153+
- `EXPIRED`: Task has expired and won't be executed
1154+
- `TIMED_OUT`: Task has reached it's maxDuration and has been stopped
1155+
1156+
We've removed the following statuses:
1157+
1158+
- `WAITING_FOR_DEPLOY`: This is no longer used, and is replaced by `PENDING_VERSION`
1159+
- `FROZEN`: This is no longer used, and is replaced by `WAITING`
1160+
- `INTERRUPTED`: This is no longer used
1161+
- `REATTEMPTING`: This is no longer used, and is replaced by `EXECUTING`
1162+
1163+
We've also added "boolean" helpers to runs returned via the API and from Realtime:
1164+
1165+
- `isQueued`: Returns true when the status is `QUEUED`, `PENDING_VERSION`, or `DELAYED`
1166+
- `isExecuting`: Returns true when the status is `EXECUTING`, `DEQUEUED`. These count against your concurrency limits.
1167+
- `isWaiting`: Returns true when the status is `WAITING`. These do not count against your concurrency limits.
1168+
- `isCompleted`: Returns true when the status is any of the completed statuses.
1169+
- `isCanceled`: Returns true when the status is `CANCELED`
1170+
- `isFailed`: Returns true when the status is any of the failed statuses.
1171+
- `isSuccess`: Returns true when the status is `COMPLETED`
1172+
1173+
This change adds the ability to easily detect which runs are being counted against your concurrency limit by filtering for both `EXECUTING` or `DEQUEUED`.
1174+
1175+
- Added runs.list filtering for queue and machine ([#2277](https://github.com/triggerdotdev/trigger.dev/pull/2277))
1176+
1177+
</Update>

0 commit comments

Comments
 (0)