Compartir a través de

Depurar y administrar orquestaciones mediante el panel de control del programador de tareas Durable de Azure Functions (versión preliminar)

Observe, gestione y depure las orquestaciones de su concentrador de tareas o planificador usando el panel de control del programador de tareas duraderas. El panel de control está disponible al ejecutar el emulador del planificador de tareas de Durable Task localmente o al crear un recurso del planificador en Azure.

La ejecución local del emulador no requiere autenticación.

La creación de un recurso de programador en Azure requiere asignar el rol Colaborador de datos de Tareas duraderas a la identidad. A continuación, puede acceder al panel a través de:

  • Dirección URL del punto de conexión del panel de la central de tareas en Azure Portal
  • Vaya a https://dashboard.durabletask.io/ combinado con el punto de conexión de la central de tareas.

En este artículo aprenderá a:

  • Asigne uno de los roles de Durable Task a la identidad del desarrollador.
  • Acceda al panel del Programador de tareas duraderas.
  • Vea el estado y el historial de la orquestación a través del panel del programador de Durable Task.

Prerrequisitos

Antes de comenzar:

Acceso al panel de control del planificador de Durable Task

Asigne el rol necesario a la identidad de desarrollador (correo electrónico) para obtener acceso al panel del Programador de tareas duraderas.

  1. Establezca el usuario asignado a la identidad del desarrollador.

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

  2. Establezca el ámbito. Conceder acceso en el ámbito del programador proporciona acceso a todas las centrales de tareas de ese programador.

    Central de tareas

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

    Planificador

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

  3. Conceder acceso. Ejecute el comando siguiente para crear la asignación de roles y conceder acceso.

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

    Salida esperada

    En el ejemplo de salida siguiente, se muestra una identidad de desarrollador asignada con el rol Colaborador de datos de tareas duraderas a nivel del programador:

    {
  "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. Después de conceder acceso, vaya a https://dashboard.durabletask.io/ y rellene la información necesaria sobre el programador y la central de tareas para ver el panel.

Nota:

En la siguiente instrucción se muestra una asignación de roles con ámbito de una central de tareas específica. En caso de necesitar acceso a todas las centrales de tareas de un programador, realice la asignación a nivel del programador.

  1. Vaya al recurso del programador de tareas duraderas en el portal.

  2. Haga clic en un nombre de la central de tareas.

  3. En el menú izquierdo, seleccione Control de acceso (IAM) .

  4. Haga clic en Agregar para agregar una asignación de roles.

    Recorte de pantalla de la adición de la asignación de roles en el panel Control de acceso del portal.

  5. Busque y seleccione Colaborador de datos de tareas duraderas. Haga clic en Next.

    Recorte de pantalla de la selección de la asignación de rol Colaborador de datos de tareas duraderas del portal.

  6. En la pestaña Miembros, en Asignar acceso a, seleccione Usuario, grupo o entidad de servicio.

  7. En Miembros, haga clic en + Seleccionar miembros.

  8. En el panel Seleccionar miembros, busque el nombre o el correo electrónico:

    Recorte de pantalla de la selección del tipo de identidad administrada asignada por el usuario en el portal.

  9. Elija el correo electrónico y haga clic en el botón Seleccionar.

  10. Haga clic en Revisar y asignar para terminar de asignar el rol.

  11. Una vez asignado el rol, haga clic en Información general, en el menú de la izquierda del recurso de la central de tareas, y vaya a la dirección URL del panel ubicada en la sección superior Essentials.

Supervisar el progreso de la orquestación y el historial de ejecución

El panel permite supervisar el progreso de la orquestación y revisar el historial de ejecución. También puede filtrar por metadatos de orquestación, como el estado y las marcas de tiempo.

Captura de pantalla del panel en el que se muestra el historial de orquestación y el estado.

Ver entradas y salidas de orquestación:

Captura de pantalla del panel que muestra el historial de orquestación y las entradas y salidas de estado.

Vista detallada de la ejecución de orquestación

Puede profundizar en las instancias de orquestación para ver los detalles de ejecución y el progreso de la actividad. Esta vista le ayuda a diagnosticar problemas o a obtener visibilidad sobre el estado de una orquestación.

En la imagen siguiente, la vista Escala de tiempo de una ejecución de orquestación. En esta orquestación "ProcessDocument", la actividad "WriteDoc" se reintentó tres veces (sin éxito) con cinco segundos de espera entre reintentos.

Captura de pantalla del panel que muestra la línea de tiempo de la ejecución de la orquestación.

También puede ver entradas y salidas de actividades en una orquestación:

Captura de pantalla del panel que muestra las entradas y salidas de la actividad.

Otras vistas de la secuencia de ejecución de orquestación

La vista Historial muestra una secuencia de eventos detallada, marcas de tiempo y carga:

Captura de pantalla del panel que muestra los detalles de la instancia de orquestación.

La vista Secuencia proporciona otra manera de visualizar la secuencia de eventos:

Captura de pantalla del panel que muestra la vista de secuencia de orquestación.

Administración de orquestaciones

El panel incluye características para administrar orquestaciones a petición, como iniciar, pausar, reanudar y finalizar.

Captura de pantalla del panel que muestra los botones que usa para administrar la orquestación.

Pasos siguientes

Para el Programador de tareas duraderas en Durable Functions:

Para el Programador de tareas duraderas de los SDK de Tareas duraderas: