次の方法で共有


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

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

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

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

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

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

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

[前提条件]

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

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

Durable Task Scheduler ダッシュボードにアクセスするには、開発者 ID (電子メール) に必要なロールを割り当てます。

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

    assignee=$(az ad user show --id "someone@microsoft.com" --query "id" --output tsv)
    
  2. スコープを設定します。 スケジューラ スコープにアクセス権を付与すると、そのスケジューラ 内のすべての タスク ハブにアクセスできるようになります。

    タスク ハブ

    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"
    
  3. アクセス権を付与します。 次のコマンドを実行して、ロールの割り当てを作成し、アクセス権を付与します。

    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"
    }
    
  4. アクセス権を付与したら、 https://dashboard.durabletask.io/ に移動し、スケジューラとタスク ハブに関する必要な情報を入力してダッシュボードを表示します。

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

  1. ポータルで持続的タスク スケジューラ リソースに移動します。

  2. タスク ハブ名をクリックします。

  3. 左側のメニューで [アクセス制御 (IAM)] を選択します。

  4. [ 追加] をクリックしてロールの割り当てを追加します。

    ポータルの [アクセス制御] ウィンドウでのロールの割り当ての追加のスクリーンショット。

  5. [永続タスク データ共同作成者] を検索して選択します。 [次へ] をクリックします。

    ポータルで Durable Task Data Contributor ロールの割り当てを選択するスクリーンショット。

  6. [ メンバー ] タブの [ アクセスの割り当て] で、[ ユーザー、グループ、またはサービス プリンシパル] を選択します。

  7. [メンバー] の場合は、[+ メンバーの選択] をクリックします。

  8. [ メンバーの選択 ] ウィンドウで、自分の名前または電子メールを検索します。

    ポータルでユーザー割り当てマネージド ID の種類を選択するスクリーンショット。

  9. メールを選び、[ 選択 ] ボタンをクリックします。

  10. [ 確認と割り当て ] をクリックしてロールの割り当てを完了します。

  11. ロールが割り当てられたら、タスク ハブ リソースの左側のメニューで [ 概要 ] をクリックし、上部の [要点 ] セクションにあるダッシュボードの URL に移動します。

オーケストレーションの進行状況と実行履歴を監視する

ダッシュボードを使用すると、オーケストレーションの進行状況を監視し、実行履歴を確認できます。 状態やタイムスタンプなどのオーケストレーション メタデータでフィルター処理することもできます。

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

オーケストレーションの入力と出力を表示します。

オーケストレーション履歴と状態の入力と出力が一覧表示されているダッシュボードのスクリーンショット。

オーケストレーション実行の詳細ビュー

オーケストレーション インスタンスをドリルダウンして、実行の詳細とアクティビティの進行状況を表示できます。 このビューは、問題を診断したり、オーケストレーションの状態を把握したりするのに役立ちます。

次の図では、オーケストレーション実行の タイムライン ビューです。 この "ProcessDocument" オーケストレーションでは、"WriteDoc" アクティビティが再試行の間に 5 秒で 3 回 (失敗) 再試行されました。

オーケストレーションの実行タイムラインを示すダッシュボードのスクリーンショット。

オーケストレーション内のアクティビティの入力と出力を表示することもできます。

アクティビティの入力と出力を示すダッシュボードのスクリーンショット。

オーケストレーション実行シーケンスのその他のビュー

履歴ビューには、詳細なイベント シーケンス、タイムスタンプ、ペイロードが表示されます。

オーケストレーション インスタンスの詳細を示すダッシュボードのスクリーンショット。

シーケンス ビューには、イベント シーケンスを視覚化する別の方法があります。

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

オーケストレーション管理

ダッシュボードには、開始、一時停止、再開、終了など、オンデマンドでオーケストレーションを管理するための機能が含まれています。

オーケストレーションの管理に使用するボタンを示すダッシュボードのスクリーンショット。

次のステップ

Durable Functions 用の永続タスク スケジューラーの場合:

Durable Task SDK 用の永続タスク スケジューラーの場合: