Skip to content

Commit cb88c90

Browse files
committed
added a few more common errors for TSG
1 parent be460fa commit cb88c90

File tree

2 files changed

+33
-7
lines changed

2 files changed

+33
-7
lines changed

articles/azure-functions/durable/durable-task-scheduler/develop-with-durable-task-scheduler.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -384,7 +384,7 @@ Now that the identity has the required RBAC to access durable task scheduler, yo
384384
385385
Add these two environment variables to app setting:
386386
- `TASKHUB_NAME`: name of task hub
387-
- `DURABLE_TASK_SCHEDULER_CONNECTION_STRING`: the format of the string is `"Endpoint={DTS endpoint};Authentication=ManagedIdentity;ClientID={client id}"`, where *endpoint* is the scheduler endpoint and *client id* is the managed identity client ID.
387+
- `DURABLE_TASK_SCHEDULER_CONNECTION_STRING`: the format of the string is `"Endpoint={scheduler point};Authentication=ManagedIdentity;ClientID={client id}"`, where *endpoint* is the scheduler endpoint and *client id* is the identity's client ID.
388388

389389
::: zone pivot="az-cli"
390390

@@ -430,7 +430,7 @@ Add these two environment variables to app setting:
430430
::: zone-end
431431

432432
> [!NOTE]
433-
> If you use system-assigned identity, your connection string would *not* need the client ID of the identity resource: `"Endpoint={DTS URL};Authentication=ManagedIdentity"`.
433+
> If you use system-assigned identity, your connection string would *not* need the client ID of the identity resource: `"Endpoint={scheduler endpoint};Authentication=ManagedIdentity"`.
434434

435435
## Accessing durable task scheduler dashboard
436436

articles/azure-functions/durable/durable-task-scheduler/troubleshoot-durable-task-scheduler.md

Lines changed: 31 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,36 @@ ms.date: 01/27/2025
77

88
# Troubleshoot the Azure Functions durable task scheduler dashboard (preview)
99

10+
## Check connection string and access to durable task schedule
11+
12+
When your app isn't running as expected, first check if you have the correct connection string format and have set up authentication correctly.
13+
14+
### Local development
15+
16+
1. Check connection string, which should have this format: `Endpoint=http://localhost:<port number>;Authentication=None`. Ensure the port number is the one mapped to `8080` on the [container that's running the emulator](./quickstart-durable-task-scheduler.md#set-up-durable-task-scheduler-emulator).
17+
1. In addition to the durable task scheduler emulator, check that the Azure Storage emulator [Azurite is started](./quickstart-durable-task-scheduler.md#test-locally). Azurite is need for components of the app related to Functions.
18+
19+
### Running on Azure
20+
21+
1. Check your app for the environment variables `DURABLE_TASK_SCHEDULER_CONNECTION_STRING` and `TASKHUB_NAME`.
22+
1. Check the value of `DURABLE_TASK_SCHEDULER_CONNECTION_STRING`. Specifically, verify that the scheduler endpoint and authentication type are correct. The connection string should be formatted as follows when using:
23+
- **User-assigned managed identity** - `Endpoint={scheduler endpoint};Authentication=ManagedIdentity;ClientID={client id}` where *client id* is the identity's client ID.
24+
- **System-assigned managed identity** - `Endpoint={scheduler endpoint};Authentication=ManagedIdentity`
25+
1. Ensure the required role-based access control (RBAC) permission is [granted to the identity](./develop-with-durable-task-scheduler.md#configure-identity-based-authentication-for-app-to-access-durable-task-scheduler) needing to access the specified task hub or scheduler.
26+
1. When accessing the dashboard, ensure permission is [assigned to your own identity (email)](./develop-with-durable-task-scheduler.md#accessing-durable-task-scheduler-dashboard).
27+
1. If user-assigned managed identity is used, ensure the [identity is assigned to your app](./develop-with-durable-task-scheduler.md#assign-managed-identity-to-your-app).
28+
29+
## Error deploying durable functions app to Azure
30+
31+
If your deployment fails with an error such as `Encountered an error (ServiceUnavailable) from host runtime` from Visual Studio Code, first check your app to ensure the required [environment variables](./develop-with-durable-task-scheduler.md#add-environment-variables-to-app) are set correctly. Then redeploy your app. If you see an error loading functions, click the "Refresh" button.
32+
33+
## Unknown error retrieving details of this task hub
34+
35+
If you get an `Unknown error retrieving details of this task hub` error on the durable task scheduler dashboard, the reason could be:
36+
37+
1. Your identity (email) doesn't have the required permission assigned for that task hub. Follow instructions to [grant the permission](./develop-with-durable-task-scheduler.md#accessing-durable-task-scheduler-dashboard), then access the dashboard again.
38+
1. Your task hub was deleted.
39+
1040
## Can't delete resource
1141

1242
Make sure you delete all task hubs in the durable task scheduler environment. If you haven't, you receive the following error message:
@@ -74,8 +104,4 @@ For Mx Mac (ARM64) users, you may run into gRPC runtime issues with durable func
74104
<Copy SourceFiles="@(NativeAssetToCopy)" DestinationFolder="$(OutDir).azurefunctions/runtimes/osx-arm64/native"/>
75105
</Target>
76106
</Project>
77-
```
78-
79-
## Error deploying app to Azure
80-
81-
If your deployment fails with an error such as `Encountered an error (ServiceUnavailable) from host runtime` from Visual Studio Code, first check your app to ensure the required [environment variables](./develop-with-durable-task-scheduler.md#add-environment-variables-to-app) are set correctly. Then redeploy your app. If you see an error loading functions, click the "Refresh" button.
107+
```

0 commit comments

Comments
 (0)