Partilhar via

Depure e gere orquestrações usando o painel Azure Functions Durable Task Scheduler

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

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

Criar um recurso de agendador no Azure requer atribuir a função de Colaborador de Dados de Tarefa Durável à sua identidade. Em seguida, pode aceder ao painel através de:

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

Neste artigo, você aprenderá a:

  • Atribua uma das funções de Tarefa Durável à sua identidade de desenvolvedor.
  • Acesse o painel do Agendador de Tarefas Duráveis.
  • Veja o estado e o histórico da orquestração através do painel do Agendador de Tarefas Duráveis.

Pré-requisitos

Antes de começar:

Acesse o painel do Agendador de Tarefas Duráveis

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

  1. Defina o responsável para a sua identidade de desenvolvedor.

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

  2. Defina o escopo. A concessão de acesso no escopo do agendador dá acesso a todos os hubs de tarefas nesse 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. Conceder acesso. Execute o seguinte comando para criar a atribuição de função e conceder acesso.

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

    Resultados esperados

    O exemplo de saída a seguir mostra uma identidade de desenvolvedor atribuída com a função de Colaborador de Dados de Tarefa Durável 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, vá para https://dashboard.durabletask.io/ e preencha as informações necessárias sobre seu agendador e hub de tarefas para ver o painel.

Observação

A instrução a seguir mostra uma atribuição de função limitada a 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é ao recurso Durable Task Scheduler no portal.

  2. Clique no nome de um 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 de Tarefa Durável. Clique em Next.

    Captura de ecrã a mostrar a seleção da atribuição da função Colaborador de Dados de Tarefas Duráveis 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 , procure o seu nome ou e-mail:

    Captura de ecrã a mostrar a seleção do tipo de identidade gerida atribuída pelo utilizador no portal.

  9. Escolha seu e-mail e clique no botão Selecionar .

  10. Clique em Rever e atribuir para concluir a atribuição do papel.

  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 .

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

O painel permite monitorar o progresso da orquestração e revisar o histórico de execução. Você também pode filtrar por metadados de orquestração, como estado e carimbos de data/hora.

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

Veja 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.

Vista detalhada da execução da orquestração

Você pode explorar instâncias de orquestração para exibir detalhes de execução e progresso da atividade. Esta vista ajuda-o a diagnosticar problemas ou a obter visibilidade sobre o estado de uma orquestração.

Na imagem a seguir, a visualização Linha do tempo de uma execução de orquestração. Nesta orquestração "ProcessDocument", a atividade "WriteDoc" foi tentada novamente três vezes (sem sucesso) 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 visualizar entradas e saídas de atividades em uma orquestração:

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

Visões alternativas da sequência de execução da orquestração

A visualização Histórico mostra a sequência de eventos detalhada, os carimbos de data/hora e o conteúdo associado:

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

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

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

Gestão 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 que você usa para gerenciar a orquestração.

Próximos passos

Para o Agendador de Tarefas Durável para Funções Duráveis:

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

  • Last updated on