使用 Durable Task Scheduler 儀表板偵錯及管理協調流程

Durable Task Scheduler 儀表板讓你能從瀏覽器觀察正在執行的編排、檢查執行歷史和活動輸入/輸出，並管理編排生命週期（暫停、繼續、終止）。

儀表板可供使用於兩種環境：

Environment	URL	認證
本地模擬器	`http://localhost:8082`	不需要
Azure	`https://dashboard.durabletask.io/?endpoint=<SCHEDULER_ENDPOINT>&taskhub=<TASK_HUB_NAME>`	需要具備 Durable Task 資料貢獻者角色

欲了解更多模擬器資訊，請參閱本地開發模擬器。

在本文中，您將學會如何：

可本地或在 Azure 上存取儀表板。
將 Durable Task Data Contributor 角色指派給您的開發人員身分。
監控編排狀態、過濾實例並檢查執行歷史。
管理協調流程 (暫停、繼續、終止、引發事件)。

先決條件

在開始之前：

本地存取儀表板

如果你正在使用 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.westus2.durabletask.io），並將 <TASK_HUB_NAME> 替換為你的任務中心名稱。

或者，瀏覽至 https://dashboard.durabletask.io/，並在連線表單中輸入您的排程器端點和工作中樞名稱。

備註

下列指示顯示限定於特定工作中樞的角色指派。如果您需要存取排程器 中的所有 工作中樞，請在排程器層級上執行工作分派。

請前往入口網站中的「持久任務排程器」資源。
按一下工作中樞名稱。
在左側功能表中，選取 [存取控制 (IAM)]。
按兩下 [新增 ] 以新增角色指派。
搜尋並選取 [長期工作資料參與者]。按一下「下一步」。
在 [成員] 索引標籤的 [存取權指派對象] 下，選取 [使用者、群組或服務主體]。
針對 [成員]，按一下 [+ 選取成員]。
在 [ 選取成員 ] 窗格中，搜尋您的名稱或電子郵件：
挑選您的電子郵件，然後按兩下 [ 選取 ] 按鈕。
按兩下 [檢閱 + 指派 ] 以完成指派角色。
指派角色之後，按一下工作中樞資源左側功能表上的 [概觀]，然後瀏覽至位於頂端 [基本資訊] 區段的儀表板 URL。

透過儀表板監控你的任務中心

儀錶板可讓您監視協調流程進度並檢閱執行歷程記錄。從儀表板主頁中，您可以找到工作中樞中的流程協調、實體、排程、背景工作程式與指標，以及 AI Agent (目前為預覽版)。

編排總覽面板

按一下工作中樞名稱，或側邊選單中的，即可檢視流程協調。

儀表板首頁的截圖，包含任務中心、編排歷史、實體、排程、工作者、指標和 AI 代理的連結。

在編排總覽窗格中，你可以：

檢閱一份流程協調執行個體清單。
使用搜尋列或篩選條件縮小流程協調的範圍。
建立新的協調流程。
複製一個可分享的連結到儀表板。
設定編排清單的自動刷新間隔。

列出協調流程的控制台螢幕擷圖。

編排資訊以以下預設欄位呈現。

類別	Description
實例識別碼	依其唯一識別碼搜尋特定的流程協調執行個體。
名稱	依照配音類型名稱篩選。
現況	依執行狀態篩選（執行中、完成、失敗、終止、待處理、暫停）。
標籤	依據套用至編排實例的標籤進行篩選。
已建立	編曲創作的日期和時間。

若要在編排清單和執行詳細資料中顯示自訂顯示名稱，而不是註冊名稱，請在啟動編排時使用已知的 durabletask.displayName 標籤。欲了解更多資訊，請參閱「設定自訂顯示名稱」。

你可以用以下條件篩選編排清單。

儀表板截圖，列出了編排歷史和狀態，並有篩選選項。

類別	Description
編曲名稱	依照配音類型名稱篩選。
運行狀態	依執行狀態篩選（執行中、完成、失敗、終止、待處理、暫停）。
標籤過濾器	依標籤鍵或值搜尋編排。
建立自/建立至	將結果縮小到時間範圍。

透過以下方式觸發編曲清單的刷新：

點擊重新整理圖示進行手動刷新。
切換自動並選擇間隔，即可自動刷新清單。

創造新的編曲

你可以在 Durable Task Scheduler 儀表板中建立新的協調流程。

從編曲總覽窗格點選 + 新編曲。

請填寫 新編排 表格中的相關資訊。

「建立新協調流程」表單的截圖。

Field	Description
流程協調名稱	從下拉選單選擇一個配器，或輸入自訂的配器名稱。
實例識別碼	選擇性。實例 ID 是自動生成的。不管你是自己建立實例 ID 還是讓它自動產生，實例 ID 都是 ASCII 格式。
版本	選擇性。輸入適用的版本號。
輸入	選擇性。以 JSON 格式輸入內容。
預定開始	選擇性。選擇編曲的開始日期與時間。
標籤	選擇性。輸入與編排相關的金鑰和/或值標籤。