@@ -111,10 +111,21 @@ temporal workflow show \
111111The WCI runs a ` PullStats ` Activity on a regular interval (typically every 5 minutes when idle). If ` PullStats `
112112consistently returns no Tasks, the server does not associate any Task Queues with your Worker Deployment Version.
113113
114- The server binds a Task Queue to a Worker Deployment Version when a Worker with that deployment version polls the Task
115- Queue. If the Lambda has never been successfully invoked, or the deployment name or build ID in the Worker code does not
116- match the WCI configuration, the binding does not exist. See
117- [ Check that the deployment name and build ID match] ( #check-deployment-match ) for how to diagnose a mismatch.
114+ Check which Task Queues are bound to the Worker Deployment Version and whether there is a backlog:
115+
116+ ``` bash
117+ temporal worker deployment describe-version \
118+ --namespace < NAMESPACE> \
119+ --deployment-name < DEPLOYMENT_NAME> \
120+ --build-id < BUILD_ID> \
121+ --report-task-queue-stats
122+ ```
123+
124+ If no Task Queues are listed, the binding has not been established. The server binds a Task Queue to a Worker Deployment
125+ Version when a Worker with that deployment version polls the Task Queue. If the Lambda has never been successfully
126+ invoked, or the deployment name or build ID in the Worker code does not match the WCI configuration, the binding does
127+ not exist. See [ Check that the deployment name and build ID match] ( #check-deployment-match ) for how to diagnose a
128+ mismatch.
118129
119130### Check that the deployment name and build ID match { #check - deployment - match }
120131
@@ -200,15 +211,15 @@ Common errors include:
200211
201212### Check for Lambda timeout { #check - lambda - timeout }
202213
203- If the Lambda function times out before the Worker finishes processing, you see a ` Task timed out ` error in CloudWatch.
214+ If the Lambda function reaches its configured timeout before the Worker finishes processing, AWS terminates the
215+ invocation.
204216
205- The Worker begins graceful shutdown before the Lambda deadline, controlled by ` ShutdownDeadlineBuffer ` (Go),
206- ` shutdown_deadline_buffer ` (Python), or ` shutdownDeadlineBufferMs ` (TypeScript). If Activities take longer than the
207- available execution window, the Activities are abandoned mid-execution and retried on the next invocation.
217+ The Worker begins graceful shutdown before the Lambda deadline. If Activities take longer than the available execution
218+ window, the Activities are abandoned mid-execution and retried on the next invocation.
208219
209- For long-running Activities, increase the Lambda timeout, ` WorkerStopTimeout ` / ` shutdownGraceTime ` , and
210- ` ShutdownDeadlineBuffer ` / ` shutdownDeadlineBufferMs ` together. See
211- [ Tuning for long-running Activities ] ( /serverless-workers#tuning-for-long-running-activities ) .
220+ For long-running Activities, increase the Lambda timeout and the Worker's shutdown buffer together. See
221+ [ Tuning for long-running Activities ] ( /serverless-workers#tuning-for-long-running-activities ) for guidance on how these
222+ values relate .
212223
213224### Check for infinite invocation loops { #check - infinite - loop }
214225
0 commit comments