You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/azure-functions/durable/durable-task-scheduler/develop-with-durable-task-scheduler.md
+35-35Lines changed: 35 additions & 35 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
-
title: Develop with the Durable Task Scheduler (preview)
3
-
description: Learn how to develop with the Durable Task Scheduler and task hub resources
2
+
title: Develop with the Azure Functions durable task scheduler (preview)
3
+
description: Learn how to develop with the Azure Functions durable task scheduler and task hub resources
4
4
author: lilyjma
5
5
ms.topic: how-to
6
6
ms.date: 02/27/2025
@@ -9,16 +9,16 @@ ms.reviewer: azfuncdf
9
9
zone_pivot_groups: dts-devexp
10
10
---
11
11
12
-
# Develop with the Durable Task Scheduler (preview)
12
+
# Develop with the Azure Functions durable task scheduler (preview)
13
13
14
-
The Durable Task Scheduler (DTS) is a highly performant, fully-managed backend provider for Durable Functions with an [out-of-the-box monitoring dashboard](./durable-task-scheduler-dashboard.md). In this article, you'll learn how to:
14
+
The Azure Functions durable task scheduler is a highly performant, fully-managed backend provider for durable functions with an [out-of-the-box monitoring dashboard](./durable-task-scheduler-dashboard.md). In this article, you'll learn how to:
15
15
16
16
> [!div class="checklist"]
17
17
> * Create a scheduler and task hub.
18
-
> * Configure identity-based authentication for your application to access DTS.
18
+
> * Configure identity-based authentication for your application to access durable task scheduler.
19
19
> * Monitor the status of your app and task hub on the dts dashboard.
20
20
21
-
[Learn more about DTS supported regions, plans, and the features it offers.](./durable-task-scheduler.md)
21
+
Learn more about durable task scheduler [features](./durable-task-scheduler.md#feature-highlight), [supported regions](./durable-task-scheduler.md#considerations), and [plans](./durable-task-scheduler.md#considerations).
22
22
23
23
::: zone pivot="az-cli"
24
24
@@ -35,13 +35,13 @@ The Durable Task Scheduler (DTS) is a highly performant, fully-managed backend p
35
35
az upgrade
36
36
```
37
37
38
-
1. Install the DTS CLI extension.
38
+
1. Install the durable task scheduler CLI extension.
39
39
40
40
```azurecli
41
41
az extension add --name durabletask
42
42
```
43
43
44
-
1. If you've already installed the DTS CLI extension, upgrade to the latest version.
44
+
1. If you've already installed the durable task scheduler CLI extension, upgrade to the latest version.
45
45
46
46
```azurecli
47
47
az extension add --upgrade --name durabletask
@@ -54,7 +54,7 @@ The Durable Task Scheduler (DTS) is a highly performant, fully-managed backend p
54
54
::: zone pivot="az-cli"
55
55
56
56
> [!NOTE]
57
-
> DTS currently supports apps hosted in the **App Service** and **Functions Premium** plans only.
57
+
> Durable task scheduler currently supports apps hosted in the **App Service** and **Functions Premium** plans only.
58
58
59
59
1. Create a resource group.
60
60
@@ -135,11 +135,11 @@ The Durable Task Scheduler (DTS) is a highly performant, fully-managed backend p
135
135
::: zone pivot="az-portal"
136
136
137
137
You can create a scheduler and task hub on Azure portal via two ways:
138
-
- **Function app integrated creation:** *(recommended)* automatically creates the managed identity resource and RBAC assignment needed for your app to access DTS.
139
-
- **Top-level creation:** Requires you to [manually assign RBAC](#configure-identity-based-authentication-for-app-to-access-dts) to configure DTS access for your app.
138
+
- **Function app integrated creation:** *(recommended)* automatically creates the managed identity resource and RBAC assignment needed for your app to access durable task scheduler.
139
+
- **Top-level creation:** Requires you to [manually assign RBAC](#configure-identity-based-authentication-for-app-to-access-dts) to configure scheduler access for your app.
140
140
141
141
> [!NOTE]
142
-
> DTS currently supports apps hosted in the **App Service** and **Functions Premium** plans, so this experience is available only when either of these plan types is picked.
142
+
> Durable task scheduler currently supports apps hosted in the **App Service** and **Functions Premium** plans, so this experience is available only when either of these plan types is picked.
@@ -151,11 +151,11 @@ You can create a scheduler and a task hub as part of the Function app creation o
151
151
152
152
1. In the Azure portal, search for **Durable Task Scheduler** and select it from the results.
153
153
154
-
:::image type="content" source="media/create-durable-task-scheduler/search-for-dts.png" alt-text="Screenshot of searching for the Durable Task Scheduler in the portal.":::
154
+
:::image type="content" source="media/create-durable-task-scheduler/search-for-dts.png" alt-text="Screenshot of searching for the durable task scheduler in the portal.":::
155
155
156
156
1. Click **Create** to open the **Azure Functions: Durable Task Scheduler (preview)** pane.
157
157
158
-
:::image type="content" source="media/create-durable-task-scheduler/top-level-create-form.png" alt-text="Screenshot of the create page for the Durable Task Scheduler.":::
158
+
:::image type="content" source="media/create-durable-task-scheduler/top-level-create-form.png" alt-text="Screenshot of the create page for the durable task scheduler.":::
159
159
160
160
1. Fill out the fields in the **Basics** tab. Click **Review + create**. Once the validation passes, click **Create**.
161
161
@@ -165,11 +165,11 @@ You can create a scheduler and a task hub as part of the Function app creation o
165
165
166
166
::: zone-end
167
167
168
-
## View all Durable Task Scheduler resources in a subscription
168
+
## View all durable task scheduler resources in a subscription
169
169
170
170
::: zone pivot="az-cli"
171
171
172
-
1. Get a list of all Durable Task Scheduler names within a subscription by running the following command.
172
+
1. Get a list of all scheduler names within a subscription by running the following command.
173
173
174
174
```azurecli
175
175
az durabletask scheduler list --subscription <SUBSCRIPTION_ID>
@@ -187,13 +187,13 @@ You can create a scheduler and a task hub as part of the Function app creation o
187
187
188
188
In the Azure portal, search for **Durable Task Scheduler** and select it from the results.
189
189
190
-
:::image type="content" source="media/create-durable-task-scheduler/search-for-dts.png" alt-text="Screenshot of searching for the Durable Task Scheduler service in the portal.":::
190
+
:::image type="content" source="media/create-durable-task-scheduler/search-for-dts.png" alt-text="Screenshot of searching for the durable task scheduler service in the portal.":::
191
191
192
192
You can see the list of scheduler resources created in all subscriptions you have access to.
193
193
194
194
::: zone-end
195
195
196
-
## View all task hubs in a Durable Task Scheduler
196
+
## View all task hubs in a durable task scheduler
197
197
198
198
::: zone pivot="az-cli"
199
199
@@ -209,7 +209,7 @@ You can see the list of scheduler resources created in all subscriptions you hav
209
209
210
210
You can see all the task hubs created in a scheduler on the **Overview** of the resource on Azure portal.
211
211
212
-
:::image type="content" source="media/create-durable-task-scheduler/dts-overview-portal.png" alt-text="Screenshot of overview tab of Durable Task Scheduler in the portal.":::
212
+
:::image type="content" source="media/create-durable-task-scheduler/dts-overview-portal.png" alt-text="Screenshot of overview tab of durable task scheduler in the portal.":::
213
213
214
214
::: zone-end
215
215
@@ -243,11 +243,11 @@ You can see all the task hubs created in a scheduler on the **Overview** of the
243
243
244
244
::: zone-end
245
245
246
-
## Configure identity-based authentication for app to access DTS
246
+
## Configure identity-based authentication for app to access durable task scheduler
247
247
248
-
DTS **only** supports either *user-assigned* or *system-assigned* managed identity authentication. **User-assigned identities are recommended,** as they aren't tied to the lifecycle of the app and can be reused after the app is de-provisioned.
248
+
Durable task scheduler **only** supports either *user-assigned* or *system-assigned* managed identity authentication. **User-assigned identities are recommended,** as they aren't tied to the lifecycle of the app and can be reused after the app is de-provisioned.
249
249
250
-
The following sections demonstrate how to configure identity resources for your Durable Functions app to access a scheduler and its task hubs.
250
+
The following sections demonstrate how to configure identity resources for your durable functions app to access a scheduler and its task hubs.
251
251
252
252
### Assign RBAC (role-based access control) to managed identity resource
253
253
@@ -324,7 +324,7 @@ The following sections demonstrate how to configure identity resources for your
324
324
325
325
### Assign managed identity to your app
326
326
327
-
Now that the identity has the required RBAC to access DTS, you need to assign it to your function app.
327
+
Now that the identity has the required RBAC to access durable task scheduler, you need to assign it to your function app.
328
328
329
329
::: zone pivot="az-cli"
330
330
@@ -356,13 +356,13 @@ Now that the identity has the required RBAC to access DTS, you need to assign it
356
356
357
357
Add these two environment variables to app setting:
358
358
- `TASKHUB_NAME`: name of task hub
359
-
- `DURABLE_TASK_SCHEDULER_CONNECTION_STRING`: the format of the string is `"Endpoint={DTS endpoint};Authentication=ManagedIdentity;ClientID={client id}"`, where *endpoint* is the DTS endpoint and *client id* is the managed identity client ID.
359
+
- `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.
360
360
361
361
::: zone pivot="az-cli"
362
362
363
-
1. Get required information for DTS connection string.
363
+
1. Get the required information for the durable task scheduler connection string.
364
364
365
-
To get DTS endpoint.
365
+
To get the scheduler endpoint.
366
366
```azurecli
367
367
az durabletask scheduler show --resource-group RESOURCE_GROUP_NAME --name DTS_NAME --query 'properties.endpoint' --output tsv
368
368
```
@@ -372,7 +372,7 @@ Add these two environment variables to app setting:
372
372
az identity show --name MANAGED_IDENTITY_NAME --resource-group RESOURCE_GROUP_NAME --query 'clientId' --output tsv
373
373
```
374
374
375
-
1. Use the following command to add environment variable for DTS connection string to app.
375
+
1. Use the following command to add environment variable for the scheduler connection string to app.
376
376
```azurecli
377
377
az functionapp config appsettings set --resource-group RESOURCE_GROUP_NAME --name FUNCTION_APP_NAME --settings KEY_NAME=KEY_VALUE
378
378
```
@@ -383,17 +383,17 @@ Add these two environment variables to app setting:
383
383
384
384
::: zone pivot="az-portal"
385
385
386
-
1. Get required information for DTS connection string.
386
+
1. Get the required information for the durable task scheduler connection string.
387
387
388
-
To get your DTS endpoint, navigate to the **Overview** tab of your scheduler resource and find "Endpoint" in the top *Essentials* section.
388
+
To get your scheduler endpoint, navigate to the **Overview** tab of your scheduler resource and find "Endpoint" in the top *Essentials* section.
389
389
390
390
To get your managed identity client ID, navigate to the **Overview** tab of your resource and find "Client ID" in the top *Essentials* section.
391
391
392
392
1. Navigate to your app on the portal.
393
393
394
394
1. In the left menu, click **Settings** > **Environment variables**.
395
395
396
-
1. Add environment variable for DTS connection string.
396
+
1. Add environment variable for durable task scheduler connection string.
397
397
398
398
1. Add environment variable for task hub name.
399
399
@@ -404,9 +404,9 @@ Add these two environment variables to app setting:
404
404
> [!NOTE]
405
405
> If you use system-assigned identity, your connection string would *not* need the client ID of the identity resource: `"Endpoint={DTS URL};Authentication=ManagedIdentity"`.
406
406
407
-
## Accessing DTS dashboard
407
+
## Accessing durable task scheduler dashboard
408
408
409
-
First, follow instructions below to gain access to the [DTS dashboard](./durable-task-scheduler-dashboard.md) by assigning the required role to your *developer identity (email)*. After granting access, go to `https://dashboard.durabletask.io/` and fill out the required information about your scheduler and task hub to see the dashboard.
409
+
First, follow instructions below to gain access to the [durable task scheduler dashboard](./durable-task-scheduler-dashboard.md) by assigning the required role to your *developer identity (email)*. After granting access, go to `https://dashboard.durabletask.io/` and fill out the required information about your scheduler and task hub to see the dashboard.
410
410
411
411
::: zone pivot="az-cli"
412
412
@@ -471,15 +471,15 @@ First, follow instructions below to gain access to the [DTS dashboard](./durable
471
471
472
472
## Auto scaling in Functions Premium plan
473
473
474
-
For DTS apps on the Functions Premium plan, enable the *Runtime Scale Monitoring* setting to get auto scaling of the app.
474
+
For durable task scheduler apps on the Functions Premium plan, enable the *Runtime Scale Monitoring* setting to get auto scaling of the app.
475
475
476
476
::: zone pivot="az-portal"
477
477
478
478
1. In the portal overview of your function app, navigate to **Settings** > **Configuration**.
479
479
480
480
1. Under the **Function runtime settings** tab, turn on **Runtime Scale Monitoring**.
481
481
482
-
:::image type="content" source="media/develop-with-durable-task-scheduler/runtime-scale-monitoring.png" alt-text="Screenshot of searching for Durable Task Scheduler in the portal.":::
482
+
:::image type="content" source="media/develop-with-durable-task-scheduler/runtime-scale-monitoring.png" alt-text="Screenshot of searching for durable task scheduler in the portal.":::
483
483
484
484
::: zone-end
485
485
@@ -494,4 +494,4 @@ Run the following command:
494
494
::: zone-end
495
495
## Next steps
496
496
497
-
Try out the [Durable Functions quickstart sample](quickstart-durable-task-scheduler.md).
497
+
Try out the [durable functions quickstart sample](quickstart-durable-task-scheduler.md).
Copy file name to clipboardExpand all lines: articles/azure-functions/durable/durable-task-scheduler/dts-dedicated-sku.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,14 @@
1
1
---
2
-
title: Use the Dedicated SKU for Durable Task Scheduler (preview)
3
-
description: Learn about how the Dedicated SKU in DTS.
2
+
title: Use the Dedicated SKU for Azure Functions durable task scheduler (preview)
3
+
description: Learn about how the Dedicated SKU in Azure Functions durable task scheduler.
4
4
ms.topic: conceptual
5
-
ms.date: 03/13/2025
5
+
ms.date: 03/14/2025
6
6
ms.author: azfuncdf
7
7
author: lilyjma
8
8
ms.subservice: durable
9
9
---
10
10
11
-
# Use the Dedicated SKU for Durable Task Scheduler (preview)
11
+
# Use the Dedicated SKU for Azure Functions durable task scheduler (preview)
12
12
13
13
Durable task scheduler currently offers the Dedicated SKU only. In this article, you'll learn:
14
14
- What the Dedicated SKU provides
@@ -17,10 +17,10 @@ Durable task scheduler currently offers the Dedicated SKU only. In this article,
17
17
18
18
## Dedicated SKU concepts
19
19
20
-
You're billed based on the number of "Capacity Units (CUs)" purchased. In the Durable Task Scheduler context:
20
+
You're billed based on the number of "Capacity Units (CUs)" purchased. In the durable task scheduler context:
21
21
22
-
-**A Capacity Unit (CU)** is a measure of the resources allocated to your Durable Task Scheduler. Each CU represents a preallocated amount of CPU, memory, and storage resources. A single CU guarantees the dispatch of a number of *work items* and provides a defined amount of storage. If extra performance and/or storage is needed, more CUs can be purchased.
23
-
-**Work item** is a message dispatched by the Durable Task Scheduler to an application, triggering the execution of orchestrator, activity, or entity functions. The number of work items that can be dispatched per second is determined by the CUs allocated to the Durable Task Scheduler.
22
+
-**A Capacity Unit (CU)** is a measure of the resources allocated to your scheduler resource. Each CU represents a preallocated amount of CPU, memory, and storage resources. A single CU guarantees the dispatch of a number of *work items* and provides a defined amount of storage. If extra performance and/or storage is needed, more CUs can be purchased.
23
+
-**Work item** is a message dispatched by the durable task scheduler to an application, triggering the execution of orchestrator, activity, or entity functions. The number of work items that can be dispatched per second is determined by the CUs allocated to the scheduler.
24
24
25
25
The following table explains the minimum cost and features provided with each CU.
26
26
@@ -35,14 +35,14 @@ Find the price of a capacity unit on the [Azure Functions pricing page](https://
35
35
## Determining the number of Capacity Units needed
36
36
37
37
> [!NOTE]
38
-
> DTS supports purchasing only **one capacity unit** at the moment.
38
+
> Durable task scheduler supports purchasing only **one capacity unit** at the moment.
39
39
40
40
To determine whether one unit is sufficient for your workload, follow these steps:
41
41
42
42
1.**Understand how to identify the number of work items per orchestration**
43
43
- Starting an orchestration consumes a single work item.
44
44
- Each schedule of an activity run consumes another work item.
45
-
- Each response sent back to the Durable Task Scheduler consumes another work item.
45
+
- Each response sent back to the durable task scheduler consumes another work item.
46
46
47
47
1.**Estimate monthly orchestrations**
48
48
Calculate the total number of orchestrations you need to run per month.
@@ -60,4 +60,4 @@ For example, if you run 100 million orchestrations per month and each orchestrat
60
60
61
61
## Next steps
62
62
63
-
Try out the [Durable Functions quickstart sample](quickstart-durable-task-scheduler.md).
63
+
Try out the [durable functions quickstart sample](quickstart-durable-task-scheduler.md).
Copy file name to clipboardExpand all lines: articles/azure-functions/durable/durable-task-scheduler/durable-task-scheduler-dashboard.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,13 +1,13 @@
1
1
---
2
-
title: Debug and manage orchestrations using the Durable Task Scheduler dashboard (preview)
3
-
description: Learn how to debug and manage your orchestrations using the Durable Task Scheduler.
2
+
title: Debug and manage orchestrations using the Azure Functions durable task scheduler dashboard (preview)
3
+
description: Learn how to debug and manage your orchestrations using the Azure Functions durable task scheduler.
4
4
ms.topic: conceptual
5
5
ms.date: 01/24/2025
6
6
---
7
7
8
-
# Debug and manage orchestrations using the Durable Task Scheduler dashboard (preview)
8
+
# Debug and manage orchestrations using the Azure Functions durable task scheduler dashboard (preview)
9
9
10
-
Observe, manage, and debug your task hub or scheduler's orchestations effectively using the Durable Task Scheduler dashboard. Once you [assign the *Durable Task Data Contributor* role to your developer identity](./develop-with-durable-task-scheduler.md#accessing-dts-dashboard), you can access the dashboard via either:
10
+
Observe, manage, and debug your task hub or scheduler's orchestations effectively using the durable task scheduler dashboard. Once you [assign the *Durable Task Data Contributor* role to your developer identity](./develop-with-durable-task-scheduler.md#accessing-dts-dashboard), you can access the dashboard via either:
11
11
- The task hub's dashboard endpoint URL in the Azure portal
12
12
- Navigate to `https://dashboard.durabletask.io/` and your task endpoint to connect to it.
13
13
@@ -58,4 +58,4 @@ Dashboard access is secured through [integration with Azure Role-Based Access Co
58
58
59
59
## Next steps
60
60
61
-
[Try out the quickstart to see the Durable Task Scheduler dashboard in action](./quickstart-durable-task-scheduler.md)
61
+
[Try out the quickstart to see the durable task scheduler dashboard in action](./quickstart-durable-task-scheduler.md)
0 commit comments