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 に移動します。

ダッシュボードを使用してタスクハブを監視する

ダッシュボードを使用すると、オーケストレーションの進行状況を監視し、実行履歴を確認できます。ダッシュボードのホームページから、タスクハブのオーケストレーション、エンティティ、スケジュール、worker とメトリック、AI エージェント (現在プレビュー段階) を見つけることができます。

[オーケストレーションの概要] ウィンドウ

オーケストレーションを表示するには、タスクハブ名またはサイドメニューの Orchestrations をクリックします。

タスクハブ、オーケストレーション履歴、エンティティ、スケジュール、worker、メトリック、AI エージェントへのリンクを含むダッシュボードのホームページのスクリーンショット。

[オーケストレーションの概要] ウィンドウでは、次のことができます。

オーケストレーションインスタンスの一覧を確認します。
検索バーまたはフィルターを使用してオーケストレーションを絞り込みます。
新しいオーケストレーションを作成します。
共有可能なリンクをダッシュボードにコピーします。
オーケストレーションリストの自動更新間隔を設定します。

オーケストレーションを一覧表示するダッシュボードのスクリーンショット。

オーケストレーション情報には、次の既定の列が表示されます。

カテゴリ	Description
インスタンス ID	一意の ID で特定のオーケストレーションインスタンスを検索します。
名前	オーケストレーションの種類名でフィルター処理します。
地位	ランタイムの状態 (実行中、完了、失敗、終了、保留中、中断) でフィルター処理します。
タグ	オーケストレーションインスタンスに適用されるタグでフィルター処理します。
作成済	オーケストレーションが作成された日時。

オーケストレーションリストで登録名の代わりにカスタムディスプレイ名を表示し、実行詳細を表示するには、オーケストレーション開始時によく知られた durabletask.displayName タグを使用してください。詳細については、「カスタム表示名の設定」をご覧ください。

オーケストレーションリストは、次の条件を使用してフィルター処理できます。

フィルターオプションを含むオーケストレーション履歴と状態を一覧表示するダッシュボードのスクリーンショット。

カテゴリ	Description
オーケストレーション名	オーケストレーションの種類名でフィルター処理します。
ランタイムの状態	ランタイムの状態 (実行中、完了、失敗、終了、保留中、中断) でフィルター処理します。
タグフィルター	タグキーまたは値でオーケストレーションを検索します。
作成日 (開始)/作成日 (終了)	結果を時間枠に絞り込みます。

次の方法でオーケストレーションリストの更新をトリガーします。

手動更新の更新アイコンをクリックします。
[自動] を切り替え、[間隔] を選択すると、一覧が自動的に更新されます。

新しいオーケストレーションを作成する

Durable Task Scheduler ダッシュボードから新しいオーケストレーションを作成できます。

[ オーケストレーション の概要] ウィンドウで、[ + 新しいオーケストレーション] をクリックします。

[新しいオーケストレーション] フォームに情報を入力します。

$[Create new orchestration]$新しいオーケストレーションの作成$ フォームのスクリーンショット。$

フィールド	Description
オーケストレーション名	ドロップダウンからオーケストレーションを選択するか、カスタムオーケストレーション名を入力します。
インスタンス ID	Optional. インスタンス ID は自動生成されます。自分で作成するか自動生成させるかにかかわらず、インスタンス ID は ASCII 形式です。
バージョン	Optional. 該当するバージョン番号を入力します。
入力	Optional. JSON 形式で入力します。
開始予定	Optional. オーケストレーションの開始日時を選択します。
タグ	Optional. オーケストレーションに関連付けられているキータグまたは値タグを入力します。

Create をクリックしてください。

一覧で新しいオーケストレーションを確認できます。

オーケストレーションの詳細

オーケストレーションインスタンスをクリックして問題を診断するか、オーケストレーションの状態を把握します。

[タイムライン]、[履歴]、[フロー] タブを使用して、実行の詳細とアクティビティの進行状況を表示します。既定では、[タイムライン] タブが開いています。

[タイムライン] タブには、実行中のオーケストレーションの間隔が表示されます。

アクティビティを選択して、その入力と出力を表示します。
[ 履歴 ] タブには、タイムスタンプを含むオーケストレーション内のすべてのイベントのフィードが表示されます。
[ フロー ] タブでは、オーケストレーションの実行フローが視覚的にプロットされます。

[表示] をクリックして、アクティビティの入力と出力を表示することもできます。