지속성 작업 스케줄러 대시보드를 사용하여 오케스트레이션 디버그 및 관리

지속성 작업 스케줄러 대시보드를 사용하면 실행 중인 오케스트레이션을 관찰하고, 실행 기록 및 작업 입력/출력을 검사하고, 오케스트레이션 수명 주기(일시 중지, 다시 시작, 종료)를 모두 브라우저에서 관리할 수 있습니다.

대시보드는 다음 두 가지 환경에서 사용할 수 있습니다.

Environment	URL	Authentication
로컬 에뮬레이터	`http://localhost:8082`	필요한 항목 없음
Azure	`https://dashboard.durabletask.io/?endpoint=<SCHEDULER_ENDPOINT>&taskhub=<TASK_HUB_NAME>`	지속성 작업 데이터 기여자 역할이 필요합니다.

에뮬레이터에 대한 자세한 내용은 로컬 개발에 대한 에뮬레이터를 참조하세요.

이 문서에서는 다음 방법을 알아봅니다.

로컬 또는 Azure 대시보드에 액세스합니다.
지속성 작업 데이터 기여자 역할을 개발자 ID에 할당합니다.
오케스트레이션 상태를 모니터링하고, 인스턴스를 필터링하고, 실행 기록을 검사합니다.
오케스트레이션을 관리합니다(일시 중지, 다시 시작, 종료, 이벤트 발생).

사전 요구 사항

시작하기 전에 다음을 수행하십시오.

로컬로 대시보드 액세스

지속성 작업 스케줄러 에뮬레이터를 사용하는 경우 대시보드는 다음 위치에서 사용할 수 있습니다.

http://localhost:8082

로컬 개발에는 인증 또는 역할 할당이 필요하지 않습니다.

대시보드 액세스 역할 할당(Azure)

Azure 호스팅 스케줄러에 대한 대시보드에 액세스하려면 구성 가능한 작업 데이터 기여자 역할을 개발자 ID(이메일)에 할당합니다.

개발자 ID로 담당자를 설정합니다.

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

범위를 설정합니다. 스케줄러 범위에 대한 액세스 권한을 부여하면 해당 스케줄러의 모든 작업 허브에 액세스할 수 있습니다.

작업 허브

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"

액세스 권한을 부여합니다. 다음 명령을 실행하여 역할 할당을 만들고 액세스 권한을 부여합니다.

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

예상 출력

다음 출력 예제에서는 스케줄러 수준에서 지속성 작업 데이터 기여자 역할로 할당된 개발자 ID를 보여줍니다.

{
  "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"
}

액세스 권한을 부여한 후 다음 위치에서 대시보드를 엽니다.
```
https://dashboard.durabletask.io/?endpoint=<SCHEDULER_ENDPOINT>&taskhub=<TASK_HUB_NAME>
```
스케줄러의 엔드포인트(<SCHEDULER_ENDPOINT>)와 작업 허브의 이름(<TASK_HUB_NAME>)을 https://myscheduler.westus2.durabletask.io와 바꾸십시오.

또는 https://dashboard.durabletask.io/로 이동하여 연결 양식에 스케줄러 엔드포인트와 작업 허브 이름을 입력하세요.