Freigeben über

Debuggen und Verwalten von Orchestrierungen mithilfe des Azure Functions Durable Task Scheduler-Dashboards

Beobachten, verwalten und debuggen Sie die Aufgabenhub- oder Planerorchestrierungen mithilfe des Dashboards für den langlebigen Aufgabenplaner. Das Dashboard ist verfügbar, wenn Sie den Emulator für dauerhafte Aufgabenplanung lokal ausführen oder eine Schedulerressource in Azure erstellen.

Das lokale Ausführen des Emulators erfordert keine Authentifizierung.

Um eine Zeitplandienstressource in Azure zu erstellen, ist die Zuweisung der Rolle Durable Task Data Contributor zu Ihrer Identität erforderlich. Sie können dann über eine der folgenden Aktionen auf das Dashboard zugreifen:

  • Die Dashboard-Endpunkt-URL des Aufgabenhubs im Azure-Portal
  • Navigieren Sie zu https://dashboard.durabletask.io/, in Verbindung mit Ihrem Aufgabenhub-Endpunkt.

In diesem Artikel erfahren Sie, wie Sie:

  • Weisen Sie Ihrer Entwickleridentität eine der Rollen für dauerhafte Aufgaben zu.
  • Greifen Sie auf das Dashboard für dauerhafte Aufgabenplanung zu.
  • Anzeigen des Orchestrierungsstatus und des Verlaufs über das Dashboard des langlebigen Aufgabenplaners

Voraussetzungen

Bevor Sie beginnen:

Zugreifen auf das Dashboard für dauerhafte Aufgabenplanung

Weisen Sie Ihrer Entwickleridentität (E-Mail) die erforderliche Rolle zu, um Zugriff auf das Dashboard "Durable Task Scheduler" zu erhalten.

  1. Legen Sie als zugewiesene Person Ihre Entwickleridentität fest.

    assignee=$(az ad user show --id "someone@microsoft.com" --query "id" --output tsv)

  2. Legen Sie den Bereich fest. Das Gewähren des Zugriffs auf den Planerbereich ermöglicht den Zugriff auf alle Aufgabenhubs in diesem Planer.

    Aufgabenhub

    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"

  3. Gewähren des Zugriffs. Führen Sie den folgenden Befehl aus, um die Rollenzuweisung zu erstellen und Zugriff zu gewähren.

    az role assignment create \
  --assignee "$assignee" \
  --role "Durable Task Data Contributor" \
  --scope "$scope"

    Erwartete Ausgabe

    Das folgende Ausgabebeispiel zeigt eine Entwickleridentität, der die Rolle „Mitwirkender an langlebigen Aufgabendaten“ auf Planerebene zugewiesen ist:

    {
  "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. Nachdem Sie Zugriff gewährt haben, wechseln Sie zu https://dashboard.durabletask.io/, und füllen Sie die erforderlichen Informationen zu Ihrem Planer und Aufgabenhub aus, um das Dashboard anzuzeigen.

Hinweis

Die folgende Anweisung zeigt eine Rollenzuweisung, die auf einen bestimmten Aufgabenhub festgelegt ist. Wenn Sie Zugriff auf alle Aufgabenhubs in einem Planer benötigen, führen Sie die Zuordnung auf der Planerebene aus.

  1. Navigieren Sie im Portal zur Ressource "Durable Task Scheduler".

  2. Wählen Sie einen Aufgabenhubnamen aus.

  3. Wählen Sie im linken Menü Zugriffssteuerung (IAM) aus.

  4. Klicken Sie auf "Hinzufügen" , um eine Rollenzuweisung hinzuzufügen.

    Screenshot des Hinzufügens der Rollenzuweisung im Bereich

  5. Suchen Sie Mitwirkender an langlebigen Aufgabendaten, und wählen Sie die Rolle aus. Klicke auf Weiter.

    Screenshot: Auswählen der Rollenzuweisung „Mitwirkender an langlebigen Aufgabendaten“ im Portal

  6. Wählen Sie auf der Registerkarte " Mitglieder " für "Zugriff zuweisen"die Option "Benutzer", "Gruppe" oder "Dienstprinzipal" aus.

  7. Klicken Sie für Mitglieder auf +Mitglieder auswählen.

  8. Suchen Sie im Bereich "Mitglieder auswählen " nach Ihrem Namen oder Ihrer E-Mail:

    Screenshot der Auswahl des vom Benutzer zugewiesenen verwalteten Identitätstyps im Portal.

  9. Wählen Sie Ihre E-Mail aus, und klicken Sie auf die Schaltfläche " Auswählen ".

  10. Klicken Sie auf "Überprüfen" und "Zuweisen ", um die Zuweisung der Rolle abzuschließen.

  11. Nachdem die Rolle zugewiesen wurde, klicken Sie im linken Menü der Task Hub-Ressource auf "Übersicht ", und navigieren Sie zur Dashboard-URL im oberen Essentials-Abschnitt .

Überwachen des Fortschritts der Orchestrierung und des Ausführungsverlaufs

Mit dem Dashboard können Sie den Orchestrierungsstatus überwachen und den Ausführungsverlauf überprüfen. Sie können auch nach Orchestrierungsmetadaten wie Zustands- und Zeitstempeln filtern.

Screenshot des Dashboards mit einer Auflistung des Orchestrierungsverlaufs und -status.

Anzeigen von Orchestrierungseingaben und -ausgaben:

Screenshot des Dashboards, in dem der Orchestrierungsverlauf und Statuseingaben und -ausgaben aufgeführt sind.

Detaillierte Ansicht der Orchestrierungsausführung

Sie können einen Drilldown für Orchestrierungsinstanzen ausführen, um Ausführungsdetails und Aktivitätsstatus anzuzeigen. Diese Ansicht hilft Ihnen, Probleme zu diagnostizieren oder Einblicke in den Status einer Orchestrierung zu erhalten.

In der folgenden Abbildung wird die Zeitachsenansicht einer Orchestrierungsausführung angezeigt. In dieser "ProcessDocument"-Orchestrierung wurde die "WriteDoc"-Aktivität dreimal (erfolglos) mit jeweils fünf Sekunden zwischen den Wiederholungen neu versucht.

Screenshot des Dashboards mit dem Ausführungszeitplan der Orchestrierung.

Sie können auch Eingaben und Ausgaben von Aktivitäten in einer Orchestrierung anzeigen:

Screenshot des Dashboards mit Aktivitätseingaben und Ausgaben.

Andere Ansichten der Orchestrierungsausführungssequenz

In der Verlaufsansicht werden detaillierte Ereignissequenzen, Zeitstempel und Nutzlast angezeigt:

Screenshot des Dashboards mit Details zur Orchestrierungsinstanz.

Die Sequenzansicht bietet eine weitere Möglichkeit zum Visualisieren der Ereignissequenz:

Screenshot des Dashboards mit der Orchestrierungssequenz-Ansicht.

Orchestrierungsmanagement

Das Dashboard enthält Features zum Verwalten von Orchestrierungen bei Bedarf, z. B. Starten, Anhalten, Fortsetzen und Beenden.

Screenshot des Dashboards mit den Schaltflächen, die Sie zum Verwalten der Orchestrierung verwenden.

Nächste Schritte

Für den langlebigen Aufgabenplaner für Durable Functions:

Für den langlebigen Aufgabenplaner für die Durable Task SDKs:

  • Last updated on