Compartilhar via

Depurar e gerenciar orquestrações usando o painel do Agendador de Tarefas Duráveis do Azure Functions (versão prévia)

Observe, gerencie e depure as orquestrações do hub de tarefas ou do agendador de tarefas usando o painel do Durable Task Scheduler. O painel está disponível quando você executa o emulador do Agendador de Tarefas Duráveis localmente ou cria um recurso de agendador no Azure.

Executar o emulador localmente não requer autenticação.

A criação de um recurso de agendador no Azure requer a atribuição da função Colaborador de Dados de Tarefa Durável à sua identidade. Em seguida, você pode acessar o painel por meio de:

  • URL do ponto de extremidade do painel do hub de tarefas no portal do Azure
  • Navegue até https://dashboard.durabletask.io/ combinado com o ponto de extremidade do hub de tarefas.

Neste artigo, você aprenderá a:

  • Atribua uma das funções da Tarefa Durável à sua identidade de desenvolvedor.
  • Acesse o painel do Agendador de Tarefas Duráveis.
  • Exiba o status e o histórico de orquestração por meio do painel do Agendador de Tarefas Duráveis.

Pré-requisitos

Antes de começar:

Acessar o painel do Agendador de Tarefas Duráveis

Atribua a função necessária à sua identidade de desenvolvedor (email) para obter acesso ao painel do Agendador de Tarefas Duráveis.

  1. Defina o destinatário como sua identidade de desenvolvedor.

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

  2. Defina o escopo. Conceder acesso no escopo do agendador dá acesso a todos os hubs de tarefas dentro desse agendador.

    Hub de Tarefas

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

    Agendador

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

  3. Conceda acesso. Execute o comando a seguir para criar a atribuição de função e conceder acesso.

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

    Resultado esperado

    O exemplo de saída a seguir mostra uma identidade de desenvolvedor atribuída à função de Colaborador de Dados de Tarefas Duráveis no nível do agendador.

    {
  "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. Depois de conceder acesso, acesse https://dashboard.durabletask.io/ e preencha as informações necessárias sobre o agendador e o hub de tarefas para ver o painel.

Observação

A instrução a seguir mostra uma atribuição de função com escopo para um hub de tarefas específico. Se você precisar de acesso a todos os hubs de tarefas em um agendador, execute a atribuição no nível do agendador.

  1. Navegue até o recurso de agendador de tarefas durável no portal.

  2. Clique em um nome de hub de tarefas.

  3. No menu à esquerda, selecione Controle de acesso (IAM) .

  4. Clique em Adicionar para adicionar uma atribuição de função.

    Captura de tela da adição da atribuição de função no painel Controle de Acesso no portal.

  5. Pesquise e selecione Colaborador de Dados da Tarefa Durável. Clique em Próximo.

    Captura de tela da seleção da atribuição de função Colaborador de Dados da Tarefa Durável no portal.

  6. Na guia Membros, para Atribuir acesso a, selecione Usuário, grupo ou entidade de serviço.

  7. Para Membros, clique em + Selecionar membros.

  8. No painel Selecionar membros, pesquise seu nome ou email:

    Captura de tela da seleção do tipo de identidade gerenciada atribuído pelo usuário no portal.

  9. Escolha seu email e clique no botão Selecionar.

  10. Clique em Examinar + atribuir para concluir a atribuição da função.

  11. Depois que a função for atribuída, clique em Visão geral no menu esquerdo do recurso do hub de tarefas e navegue até a URL do painel localizada na seção superior do Essentials.

Monitorar o progresso da orquestração e o histórico de execução

O painel permite que você monitore o progresso da orquestração e examine o histórico de execução. Você também pode filtrar por metadados de orquestração, como estado e marcas temporais.

Captura de tela do painel listando o histórico e o status da orquestração.

Exibir entradas e saídas de orquestração:

Captura de tela do painel listando o histórico de orquestração e as entradas e saídas de status.

Exibição detalhada da execução da orquestração

Você pode examinar instâncias de orquestração para visualizar os detalhes da execução e o progresso da atividade. Essa exibição ajuda você a diagnosticar problemas ou obter visibilidade do status de uma orquestração.

Na imagem a seguir, o modo de exibição de Linha do tempo de uma execução de orquestração. Nesta orquestração "ProcessDocument", a atividade "WriteDoc" foi tentada três vezes (com falha) com cinco segundos entre cada tentativa.

Captura de tela do painel mostrando a linha do tempo de execução da orquestração.

Você também pode exibir entradas e saídas de atividades em uma orquestração:

Captura de tela do painel mostrando entradas e saídas de atividade.

Outras exibições da sequência de execução da orquestração

A visão de Histórico mostra a sequência detalhada de eventos, marcas temporais e carga útil:

Captura de tela do painel mostrando os detalhes da instância de orquestração.

O modo de exibição Sequência fornece outra maneira de visualizar a sequência de eventos:

Captura de tela do painel mostrando a visualização de sequência de orquestração.

Gerenciamento de orquestração

O painel inclui recursos para gerenciar orquestrações sob demanda, como iniciar, pausar, retomar e encerrar.

Captura de tela do painel mostrando os botões usados para gerenciar a orquestração.

Próximas etapas

Para o Agendador de Tarefas Duráveis para o Durable Functions:

Para o Agendador de Tarefas Duráveis para os SDKs de Tarefas Duráveis: