Felsöka och hantera orkestreringar med instrumentpanelen Durable Task Scheduler

På instrumentpanelen Durable Task Scheduler kan du observera orkestreringar som körs, granska körningshistorik och aktivitetsindata/utdata och hantera orkestreringslivscykel (pausa, återuppta, avsluta) allt från en webbläsare.

Instrumentpanelen är tillgänglig i två miljöer:

Environment URL Authentication
Lokal emulator http://localhost:8082 Ingen krävs
Azure https://dashboard.durabletask.io/?endpoint=<SCHEDULER_ENDPOINT>&taskhub=<TASK_HUB_NAME> Kräver Durable Task Data Contributor-rollen

Mer information om emulatorn finns i Emulatorn för lokal utveckling.

I den här artikeln lär du dig att:

  • Få åtkomst till instrumentpanelen lokalt eller på Azure.
  • Tilldela rollen Durable Task Data Contributor till din utvecklaridentitet.
  • Övervaka orkestreringsstatus, filtrera instanser och inspektera körhistorik.
  • Hantera orkestreringar (pausa, återuppta, avsluta, utlösa händelser).

Förutsättningar

Innan du börjar:

Få åtkomst till instrumentpanelen lokalt

Om du använder Durable Task Scheduler-emulatorn är instrumentpanelen tillgänglig på:

http://localhost:8082

Ingen autentisering eller rolltilldelning krävs för lokal utveckling.

Tilldela åtkomstroller för instrumentpanelen (Azure)

