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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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