Dela via

Felsöka och hantera orkestreringar med instrumentpanelen för Azure Functions Durable Task Scheduler (förhandsversion)

Observera, hantera och felsök dina aktivitetshubbars eller schemaläggares orkestreringar med hjälp av instrumentpanelen Durable Task Scheduler. Instrumentpanelen är tillgänglig när du kör Durable Task Scheduler-emulatorn lokalt eller skapar en scheduler-resurs i Azure.

Att köra emulatorn lokalt kräver inte autentisering.

Om du skapar en scheduler-resurs i Azure måste du tilldela rollen Durable Task Data Contributor till din identitet. Du kan sedan komma åt instrumentpanelen via antingen:

  • Url:en för aktivitetshubbens instrumentpanelsslutpunkt i Azure-portalen
  • Navigera till https://dashboard.durabletask.io/ kombinerat med aktivitetshubbens slutpunkt.

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

  • Tilldela en av Durable Task-rollerna till utvecklaridentiteten.
  • Öppna instrumentpanelen Durable Task Scheduler.
  • Visa orkestreringsstatus och historik via instrumentpanelen Durable Task Scheduler.

Förutsättningar

Innan du börjar:

Få åtkomst till instrumentpanelen för Durable Task Scheduler

Tilldela den erforderliga rollen till din utvecklaridentitet (e-post) för att få åtkomst till Durable Task Scheduler-instrumentpanelen.

  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 går du till https://dashboard.durabletask.io/ och fyller i nödvändig information om schemaläggaren och aktivitetshubben för att se instrumentpanelen.

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 för den hållbara arbetsuppgiftsschemaläggaren 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 Åtkomstkontroll 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 orkestreringsstatus och körningshistorik

På instrumentpanelen kan du övervaka orkestreringsprocessen och granska körningshistoriken. Du kan också filtrera efter orkestreringsmetadata, till exempel tillstånd och tidsstämplar.

Skärmbild av instrumentpanelen med orkestreringshistorik och status.

Visa orkestreringsindata och utdata:

Skärmbild av instrumentpanelen med orkestreringshistorik och statusindata och utdata.

Detaljerad vy över orkestreringsutförande

Du kan borra ner i orkestreringsinstanser för att visa körningsdetaljer och aktivitetsförlopp. Den här vyn hjälper dig att diagnostisera problem eller få insyn i statusen för en orkestrering.

I följande bild visas tidslinjevyn för en orkestreringskörning. I den här "ProcessDocument"-orkestreringen försökte aktiviteten "WriteDoc" igen tre gånger (utan framgång) med fem sekunder mellan återförsöket.

Skärmbild av instrumentpanelen som visar tidslinjen för orkestreringskörning.

Du kan också visa indata och utdata för aktiviteter i en orkestrering:

Skärmbild av instrumentpanelen som visar aktivitetsindata och utdata.

Andra vyer av orkestreringskörningssekvens

Historikvyn visar en detaljerad händelsesekvens, tidsstämplar och data:

Skärmbild av instrumentpanelen som visar information om orkestreringsinstansen.

Sekvensvyn ger ett annat sätt att visualisera händelsesekvens:

Skärmbild av instrumentpanelen som visar orkestreringssekvensvyn.

Orkestreringshantering

Instrumentpanelen innehåller funktioner för att hantera orkestreringar på begäran, till exempel starta, pausa, återuppta och avsluta.

Skärmbild av instrumentpanelen som visar de knappar som du använder för att hantera orkestreringen.

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: