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

Durable Task Scheduler ダッシュボードを使用して、タスクハブまたはスケジューラのオーケストレーションを監視、管理、デバッグします。ダッシュボードは、ローカルで Durable Task Scheduler エミュレーターを実行するか、Azureにスケジューラリソースを作成するときに使用できます。

エミュレーターをローカルで実行する場合、認証は必要ありません。

Azureでスケジューラリソースを作成するには、Durable Task Data Contributor ロールを ID に割り当必要があります。その後、次のいずれかを使用してダッシュボードにアクセスできます。

Azure ポータルのタスクハブのダッシュボードエンドポイント URL
タスクハブエンドポイントと組み合わせた https://dashboard.durabletask.io/ に移動します。

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

開発者 ID に Durable Task ロールの 1 つを割り当てます。
Durable Task Scheduler ダッシュボードにアクセスします。
Durable Task Scheduler ダッシュボードを使用してオーケストレーションの状態と履歴を表示します。

[前提条件]

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

Durable Task Scheduler ダッシュボードにアクセスする

Durable Task Scheduler ダッシュボードにアクセスするには、開発者 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/ に移動し、スケジューラとタスクハブに関する必要な情報を入力してダッシュボードを表示します。

注

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

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