使用 Durable Task Scheduler 仪表板调试和管理业务流程

Durable Task Scheduler 仪表板允许你观察正在运行的业务流程、检查执行历史记录和活动输入/输出，以及管理业务流程生命周期（暂停、恢复、终止）（全部来自浏览器）。

仪表板在两个环境中可用：

环境	URL	身份验证
本地模拟器	`http://localhost:8082`	不需要
Azure	`https://dashboard.durabletask.io/?endpoint=<SCHEDULER_ENDPOINT>&taskhub=<TASK_HUB_NAME>`	需要持久任务数据参与者角色

有关模拟器的详细信息，请参阅模拟器进行本地开发。

在这篇文章中，你将学会如何：

在本地或Azure上访问仪表板。
将持久任务数据参与者角色分配给开发人员标识。
监视业务流程状态、筛选实例和检查执行历史记录。
管理业务流程（暂停、恢复、终止、引发事件）。

先决条件

开始之前：

在本地访问仪表板

如果使用 Durable Task Scheduler 模拟器，仪表板可以在以下地址访问：

http://localhost:8082

本地开发不需要身份验证或角色分配。

分配仪表板访问角色（Azure）

若要访问 Azure 托管的计划程序仪表板，请将 Durable Task Data Contributor 角色分配给您的开发人员身份（电子邮件）。

将被分配者设置为开发人员标识。

assignee=$(az ad user show --id "someone@microsoft.com" --query "id" --output tsv)

设置范围。授予对计划程序范围的访问权限可授予对该计划程序 中的所有 任务中心的访问权限。

任务中心

scope="/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/SCHEDULER_NAME/taskHubs/TASK_HUB_NAME"

调度器

scope="/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/SCHEDULER_NAME"

授予访问权限。运行以下命令以创建角色分配并授予访问权限。

az role assignment create \
  --assignee "$assignee" \
  --role "Durable Task Data Contributor" \
  --scope "$scope"

预期输出

以下输出示例显示了在计划程序级别上分配有持久任务数据参与者角色的开发人员标识：

{
  "condition": null,
  "conditionVersion": null,
  "createdBy": "YOUR_DEVELOPER_CREDENTIAL_ID",
  "createdOn": "2024-12-20T01:36:45.022356+00:00",
  "delegatedManagedIdentityResourceId": null,
  "description": null,
  "id": "/subscriptions/YOUR_SUBSCRIPTION_ID/resourceGroups/YOUR_RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/YOUR_DTS_NAME/providers/Microsoft.Authorization/roleAssignments/ROLE_ASSIGNMENT_ID",
  "name": "ROLE_ASSIGNMENT_ID",
  "principalId": "YOUR_DEVELOPER_CREDENTIAL_ID",
  "principalName": "YOUR_EMAIL",
  "principalType": "User",
  "resourceGroup": "YOUR_RESOURCE_GROUP",
  "roleDefinitionId": "/subscriptions/YOUR_SUBSCRIPTION/providers/Microsoft.Authorization/roleDefinitions/ROLE_DEFINITION_ID",
  "roleDefinitionName": "Durable Task Data Contributor",
  "scope": "/subscriptions/YOUR_SUBSCRIPTION/resourceGroups/YOUR_RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/YOUR_DTS_NAME",
  "type": "Microsoft.Authorization/roleAssignments",
  "updatedBy": "YOUR_DEVELOPER_CREDENTIAL_ID",
  "updatedOn": "2024-12-20T01:36:45.022356+00:00"
}

授予访问权限后，在以下位置打开仪表板：
```
https://dashboard.durabletask.io/?endpoint=<SCHEDULER_ENDPOINT>&taskhub=<TASK_HUB_NAME>
```
将 <SCHEDULER_ENDPOINT> 替换为计划程序的终结点（例如 https://myscheduler.chinanorth3.durabletask.io），并将 <TASK_HUB_NAME> 替换为您的任务中心的名称。

或者，请导航到 https://dashboard.durabletask.io/，然后在连接表单中输入计划程序终结点和任务中心名称。