Om du vill komma åt instrumentpanelen för en Azure värdbaserad schemaläggare tilldelar du rollen Durable Task Data Contributor till din utvecklaridentitet (e-post).

  1. Ange tilldelningsobjektet till din utvecklaridentitet.

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

  2. Ange omfånget. Om du beviljar åtkomst till scheduler-omfånget får du åtkomst till alla aktivitetshubbar i schemaläggaren.

    Aktivitetshubben

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

    Schemaläggare

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

  3. Bevilja åtkomst. Kör följande kommando för att skapa rolltilldelningen och bevilja åtkomst.

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

    Förväntade utdata

    I följande utdataexempel visas en utvecklaridentitet som tilldelats rollen Durable Task Data Contributor på schemaläggningsnivå :

    {
  "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. När du har beviljat åtkomst öppnar du instrumentpanelen på:

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

    Ersätt <SCHEDULER_ENDPOINT> med schemaläggarens slutpunkt (till exempel https://myscheduler.westus2.durabletask.io) och <TASK_HUB_NAME> med namnet på aktivitetshubben.

    Du kan också navigera till https://dashboard.durabletask.io/ och ange namnet på schemaläggarens slutpunkt och aktivitetshubben i anslutningsformuläret.

Anmärkning

Följande instruktion visar en rolltilldelning som är begränsad till en specifik aktivitetshubb. Om du behöver åtkomst till alla aktivitetshubbar i en schemaläggare utför du tilldelningen på schemaläggningsnivå.

  1. Gå till resursen Durable Task Scheduler på portalen.

  2. Klicka på ett namn på en aktivitetshubb.

  3. Välj Åtkomstkontroll (IAM) i den vänstra menyn.

  4. Klicka på Lägg till för att lägga till en rolltilldelning.

    Skärmbild av att lägga till rolltilldelningen i fönstret Access Control i portalen.

  5. Sök efter och välj Durable Task Data-bidragsgivare. Klicka på Nästa.

    Skärmbild av att välja rolltilldelningen Durable Task Data Contributor i portalen.

  6. På fliken Medlemmar för Tilldela åtkomst till väljer du Användare, grupp eller tjänstens huvudnamn.

  7. För Medlemmar klickar du på + Välj medlemmar.

  8. I fönstret Välj medlemmar söker du efter ditt namn eller din e-postadress:

    Skärmbild av att välja den användartilldelade hanterade identitetstypen i portalen.

  9. Välj din e-post och klicka på knappen Välj .

  10. Klicka på Översikt + tilldelning för att slutföra tilldela rollen.

  11. När rollen har tilldelats klickar du på Översikt på den vänstra menyn i aktivitetshubbens resurs och navigerar till instrumentpanelens URL som finns i det översta avsnittet Essentials .

Övervaka aktivitetshubben via instrumentpanelen

På instrumentpanelen kan du övervaka orkestreringsprocessen och granska körningshistoriken. På instrumentpanelens startsida hittar du uppgiftshubbens orkestreringar, entiteter, scheman, arbetare och mått samt AI-agenter (för närvarande i förhandsversion).

Översiktsfönster för orkestreringar

Visa orkestreringar genom att klicka antingen på aktivitetshubbens namn eller Orkestreringar från sidomenyn.

Skärmbild av instrumentpanelens startsida med länkar till aktivitetshubbar, orkestreringshistorik, entiteter, scheman, arbetare, mått och AI-agenter.

I översiktsfönstret för Orkestreringar kan du:

  • Granska en lista över orkestreringsinstanser.
  • Begränsa orkestreringarna via sökfältet eller filter.
  • Skapa en ny orkestrering.
  • Kopiera en delningsbar länk till instrumentpanelen.
  • Ange intervall för automatisk uppdatering för orkestreringslistan.

Skärmbild av instrumentpanelen med orkestreringar.

Orkestreringsinformation visas med följande standardkolumner.

Kategori Description
Instans-ID Sök efter en specifik orkestreringsinstans med dess unika ID.
Name Filtrera efter orkestreringstypens namn.
Status Filtrera efter körningsstatus (körs, slutförs, misslyckades, avslutades, väntar, pausas).
Taggar Filtrera efter taggarna som tillämpas på orkestreringsinstansen.
Skapad Datum och tid då orkestreringen skapades.

Du kan filtrera orkestreringslistan med hjälp av följande villkor.

Skärmbild av instrumentpanelen med orkestreringshistorik och status med filteralternativ.

Kategori Description
Orkestreringsnamn Filtrera efter orkestreringstypens namn.
Körningsstatus Filtrera efter körningsstatus (körs, slutförs, misslyckades, avslutades, väntar, pausas).
Taggfilter Sök efter orkestreringar efter taggnyckel eller värde.
Skapad från/Skapad till Begränsa resultatet till ett tidsfönster.

Utlös en uppdatering av orkestreringslistan genom att:

  • Klicka på uppdateringsikonen för en manuell uppdatering.

  • Växla Automatiskt och välj intervall för att automatiskt uppdatera listan.

    Skärmbild av växlingsknappen autorefresh och ikonen för manuell uppdatering.

Skapa en ny orkestrering

Du kan skapa en ny orkestrering från instrumentpanelen för Durable Task Scheduler.

  1. I översiktsfönstret Orkestrering klickar du på + Ny orkestrering.

  2. Fyll i informationen i formuläret Ny orkestrering .

    Skärmbild av formuläret Skapa ny orkestrering.

    Fält Description
    Orkestreringsnamn Välj en orkestrering i listrutan eller skriv ett anpassat orkestreringsnamn.
    Instans-ID Optional. Instans-ID:t genereras automatiskt. Oavsett om du skapar en själv eller låter den genereras automatiskt är instans-ID:t i ASCII-format.
    Version Optional. Ange tillämpligt versionsnummer.
    Input Optional. Ange indata i JSON-format.
    Planerad start Optional. Välj startdatum och tid för orkestreringen.
    Taggar Optional. Ange nyckel- och/eller värdetaggar som är associerade med orkestreringen.

  3. Klicka på Skapa.

    Du kan se din nya orkestrering i listan.

Orkestreringsinformation

Klicka på en orkestreringsinstans för att diagnostisera problem eller få insyn i statusen för en orkestrering.

Använd flikarna Tidslinje, Historik och Flöde för att visa dess körningsinformation och aktivitetsstatus. Fliken Tidslinje är öppen som standard.

  • Fliken Tidslinje visar intervallen för en orkestrering som körs.

    Skärmbild av tidslinjen för orkestreringskörning.

    Välj en aktivitet för att visa dess indata och utdata.

    Skärmbild av fönstret där du kan visa en aktivitets indata, utdata och status.

  • Fliken Historik innehåller en feed för alla händelser i en orkestrering, komplett med tidsstämplar.

    Skärmbild av instrumentpanelen som visar en enskild orkestrerings händelsehistorik.

  • Fliken Flöde ritar visuellt ut orkestreringens körningsflöde.

    Skärmbild av en enskild orkestrerings händelseflöde.

    Du kan också visa en aktivitets indata och utdata genom att klicka på Visa.

    Skärmbild av fönstret där du kan visa en aktivitets indata, utdata och status via flödesvyn.

Hantera orkestreringar

Du kan hantera orkestreringslivscykeln via instrumentpanelen. I fönstret Orkestreringar väljer du ett instans-ID för att komma åt följande åtgärder:

Skärmbild av instrumentpanelen som visar knapparna Rensa, Starta om, Avsluta, Pausa och Återuppta för att hantera orkestreringar.

  • Återuppta: Fortsätt med en tidigare pausad orkestrering.
  • Pausa: Pausar en pågående orkestrering. Den finns kvar i minnet, men slutar bearbeta händelser tills den återupptas.
  • Starta om: Starta om en orkestrering som tidigare har körts.
  • Avsluta: Stoppa omedelbart en orkestrering med en valfri orsakssträng.
  • Rensa: Rensa bort orkestreringsinstansen.

Gå in i en enskild orkestrering för att komma åt åtgärden Utlös händelse. Den här åtgärden skickar en namngiven extern händelse (med valfri JSON-nyttolast) till en orkestrering som körs eller är pausad.

Skärmbild av instrumentpanelen som visar knapparna Rensa, Starta om, Avsluta och Utlös händelse för att hantera orkestreringar.

Enheter

Välj Entiteter på menyn till vänster för att visa entiteter som du har skapat.

Skärmbild av de entiteter som du skapade och några hanteringsverktyg för dem.

Klicka på en enskild entitet i listan för att visa dess information. Härifrån kan du granska:

  • När den senast ändrades
  • När den senaste åtgärden kördes
  • Om den är låst och vem som låste den
  • Dess storlek på kvarvarande uppgifter
  • Entitetstillståndet i antingen JSON- eller raw-kod

Skärmbild av en enskild entitet som spåras på instrumentpanelen Durable Task Scheduler.

Du kan också skicka en signal till entiteten. Klicka på Signal i det övre högra hörnet och skapa signalmeddelandet.

Skärmbild av fönstret för att skicka en signal till din enskilda entitet.

Agenter (förhandsversion)

Anmärkning

Att granska agentsessioner via dashboarden för Durable Task Scheduler är för närvarande en förhandsversion.

Välj Agenter på menyn till vänster för att övervaka agentsessioner som utlöses av ditt program i schemaläggaren. Klicka på en agentsession för att visa dina tokenanvändningsdata, till exempel:

  • Antalet prompttoken som du har använt.
  • Antalet slutförandetoken som du har använt.
  • Det totala antalet token som användes under agentsessionen.

Du kan också visa agentens chatthistorik och tidslinje.

Skärmbild av agentsessionerna som utlöstes av ditt program.

Scheman

Välj Scheman på menyn till vänster för att visa scheman som du har skapat. Från schemafönstret kan du pausa, återuppta eller ta bort ett schema. Du kan också klicka på + Skapa schema för att skapa ett schema via instrumentpanelens användargränssnitt.

Skärmbild av de scheman som du skapade och några hanteringsverktyg för dem.

Arbetsprocesser och mätvärden

Välj Arbetare och mått på menyn till vänster för att visa:

  • Alla dina väntande, aktiva eller lagrade aktiviteter, orkestrerare och entiteter.
  • Uppkopplade medarbetare.

Skärmbild av en översikt över köer för arbetsobjekt och anslutna arbetare.

Nästa steg

För Durable Task Scheduler för återkommande funktioner för Durable Functions:

För Durable Task Scheduler för Durable Task SDK:er:

  • Last updated on