Udostępnij przez

Debugowanie aranżacji i zarządzanie nimi przy użyciu pulpitu nawigacyjnego narzędzia Durable Task Scheduler usługi Azure Functions

Obserwowanie i debugowanie aranżacji centrum zadań lub harmonogramu oraz zarządzanie nimi przy użyciu pulpitu nawigacyjnego narzędzia Durable Task Scheduler. Pulpit nawigacyjny jest dostępny podczas lokalnego uruchamiania emulatora harmonogramu zadań Durable Task Scheduler lub tworzenia zasobu harmonogramu na platformie Azure.

Uruchomienie emulatora lokalnie nie wymaga uwierzytelniania.

Utworzenie zasobu harmonogramu na platformie Azure wymaga przypisania roli Współautor danych trwałych zadań do twojej tożsamości. Następnie możesz uzyskać dostęp do pulpitu nawigacyjnego za pośrednictwem jednego z następujących rozwiązań:

  • Adres URL punktu końcowego pulpitu nawigacyjnego centrum zadań w witrynie Azure Portal
  • Przejdź do https://dashboard.durabletask.io/ w połączeniu z punktem końcowym centrum zadań.

W tym artykule dowiesz się, jak:

  • Przypisz do tożsamości dewelopera jedną z ról Durable Task.
  • Uzyskaj dostęp do pulpitu nawigacyjnego narzędzia Durable Task Scheduler.
  • Wyświetlanie stanu orkiestracji i historii za pomocą pulpitu nawigacyjnego narzędzia Durable Task Scheduler.

Wymagania wstępne

Przed rozpoczęciem:

Uzyskiwanie dostępu do pulpitu nawigacyjnego narzędzia Durable Task Scheduler

Przypisz wymaganą rolę do tożsamości dewelopera (e-mail), aby uzyskać dostęp do pulpitu nawigacyjnego narzędzia Durable Task Scheduler.

  1. Ustaw osobę przypisaną do swojej tożsamości dewelopera.

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

  2. Ustaw zakres. Udzielanie dostępu w zakresie harmonogramu zapewnia dostęp do wszystkich centrów zadań w tym harmonogramie.

    Centrum zadań

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

    Harmonogram

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

  3. Udziel dostępu. Uruchom następujące polecenie, aby utworzyć przypisanie roli i udzielić dostępu.

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

    Oczekiwane dane wyjściowe

    Poniższy przykład danych wyjściowych pokazuje tożsamość dewelopera, któremu przypisano rolę Współautora danych zadań trwałych na poziomie harmonogramu.

    {
  "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. Po udzieleniu dostępu przejdź do https://dashboard.durabletask.io/ strony i wypełnij wymagane informacje o harmonogramie i centrum zadań, aby wyświetlić pulpit nawigacyjny.

Uwaga / Notatka

Poniższa instrukcja przedstawia przypisanie roli o określonym zakresie do określonego centrum zadań. Jeśli potrzebujesz dostępu do wszystkich węzłów zadań w planu, wykonaj przypisanie na poziomie planisty.

  1. Przejdź do zasobu Durable Task Scheduler w portalu.

  2. Kliknij nazwę centrum zadań.

  3. W menu po lewej stronie wybierz pozycję Kontrola dostępu (Zarządzanie dostępem i tożsamościami)..

  4. Kliknij Dodaj, aby dodać przypisanie roli.

    Zrzut ekranu z dodawania przypisania roli w okienku kontroli dostępu w portalu.

  5. Wyszukaj i wybierz Durable Task Data Contributor. Kliknij przycisk Dalej.

    Zrzut ekranu przedstawiający wybieranie przypisania roli Współautor danych zadania trwałego w portalu.

  6. Na karcie Członkowie, w polu Przypisz dostęp do, wybierz Użytkownik, grupa lub jednostka usługi.

  7. Dla członków kliknij + Wybierz członków.

  8. W sekcji wyboru członków, wyszukaj swoje imię i nazwisko lub adres e-mail.

    Zrzut ekranu przedstawiający wybieranie typu tożsamości zarządzanej przypisanej przez użytkownika w portalu.

  9. Wybierz wiadomość e-mail i kliknij przycisk Wybierz.

  10. Kliknij Przejrzyj i przypisz, aby zakończyć przypisywanie roli.

  11. Po przypisaniu roli kliknij Przegląd w menu po lewej stronie zasobu centrum zadań i przejdź do adresu URL pulpitu nawigacyjnego znajdującego się w górnej części sekcji Podstawowe.

Nadzorowanie postępu orkiestracji i historia wykonania

Pulpit nawigacyjny umożliwia monitorowanie postępu aranżacji i przeglądanie historii wykonywania. Można również filtrować według metadanych aranżacji, takich jak stan i znaczniki czasu.

Zrzut ekranu pulpitu nawigacyjnego z listą historii i statusu orkiestracji.

Wyświetlanie danych wejściowych i wyjściowych orkiestracji:

Zrzut ekranu pulpitu nawigacyjnego przedstawiający historię i statusy orkiestracji oraz dane wejściowe i wyjściowe.

Szczegółowy widok wykonywania orkiestracji

Możesz zagłębić się w szczegóły instancji orkiestracji, aby wyświetlić informacje o wykonaniu i postępie aktywności. Ten widok ułatwia diagnozowanie problemów lub uzyskiwanie wglądu w stan aranżacji.

Na poniższej ilustracji widok osi czasu wykonania orkiestracji. W tej orkiestracji "ProcessDocument" czynność "WriteDoc" powtarzano trzy razy (bezskutecznie) z pięciosekundowymi przerwami pomiędzy próbami.

Zrzut ekranu pulpitu nawigacyjnego z osią czasu wykonywania orkiestracji.

Możesz również wyświetlać dane wejściowe i wyjściowe działań w orkiestracji:

Zrzut ekranu przedstawiający pulpit nawigacyjny przedstawiający dane wejściowe i wyjściowe działań.

Inne perspektywy sekwencji wykonywania orkiestracji

Widok Historia zawiera szczegółową sekwencję zdarzeń, znaczniki czasu i ładunek:

Zrzut ekranu przedstawiający pulpit nawigacyjny z szczegółami wystąpienia orkiestracji.

Widok sekwencji oferuje inny sposób wizualizacji sekwencji zdarzeń.

Zrzut ekranu pulpitu nawigacyjnego pokazujący widok sekwencji orkiestracji.

Zarządzanie orkiestracją

Panel sterowania zawiera funkcje do zarządzania orkiestracjami na żądanie, takie jak uruchamianie, wstrzymanie, wznawianie i kończenie.

Zrzut ekranu przedstawiający pulpit nawigacyjny przedstawiający przyciski używane do zarządzania orkiestracją.

Następne kroki

Menedżer Zadań Trwałych dla Trwałych Funkcji:

W przypadku planera zadań w ramach Durable Task dla SDK zadań trwałych:

  • Last updated on