Skip to content

Commit a7d68f8

Browse files
committed
copy edits
1 parent 5d13bf2 commit a7d68f8

2 files changed

Lines changed: 23 additions & 11 deletions

File tree

docs/troubleshooting/serverless-workers.mdx

Lines changed: 22 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -111,10 +111,21 @@ temporal workflow show \
111111
The WCI runs a `PullStats` Activity on a regular interval (typically every 5 minutes when idle). If `PullStats`
112112
consistently 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

sidebars.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1322,6 +1322,7 @@ module.exports = {
13221322
'troubleshooting/deadline-exceeded-error',
13231323
'troubleshooting/last-connection-error',
13241324
'troubleshooting/performance-bottlenecks',
1325+
'troubleshooting/serverless-workers',
13251326
],
13261327
},
13271328
{

0 commit comments

Comments
 (0)