Partager via

Déboguer et gérer des orchestrations à l’aide du tableau de bord Du planificateur de tâches durable Azure Functions

Observez, gérez et déboguez les orchestrations de votre hub de tâches ou de votre planificateur à l’aide du tableau de bord Durable Task Scheduler. Le tableau de bord est disponible lorsque vous exécutez l’émulateur Durable Task Scheduler localement ou créez une ressource de planificateur sur Azure.

L’exécution de l’émulateur localement ne nécessite pas d’authentification.

La création d’une ressource de planificateur sur Azure nécessite l’attribution du rôle Contributeur aux données des tâches durables à votre identité. Vous pouvez ensuite accéder au tableau de bord via :

  • URL du point de terminaison du tableau de bord du hub de tâches dans le portail Azure
  • Accédez à https://dashboard.durabletask.io/ combiné avec le point de terminaison de votre hub de tâches.

Dans cet article, vous allez apprendre à :

  • Attribuez l’un des rôles Durable Task à votre identité de développeur.
  • Accédez au tableau de bord planificateur de tâches durables.
  • Affichez l’état et l’historique de l’orchestration via le tableau de bord du planificateur de tâches durable.

Conditions préalables

Avant de commencer :

Accéder au tableau de bord du planificateur de tâches durables

Attribuez le rôle requis à votre identité de développeur (e-mail) pour accéder au tableau de bord du Planificateur de tâches durables.

  1. Définissez le destinataire sur votre identité de développeur.

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

  2. Définissez l’étendue. L’octroi de l’accès sur l’étendue du planificateur donne accès à tous les hubs de tâches dans ce planificateur.

    Hub de tâches

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

    Scheduler

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

  3. Accordez l’accès. Exécutez la commande suivante pour créer l’attribution de rôle et accorder l’accès.

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

    Résultat attendu

    L’exemple de sortie suivant montre une identité de développeur affectée au rôle Contributeur aux données des tâches durables au niveau du planificateur :

    {
  "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. Après avoir accordé l’accès, accédez à https://dashboard.durabletask.io/ et renseignez les informations requises sur votre planificateur et votre hub de tâches pour afficher le tableau de bord.

Remarque

L’instruction suivante montre une attribution de rôle délimitée à un hub de tâches spécifique. Si vous avez besoin d’accéder à tous les hubs de tâches dans un planificateur, effectuez l’affectation au niveau du planificateur.

  1. Accédez à la ressource Planificateur de tâches durables sur le portail.

  2. Cliquez sur un nom de hub de tâches.

  3. Dans le menu de gauche, sélectionnez Contrôle d’accès (IAM) .

  4. Cliquez sur Ajouter pour ajouter une attribution de rôle.

    Capture d’écran de l’ajout de l’attribution de rôle dans le volet Contrôle d’accès dans le portail.

  5. Recherchez et sélectionnez Contributeur de données pour les tâches durables. Cliquez sur Suivant.

    Capture d’écran de la sélection du rôle de Contributeur de données pour les tâches durables dans le portail.

  6. Sous l’onglet Membres, pour Affecter l’accès à, sélectionnez Utilisateur, groupe ou principal du service.

  7. Pour les membres, cliquez sur + Sélectionner des membres.

  8. Dans le volet Sélectionner des membres , recherchez votre nom ou votre adresse e-mail :

    Capture d’écran de la sélection du type d’identité managée affectée par l’utilisateur dans le portail.

  9. Sélectionnez votre e-mail, puis cliquez sur le bouton Sélectionner .

  10. Cliquez sur Vérifier + affecter pour terminer l’attribution du rôle.

  11. Une fois le rôle attribué, cliquez sur Vue d’ensemble dans le menu de gauche de la ressource du hub de tâches, puis accédez à l’URL du tableau de bord située dans la section Éléments essentiels en haut.

Surveiller la progression de l’orchestration et l’historique d’exécution

Le tableau de bord vous permet de surveiller la progression de l’orchestration et de passer en revue l’historique d’exécution. Vous pouvez également filtrer par métadonnées d’orchestration, telles que l’état et les horodatages.

Capture d’écran du tableau de bord répertoriant l’historique et l’état de l’orchestration.

Afficher les entrées et sorties d’orchestration :

Capture d’écran du tableau de bord répertoriant l’historique de l’orchestration et les entrées et sorties d’état.

Vue détaillée de l’exécution de l’orchestration

Vous pouvez explorer les instances d’orchestration pour afficher les détails de l’exécution et la progression de l’activité. Cette vue vous aide à diagnostiquer les problèmes ou à obtenir une visibilité sur l’état d’une orchestration.

L’image suivante montre la vue Chronologie d’une exécution d’orchestration. Dans cette orchestration « ProcessDocument », l’activité « WriteDoc » a retenté trois fois (sans succès) avec cinq secondes entre les nouvelles tentatives.

Capture d’écran du tableau de bord montrant la chronologie d’exécution de l’orchestration.

Vous pouvez également afficher les entrées et sorties des activités dans une orchestration :

Capture d’écran du tableau de bord montrant les entrées et sorties d’activité.

Autres vues de la séquence d’exécution d’orchestration

La vue Historique affiche une séquence d’événements détaillée, des horodatages et une charge utile :

Capture d’écran du tableau de bord montrant les détails de l’instance d’orchestration.

La vue Séquence offre un autre moyen de visualiser la séquence d’événements :

Capture d’écran du tableau de bord montrant l’affichage de la séquence d’orchestration.

Gestion de l’orchestration

Le tableau de bord inclut des fonctionnalités de gestion des orchestrations à la demande, telles que le démarrage, la suspension, la reprise et la fin.

Capture d’écran du tableau de bord montrant les boutons que vous utilisez pour gérer l’orchestration.

Étapes suivantes

Pour le planificateur de tâches durables pour Durable Functions :

Pour le planificateur de tâches durables pour les Kits de développement logiciel (SDK) de tâches durables :

  • Last updated on