Durable Task Scheduler ダッシュボードを使用してオーケストレーションをデバッグおよび管理する

Durable Task Scheduler ダッシュボードを使用すると、実行中のオーケストレーションの監視、実行履歴とアクティビティの入力/出力の検査、オーケストレーションのライフサイクルの管理 (一時停止、再開、終了) をすべてブラウザーから行うことができます。

ダッシュボードは、次の 2 つの環境で使用できます。

Environment	URL	認証
ローカルエミュレーター	`http://localhost:8082`	必要なし
Azure	`https://dashboard.durabletask.io/?endpoint=<SCHEDULER_ENDPOINT>&taskhub=<TASK_HUB_NAME>`	Durable Task データ共同作成者ロールが必要です。

エミュレーターの詳細については、ローカル開発用のエミュレーターを参照してください。

この記事では、次の方法について説明します。

ダッシュボードにローカルまたはAzureでアクセスします。
Durable Task データ共同作成者ロールを開発者の ID に割り当てます。
オーケストレーションの状態を監視し、インスタンスをフィルター処理し、実行履歴を検査します。
オーケストレーションの管理 (一時停止、再開、終了、イベントをトリガーする)。

前提条件

開始する前に、次の手順を実行します。

ダッシュボードにローカルでアクセスする

Durable Task Scheduler エミュレーターを使用している場合は、次のダッシュボードを使用できます。

http://localhost:8082

ローカル開発に認証またはロールの割り当ては必要ありません。

ダッシュボードアクセスロールの割り当て (Azure)

Azureホスト型スケジューラのダッシュボードにアクセスするには、Durable Task Data Contributor ロールを開発者 ID (電子メール) に割り当てます。

担当者を開発者 ID に設定します。

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"

Scheduler

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"

想定される出力

次の出力例は、 スケジューラ レベルで Durable Task Data Contributor ロールが割り当てられた開発者 ID を示しています。

{
  "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/ に移動し、接続フォームにスケジューラエンドポイントとタスクハブ名を入力します。

注

次の手順は、特定のタスクハブを対象としたロールの割り当てを示しています。スケジューラ 内のすべての タスクハブにアクセスする必要がある場合は、スケジューラレベルで割り当てを実行します。

ポータルで Durable Task Scheduler リソースに移動します。
タスクハブ名をクリックします。
左側のメニューで [アクセス制御 (IAM)] を選択します。
[ 追加] をクリックしてロールの割り当てを追加します。
[永続タスクデータ共同作成者] を検索して選択します。 [次へ] をクリックします。
[ メンバー ] タブの [ アクセスの割り当て] で、[ ユーザー、グループ、またはサービスプリンシパル] を選択します。
[メンバー] の場合は、[+ メンバーの選択] をクリックします。
[ メンバーの選択 ] ウィンドウで、自分の名前または電子メールを検索します。
メールを選び、[ 選択 ] ボタンをクリックします。
[ 確認と割り当て ] をクリックしてロールの割り当てを完了します。
ロールが割り当てられたら、タスクハブリソースの左側のメニューで [ 概要 ] をクリックし、上部の [要点 ] セクションにあるダッシュボードの URL に移動します。