Share via

Debuggen en beheren van orchestraties met het Azure Functions Durable Task Scheduler-dashboard (preview)

Bekijk, beheer en foutopsporen van de orkestraties van uw taakhub of planner met het Durable Task Scheduler-dashboard. Het dashboard is beschikbaar wanneer u de Durable Task Scheduler-emulator lokaal uitvoert of een scheduler-resource maakt in Azure.

Voor het lokaal uitvoeren van de emulator is geen verificatie vereist.

Voor het maken van een scheduler-resource in Azure moet de rol Durable Task Data Contributor worden toegewezen aan uw identiteit. U hebt vervolgens toegang tot het dashboard via een van de volgende opties:

  • De eindpunt-URL van het dashboard van de taakhub in Azure Portal
  • Navigeer naar https://dashboard.durabletask.io/ gecombineerd met het taakhub-eindpunt.

In dit artikel leert u het volgende:

  • Wijs een van de durable task-rollen toe aan uw ontwikkelaarsidentiteit.
  • Toegang tot het Durable Task Scheduler-dashboard.
  • Bekijk de orchestratiewerkzaamheden en -geschiedenis via het Durable Task Scheduler-dashboard.

Vereiste voorwaarden

Voordat u begint:

Toegang tot het durable Task Scheduler-dashboard

Wijs de vereiste rol toe aan uw ontwikkelaarsidentiteit (e-mail) om toegang te krijgen tot het Durable Task Scheduler-dashboard.

  1. Stel de toegewezen gebruiker in op uw ontwikkelaarsidentiteit.

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

  2. Stel het bereik in. Het verlenen van toegang op het tijdschema-bereik geeft toegang tot alle taakhubs in dat tijdschema.

    Taskcentrum

    scope="/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/SCHEDULER_NAME/taskHubs/TASK_HUB_NAME"

    Planner

    scope="/subscriptions/SUBSCRIPTION_ID/resourceGroups/RESOURCE_GROUP/providers/Microsoft.DurableTask/schedulers/SCHEDULER_NAME"

  3. Toegang verlenen. Voer de volgende opdracht uit om de roltoewijzing te maken en toegang te verlenen.

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

    Verwachte uitvoer

    In het volgende uitvoervoorbeeld ziet u een ontwikkelaarsidentiteit met de rol Durable Task Data Contributor toegewezen op plannerniveau:

    {
  "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. Nadat u toegang hebt verleend, ga naar https://dashboard.durabletask.io/ en vul de vereiste informatie in over uw planner en taakhub om het dashboard te bekijken.

Opmerking

In de volgende instructie ziet u een roltoewijzing die is afgestemd op een specifieke taakhub. Als u toegang nodig hebt tot alle taakhubs in een planner, voert u de toewijzing uit op het niveau van de planner.

  1. Navigeer naar de resource van de herbruikbare taakplanner in het portaal.

  2. Klik op de naam van een taakhub.

  3. Selecteer toegangsbeheer (IAM) in het linkermenu.

  4. Klik op Toevoegen om een roltoewijzing toe te voegen.

    Schermopname van het toevoegen van de roltoewijzing in het deelvenster Toegangsbeheer in de portal.

  5. Zoek en selecteer Inzender voor duurzame taakgegevens. Klik op Volgende.

    Schermopname van het selecteren van de roltoewijzing Duurzame taakgegevensbijdrager in de portal.

  6. Selecteer op het tabblad Leden voor Toegang toewijzen aangebruiker, groep of service-principal.

  7. Klik voor leden op + Leden selecteren.

  8. Zoek in het deelvenster Selecteer leden naar uw naam of e-mailadres.

    Schermopname van het selecteren van het door de gebruiker toegewezen beheerde identiteitstype in de portal.

  9. Kies uw e-mail en klik op de knop Selecteren .

  10. Klik op Controleren en toewijzen om het toewijzen van de rol te voltooien.

  11. Zodra de rol is toegewezen, klikt u op Overzicht in het linkermenu van de taakhubresource en gaat u naar de dashboard-URL in de bovenste sectie Essentials .

Voortgang en uitvoeringsgeschiedenis van orchestration bewaken

Met het dashboard kunt u de voortgang van de indeling controleren en de uitvoeringsgeschiedenis bekijken. U kunt ook filteren op indelingsmetagegevens, zoals status en tijdstempels.

Schermopname van het dashboard dat de orchestratiegeschiedenis en -status weergeeft.

Weergave van orkestratie-invoer en -uitvoer:

Schermopname van de orchestratiegeschiedenis en statusinvoer en -uitvoer van het dashboard.

Gedetailleerde weergave van orkestratie-uitvoering

U kunt orkestratie-instanties gedetailleerd bekijken om uitvoeringsdetails en de voortgang van activiteiten weer te geven. Met deze weergave kunt u problemen diagnosticeren of inzicht krijgen in de status van een orchestratie.

In de volgende afbeelding ziet u de tijdlijnweergave van een orkestratie-uitvoering. In deze "ProcessDocument"-orkestratie werd de activiteit WriteDoc drie keer opnieuw geprobeerd, zonder succes, met vijf seconden pauze tussen de pogingen.

Schermopname van het dashboard met de tijdlijn voor de orkestratie-uitvoering.

U kunt ook invoer en uitvoer van activiteiten in een orchestratie bekijken.

Schermopname van het dashboard met activiteitsinvoer en -uitvoer.

Andere weergaven van de uitvoeringsvolgorde van orkestratie

In de geschiedenisweergave ziet u gedetailleerde gebeurtenissenreeks, tijdstempels en nettolading:

Schermopname van het dashboard met details van de orchestratie-instantie.

De volgordeweergave biedt een andere manier om de gebeurtenisreeks te visualiseren:

Schermopname van het dashboard met de orkestratievolgordeweergave.

Indelingsbeheer

Het dashboard bevat functies voor het beheren van orkestraties naar behoefte, zoals starten, onderbreken, hervatten en beëindigen.

Schermopname van het dashboard met de knoppen die u gebruikt om de orkestratie te beheren.

Volgende stappen

Voor de Durable Task Scheduler voor Durable Functions:

Voor de Durable Task Scheduler van de Durable Task SDK's: