Foutopsporen en beheren van orkestraties met het Durable Task Scheduler-dashboard

Met het dashboard Durable Task Scheduler kunt u actieve indelingen bekijken, uitvoeringsgeschiedenis en activiteitsinvoer/-uitvoer controleren en de levenscyclus van orchestration beheren (onderbreken, hervatten, beëindigen), allemaal vanuit een browser.

Het dashboard is beschikbaar in twee omgevingen:

Environment URL Authenticatie
Lokale emulator http://localhost:8082 Geen vereist
Azure https://dashboard.durabletask.io/?endpoint=<SCHEDULER_ENDPOINT>&taskhub=<TASK_HUB_NAME> Vereist de rol Bijdrager Duurzame Taakgegevens

Zie Emulator voor lokale ontwikkeling voor meer informatie over de emulator.

In dit artikel leert u het volgende:

  • Open het dashboard lokaal of op Azure.
  • Wijs de rol Gegevensbijdrager voor duurzame taken toe aan uw ontwikkelaarsidentiteit.
  • Controleer de orkestratiestatus, filter instanties en inspecteer de uitvoeringsgeschiedenis.
  • Orchestraties beheren (onderbreken, hervatten, beëindigen, gebeurtenissen oproepen).

Vereiste voorwaarden

Voordat u begint:

Het dashboard lokaal openen

Als u de Durable Task Scheduler-emulator gebruikt, is het dashboard beschikbaar op:

http://localhost:8082

Er is geen verificatie of roltoewijzing nodig voor lokale ontwikkeling.

Dashboardtoegangsrollen toewijzen (Azure)

Als u toegang wilt krijgen tot het dashboard voor een Azure-hostende scheduler, wijst u de rol Urable Task Data Contributor toe aan uw ontwikkelaarsidentiteit (e-mail).

  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, opent u het dashboard op:

    https://dashboard.durabletask.io/?endpoint=<SCHEDULER_ENDPOINT>&taskhub=<TASK_HUB_NAME>

    Vervang <SCHEDULER_ENDPOINT> door het eindpunt van uw planner (bijvoorbeeld https://myscheduler.westus2.durabletask.io) en <TASK_HUB_NAME> door de naam van uw taakhub.

    Navigeer naar https://dashboard.durabletask.io/ en voer het plannereindpunt en de naam van de taakhub in het verbindingsformulier in.

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 Durable Task Scheduler-resource in de portal.

  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 een roltoewijzing in het deelvenster Access Control 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 .

Uw taakhub bewaken via het dashboard

Met het dashboard kunt u de voortgang van de indeling controleren en de uitvoeringsgeschiedenis bekijken. Op de startpagina van het dashboard vindt u de indelingen, entiteiten, planningen, werkrollen en metrische gegevens van uw taakhub en AI-agents (momenteel in preview).

Overzichtsvenster voor orchestraties

Bekijk orchestraties door te klikken op de naam van de taakhub of op Orchestrations in het zijmenu.

Schermopname van de startpagina van het dashboard met koppelingen naar taakhubs, indelingsgeschiedenis, entiteiten, planningen, werkrollen, metrische gegevens en AI-agents.

Vanuit het overzichtsvenster Orchestrations kunt u het volgende doen:

  • Controleer een lijst met orkestratie-instanties.
  • Verfijn de orchestraties via de zoekbalk of filters.
  • Maak een nieuwe orchestratie.
  • Kopieer een deelbare koppeling naar het dashboard.
  • Stel de automatische vernieuwingsintervallen van de orchestratielijst in.

Schermafbeelding van het dashboard met een lijst van orchestraties.

Orkestratiegegevens worden weergegeven met de volgende standaardkolommen.

Categorie Description
Instantie-ID Zoek naar een specifiek orchestratie-exemplaar aan de hand van de unieke ID.
Naam Filteren op de naam van het orchestratieype.
Status Filteren op runtimestatus (actief, voltooid, mislukt, beëindigd, in behandeling, onderbroken).
Tags Filteren op de tags die op het orchestratie-exemplaar zijn toegepast.
Gemaakt Datum en tijd waarop de orchestratie is gemaakt.

U kunt de orkestratielijst filteren aan de hand van de volgende criteria.

Schermopname van het dashboard waarop de orkestratiegeschiedenis en -status worden weergegeven met filteropties.

Categorie Description
Orkestratienaam Filteren op de naam van het orchestratietype.
Status tijdens uitvoering Filteren op runtimestatus (actief, voltooid, mislukt, beëindigd, in behandeling, onderbroken).
Tagfilter Zoek naar orchestraties op tagsleutel or waarde.
Gemaakt van/Gemaakt naar Besmalen resultaten tot een tijdvenster.

Start een vernieuwing van de orchestratielijst door:

  • Klik op het vernieuwingspictogram voor een handmatige vernieuwing.

  • Schakel Automatisch in en selecteer interval om de lijst automatisch te vernieuwen.

    Schermafbeelding van de schakelaar voor automatisch vernieuwen en het pictogram voor handmatig vernieuwen.

Een nieuwe orkestratie maken

U kunt een nieuwe indeling maken op basis van het Durable Task Scheduler-dashboard.

  1. Klik in het overzichtspaneel Orchestrations op + New Orchestration.

  2. Vul de gegevens in het formulier New Orchestration in.

    Schermopname van het formulier Nieuwe orchestratie maken.

    Veld Description
    Orchestratienaam Selecteer een orchestratie in de vervolgkeuzelijst of typ een aangepaste orchestratienaam.
    Instantie-ID Optional. Instantie-id's worden automatisch gegenereerd. Of u er nu zelf een maakt of er automatisch een laat aanmaken, instance-ID’s zijn in ASCII-indeling.
    Versie Optional. Voer het toepasselijke versienummer in.
    Invoer Optional. Voer invoer in JSON-indeling in.
    Geplande start Optional. Selecteer de startdatum en -tijd voor de orkestratie.
    Tags Optional. Voer sleutel- en/of waardetags in die aan de orkestratie zijn gekoppeld.

  3. Klik op Create.

    U kunt uw nieuwe orkestratie in de lijst zien.

Orkestratiedetails

Klik op een orkestratie-instantie om problemen te diagnosticeren of inzicht te krijgen in de status van een orkestratie.

Gebruik de tabbladen Tijdlijn, Geschiedenis en Stroom om de uitvoeringsdetails en de voortgang van de activiteit weer te geven. Het tabblad Tijdlijn is standaard geopend.

  • Op het tabblad Tijdlijn worden de intervallen van een lopende orchestratie weergegeven.

    Schermafbeelding van de tijdlijn voor de orchestratie-uitvoering.

    Selecteer een activiteit om de invoer en uitvoer ervan weer te geven.

    Schermopname van het deelvenster waarin u de invoer, uitvoer en status van een activiteit kunt bekijken.

  • Het tabblad Geschiedenis biedt een overzicht van alle gebeurtenissen in een orkestratie, inclusief tijdstempels.

    Schermafbeelding van het dashboard met de gebeurtenisgeschiedenis van een afzonderlijke orchestratie.

  • Het tabblad Flow geeft de uitvoeringsstroom van de orchestratie visueel weer.

    Screenshot van de gebeurtenisstroom van een individuele orchestratie.

    U kunt ook de invoer en uitvoer van een activiteit bekijken door op Weergave te klikken.

    Schermopname van het deelvenster waarin u de invoer, uitvoer en status van een activiteit kunt bekijken via de stroomweergave.

Orchestraties beheren

U kunt de levenscyclus van uw orchestratie beheren via het dashboard. Selecteer in het deelvenster Orchestrations een exemplaar-id om toegang te krijgen tot de volgende acties:

Schermopname van het dashboard met de knoppen Opschonen, Opnieuw opstarten, Beëindigen, Onderbreken en Hervatten voor het beheren van indelingen.

  • Hervatten: Hervat een eerder onderbroken orchestratie.
  • Opschorten: Pauzeer een lopende orchestratie. Het blijft in het geheugen, maar stopt met het verwerken van gebeurtenissen totdat deze is hervat.
  • Opnieuw starten: Start een eerder uitgevoerde orchestratie opnieuw.
  • Beëindigen: Stop een orchestratie onmiddellijk met een optionele redenreeks.
  • Purge: Verwijder het orchestration-exemplaar.

Open een afzonderlijke orchestratie om de actie Gebeurtenis genereren te openen. Met deze actie verzendt u een benoemde externe gebeurtenis (met een optionele JSON-payload) naar een actieve of opgeschorte orchestratie.

Screenshot van het dashboard met de knoppen Opschonen, Opnieuw starten, Beëindigen en Gebeurtenis activeren voor het beheren van orchestraties.

Entiteiten

Selecteer Entiteiten in het menu aan de linkerkant om entiteiten weer te geven die u hebt gemaakt.

Schermopname van de entiteiten die u hebt gemaakt en enkele beheerhulpprogramma's voor deze entiteiten.

Klik op een afzonderlijke entiteit in de lijst om de details ervan weer te geven. Hier kunt u het volgende bekijken:

  • Toen deze voor het laatst is gewijzigd
  • Wanneer de laatste bewerking is uitgevoerd
  • Of het is vergrendeld en wie het heeft vergrendeld
  • De achterstandsgrootte
  • De status van de entiteit in JSON of ruwe code

Schermopname van een afzonderlijke entiteit die wordt bijgehouden in het Durable Task Scheduler-dashboard.

U kunt ook een signaal naar de entiteit verzenden. Klik op Signal in de rechterbovenhoek en maak het signaalbericht.

Schermopname van het venster voor het verzenden van een signaal naar uw afzonderlijke entiteit.

Agents (preview)

Opmerking

Het controleren van agentsessies via het Durable Task Scheduler-dashboard is momenteel beschikbaar als preview-versie.

Selecteer Agents in het menu aan de linkerkant om agentsessies te bewaken die zijn geactiveerd door uw toepassing in de planner. Klik in een agentsessie om uw tokengebruiksgegevens weer te geven, zoals:

  • Het aantal prompttokens dat u hebt gebruikt.
  • Het aantal voltooiingstokens dat u hebt gebruikt.
  • Het totale aantal tokens dat tijdens de agentsessie wordt gebruikt.

U kunt ook de chatgeschiedenis en tijdlijn van de agent bekijken.

Schermopname van de agentsessies die zijn geactiveerd door uw toepassing.

Planningen

Selecteer Planningen in het menu aan de linkerkant om schema's weer te geven die u hebt gemaakt. In het deelvenster Planningen kunt u een planning onderbreken, hervatten of verwijderen. U kunt ook klikken op + Planning maken om een planning te maken via de gebruikersinterface van het dashboard.

Schermopname van de planningen die u hebt gemaakt en enkele beheerhulpprogramma's voor deze planningen.

Werknemers en metrische gegevens

Selecteer Workers & Metrics in het menu aan de linkerkant om het volgende weer te geven:

  • Al uw wachtende, actieve of opgeslagen activiteiten, orchestrators en entiteiten.
  • Geconnecteerde werknemers.

Schermopname van een overzicht van de werkitemwachtrijen en verbonden werknemers.

Volgende stappen 

Voor de Durable Task Scheduler binnen Durable Functions:

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

  • Last updated on