本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用截止日期雲端監視器
<a name="working-with-deadline-monitor"></a>

 AWS Deadline Cloud Monitor 為您提供視覺化運算任務的整體檢視。您可以使用它來監控和管理任務、檢視機群上的工作者活動、追蹤預算和用量，以及下載任務的結果。

每個佇列都有一個任務監控器，可顯示任務、步驟和任務的狀態。監視器提供直接從監視器管理任務的方法。您可以進行優先順序變更、取消任務、排入佇列任務，以及重新提交任務。

截止日期雲端監視器具有顯示任務摘要狀態的資料表，或者您可以選取任務以查看詳細的任務日誌，以協助疑難排解任務的問題。

您可以使用截止日期雲端監視器，將結果下載到建立任務時指定的工作站位置。

Deadline Cloud Monitor 也可協助您監控用量和管理成本。如需詳細資訊，請參閱[追蹤截止日期雲端陣列的支出和用量](manage-costs.md)。

**Topics**
+ [共用截止日期雲端監視器 URL](share-monitor-url.md)
+ [開啟截止日期雲端監視器](open-deadline-cloud-monitor.md)
+ [提交任務套件](submit-job-bundle-monitor.md)
+ [在截止日期雲端中檢視佇列和機群詳細資訊](view-queue-and-fleet.md)
+ [在截止日期雲端中管理任務、步驟和任務](view-jobs-steps-tasks.md)
+ [在截止日期雲端中檢視和管理任務詳細資訊](view-a-job.md)
+ [在截止日期雲端中檢視步驟](view-a-step.md)
+ [在截止日期雲端中檢視任務](view-a-task.md)
+ [在截止日期雲端中檢視工作階段和工作者日誌](view-logs.md)
+ [在工作者儀表板中檢視工作者詳細資訊](view-worker-dashboard.md)
+ [在截止日期雲端中下載完成的輸出](download-finished-output.md)
+ [自動化截止日期雲端監控桌面部署和工作流程](monitor-automate-desktop.md)

# 共用截止日期雲端監視器 URL
<a name="share-monitor-url"></a>

當您設定截止日期雲端服務時，預設會建立 URL，以開啟您帳戶的截止日期雲端監視器。使用此 URL 在瀏覽器或桌面上開啟監視器。與其他使用者共用 URL，以便他們可以存取截止日期雲端監視器。

您必須先授予使用者存取權，使用者才能開啟截止日期雲端監視器。若要授予存取權，請將使用者新增至監視器的授權使用者清單，或將其新增至可存取監視器的群組。如需詳細資訊，請參閱[在截止日期雲端中管理使用者](managing-users.md)。

**共用監視器 URL**

1. 開啟[截止日期雲端主控台](https://console.aws.amazon.com/deadlinecloud/home)。

1. 從**入門**中，選擇**前往截止日期雲端儀表板**。

1. 在導覽窗格中，選擇 **Dashboard (儀表板)**。

1. 在**帳戶概觀**區段中，選擇**帳戶詳細資訊**。

1. 複製 URL，然後安全地將 **URL** 傳送給需要存取截止日期雲端監視器的任何人。

# 開啟截止日期雲端監視器
<a name="open-deadline-cloud-monitor"></a>

您可以透過下列任何方式開啟截止日期雲端監視器：
+ **主控台** – 登入 AWS 管理主控台 並開啟截止日期雲端主控台。
+ **Web** – 前往您在設定截止日期雲端時建立的監視器 URL。
+ **Monitor** – 使用桌面截止日期雲端監視器。

使用 主控台時，您必須能夠 AWS 使用 AWS Identity and Access Management 身分登入 ，然後使用 AWS IAM Identity Center 憑證登入監視器。如果您只有 IAM Identity Center 登入資料，則必須使用監視器 URL 或桌面應用程式登入。

**開啟截止日期雲端監視器 (Web)**

1. 使用瀏覽器，開啟您在設定截止日期雲端時建立的監控 URL。

1. 使用您的 使用者登入資料登入。

**開啟截止日期雲端監視器 （主控台）**

1. 開啟[截止日期雲端主控台](https://console.aws.amazon.com/deadlinecloud/home)。

1. 在導覽窗格中，選取**陣列**。

1. 選取陣列，然後選擇**管理任務**以開啟**截止日期雲端監控**頁面。

1. 使用您的 使用者登入資料登入。

**開啟截止日期雲端監視器 （桌面）**

1. 開啟[截止日期雲端主控台](https://console.aws.amazon.com/deadlinecloud/home)。

   -或-

   從監視器 URL 開啟截止日期雲端監視器 - Web。

1. 
   + 在截止日期雲端主控台上，執行下列動作：

     1. 在監視器中，選擇**前往截止日期雲端儀表板**，然後從左側選單中選擇**下載**。

     1. 從**截止日期雲端監視器**中，選擇桌面的監視器版本。

     1. 選擇 **Download** (下載)。
   + 在截止日期雲端監視器 - Web 上，執行下列動作：
     + 從左側選單中，選擇**工作站設定**。如果看不到**工作站設定**項目，請使用箭頭開啟左側選單。
     + 選擇 **Download** (下載)。
     + 從**選取作業系統中**，選擇您的作業系統。

1. 下載截止日期雲端監視器 - 桌面。

1. 下載並安裝監視器之後，請在電腦上開啟監視器。
   + 如果這是您第一次開啟截止日期雲端監視器，您必須提供監視器 URL 並建立設定檔名稱。接著，使用截止日期雲端登入資料登入監視器。
   + 建立設定檔之後，您可以透過選取設定檔來開啟監視器。您可能需要輸入您的截止日期雲端登入資料。

## 變更您的語言設定
<a name="w2aac11c17c15"></a>

建立並開啟截止日期雲端監視器後，您可以變更語言設定。根據預設，監控語言會設定為系統的語言設定。

**從截止日期雲端監視器 （桌面） 變更您的語言設定**

1. 從使用者設定檔中，選取**設定**，然後選擇**語言**。

1. 從下拉式選單中選取其中一種可用的語言。

1. 確認您選擇的語言是列出的選項，然後選擇**確認並套用**以套用變更。

   監視器重新整理後，會以選擇的語言顯示。

   變更語言設定後，這是開啟時的預設值，並保持預設值，直到您再次變更或解除安裝桌面應用程式為止。

**若要變更 Web 上的截止日期雲端監控語言，請在瀏覽器設定中變更偏好的語言。**

**注意**  
如果您的瀏覽器或作業系統設定為 Deadline Cloud 不支援的語言，英文會成為 Deadline Cloud Monitor 的預設語言。

# 提交任務套件
<a name="submit-job-bundle-monitor"></a>

您可以直接從 AWS 截止日期雲端監視器桌面應用程式提交任務套件。任務套件是目錄，其中包含將任務提交至截止日期雲端所需的檔案和資訊。如需範例任務套件，請參閱 GitHub 上的 [deadline-cloud-samples](https://github.com/aws-deadline/deadline-cloud-samples) 儲存庫。

**提交任務套件**  

+ 在截止日期雲端監控桌面應用程式中，選擇**檔案**、**提交任務套件**。此功能不適用於 Linux AppImage 或 MacOS x64 組建。

# 在截止日期雲端中檢視佇列和機群詳細資訊
<a name="view-queue-and-fleet"></a>

您可以使用截止日期雲端監視器來檢視陣列中佇列和機群的組態。您也可以使用監視器來查看佇列中的任務清單或機群中的工作者。

您必須具有檢視佇列和機群詳細資訊的`VIEWING`許可。如果詳細資訊未顯示，請聯絡您的管理員以取得正確的許可。

**檢視佇列詳細資訊**

1. [開啟截止日期雲端監視器](open-deadline-cloud-monitor.md). 

1. 從陣列清單中，選擇包含您感興趣的佇列的陣列。

1. 在佇列清單中，選擇要顯示其詳細資訊的佇列。若要比較兩個或多個佇列的組態，請選取多個核取方塊。

1. 若要查看佇列中的任務清單，請從佇列清單或詳細資訊面板中選擇佇列名稱。

如果監視器已開啟，您可以從左側導覽窗格中的佇列清單中選擇**佇列**。

**檢視機群詳細資訊**

1. [開啟截止日期雲端監視器](open-deadline-cloud-monitor.md). 

1. 從陣列清單中，選擇包含您感興趣的機群的陣列。

1. 在**陣列資源**中，選擇**機群**。

1. 在機群清單中，選擇要顯示其詳細資訊的機群。若要比較兩個或多個機群的組態，請選取多個核取方塊。

1. 若要查看機群中的工作者清單，請從機群清單或詳細資訊面板中選擇機群名稱。

如果監視器已開啟，您可以從左側導覽窗格中的**機群**清單中選取機群。

# 在截止日期雲端中管理任務、步驟和任務
<a name="view-jobs-steps-tasks"></a>

當您選取佇列時，截止日期雲端監視器的任務監控區段會顯示該佇列中的任務、任務中的步驟，以及每個步驟中的任務。選取任務、步驟或任務時，您可以使用**動作**功能表來管理每個任務。

若要開啟任務監視器，請依照步驟在 中檢視佇列[在截止日期雲端中檢視佇列和機群詳細資訊](view-queue-and-fleet.md)，然後選取要使用的任務、步驟或任務。

對於任務、步驟和任務，您可以執行下列動作：
+ 將狀態變更為**已排入佇列**、**成功**、**失敗****或取消**。
+ 從任務、步驟或任務下載已處理的輸出。
+ 複製任務、步驟或任務的 ID。

對於選取的任務，您可以：
+ 封存任務。
+ 修改任務屬性，包括名稱、描述、優先順序或工作者計數上限。
+ 檢視步驟 以步驟相依性。
+ 使用任務的參數檢視其他詳細資訊。
+ 重新提交任務。

如需詳細資訊，請參閱 [在截止日期雲端中檢視和管理任務詳細資訊](view-a-job.md)。

對於每個步驟，您可以：
+ 檢視步驟的相依性。步驟的相依性必須在步驟執行之前完成。

如需詳細資訊，請參閱[在截止日期雲端中檢視步驟](view-a-step.md)。

對於每個任務，您可以：
+ 檢視任務的日誌。
+ 檢視任務參數。

如需詳細資訊，請參閱[在截止日期雲端中檢視任務](view-a-task.md)。

# 在截止日期雲端中檢視和管理任務詳細資訊
<a name="view-a-job"></a>

截止日期雲端**監視器中的任務**監控頁面為您提供下列項目：
+ 任務進度的整體檢視。
+ 組成任務的步驟和任務檢視。

從清單中選擇任務以檢視任務的步驟清單，然後從步驟清單中選擇步驟以檢視任務的任務。選擇項目後，您可以使用該項目**的動作**功能表來檢視詳細資訊。

**檢視任務詳細資訊**

1. 依照步驟在 中檢視佇列[在截止日期雲端中檢視佇列和機群詳細資訊](view-queue-and-fleet.md)。

1. 在導覽窗格中，選取您提交任務的佇列。

1. 使用下列其中一種方法選取任務：

   1. 從**任務**清單中，選取任務以檢視其詳細資訊。

   1. 在**搜尋**欄位中，輸入與任務相關聯的任何文字，例如建立任務的任務名稱或使用者。從顯示的結果中，選取要檢視的任務。

任務的詳細資訊包括任務中的步驟和每個步驟中的任務。您可以使用**動作**功能表來執行下列動作：
+ 變更任務的狀態。
+ 檢視和修改任務的屬性。
  + 您可以檢視任務中步驟之間的相依性。
  + 您可以變更佇列中任務的優先順序。優先順序較高的任務會在優先順序較低的任務之前處理。任務的優先順序可以介於 1 到 100 之間。當兩個任務具有相同的優先順序時，會先排程最舊的任務。
+ 檢視提交任務時所設定任務的參數。
+ 下載任務的輸出。當您下載任務的輸出時，它會包含任務中步驟和任務所產生的所有輸出。

## 封存任務
<a name="view-jobs-steps-tasks-archive"></a>

若要封存任務，其必須處於終端狀態、、`SUSPENDED`、 `FAILED` `SUCCEEDED`或 `CANCELED`。狀態為最終`ARCHIVED`狀態。任務封存後，就無法重新排入佇列或修改。

封存任務不會影響任務的資料。達到非作用中逾時時，或刪除包含任務的佇列時，就會刪除資料。

封存任務發生的其他情況：
+ 封存的任務會在截止日期雲端監視器中隱藏。
+ 在刪除之前，封存的任務會以唯讀狀態在截止日期雲端 CLI 中顯示 120 天。

## 將任務排入佇列
<a name="view-jobs-steps-tasks-requeue"></a>

當您將任務排入佇列時，所有沒有步驟相依性的任務都會切換到 `READY`。具有相依性的步驟的狀態會在還原`PENDING`時切換到 `READY`或 。
+ 所有任務、步驟和任務都會切換到 `PENDING`。
+ 如果步驟沒有相依性，則會切換到 `READY`。

## 重新提交任務
<a name="view-jobs-steps-tasks-resubmit"></a>

有時候，您可能想要再次執行任務，但使用不同的屬性和設定。例如，您可以提交任務以轉譯測試影格的子集、驗證輸出，然後使用完整的影格範圍再次執行任務。若要這樣做，請重新提交任務。

當您重新提交任務時，沒有相依性的新任務會變成 `READY`。具有相依性的新任務會變成 `PENDING`。
+ 所有新任務、步驟和任務都會變成 `PENDING`。
+ 如果新步驟沒有相依性，則會變成 `READY`。

當您重新提交任務時，您只能變更在第一次建立任務時定義為可設定的屬性。例如，如果任務名稱在第一次提交時未定義為任務的可設定屬性，則無法在重新提交時編輯名稱。

# 在截止日期雲端中檢視步驟
<a name="view-a-step"></a>

使用 AWS 截止日期雲端監視器來檢視處理任務中的步驟。在**任務監控**中，**步驟**清單會顯示組成所選任務的步驟清單。當您選取步驟時，**任務**清單會顯示步驟中的任務。

**檢視步驟**

1. 請依照 中的步驟[在截止日期雲端中檢視和管理任務詳細資訊](view-a-job.md)來檢視任務清單。

1. 從 **Jobs (任務)** 清單中選擇一項任務。

1. 從步驟清單中選取**步驟**。

您可以使用**動作**功能表來執行下列動作：
+ 變更步驟的狀態。
+ 下載 步驟的輸出。當您下載步驟的輸出時，它包含步驟中任務產生的所有輸出。
+ 檢視步驟的相依性。相依性資料表顯示必須在所選步驟開始之前完成的步驟清單，以及等待此步驟完成的步驟清單。

# 在截止日期雲端中檢視任務
<a name="view-a-task"></a>

使用 AWS 截止日期雲端監視器來檢視處理任務中的任務。在**任務監控**中，**任務**清單會顯示組成步驟清單中所選**步驟的任務**。

**檢視任務**

1. 請依照 中的步驟[在截止日期雲端中檢視和管理任務詳細資訊](view-a-job.md)來檢視任務清單。

1. 從 **Jobs (任務)** 清單中選擇一項任務。

1. 從步驟清單中選取**步驟**。

1. 從任務清單中選取**任務**。

您可以使用**動作**功能表來執行下列動作：
+ 變更任務的狀態。
+ 檢視任務日誌。如需詳細資訊，請參閱[在截止日期雲端中檢視工作階段和工作者日誌](view-logs.md)。
+ 檢視建立任務時設定的參數。
+ 下載任務的輸出。當您下載任務的輸出時，它只會包含所選任務所產生的輸出。

# 在截止日期雲端中檢視工作階段和工作者日誌
<a name="view-logs"></a>

日誌為您提供有關任務狀態和處理的詳細資訊。在 AWS 截止日期雲端監視器中，您可以看到以下兩種類型的日誌：
+ 工作階段日誌詳細說明動作的時間軸，包括：
  + 設定動作，例如附件同步和載入軟體環境
  + 執行任務或一組任務
  + 關閉動作，例如關閉工作者上的環境

  工作階段包含至少一個任務的處理，並且可以包含多個任務。工作階段日誌也會顯示 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體類型、vCPU 和記憶體的相關資訊。工作階段日誌也包含工作階段中所用工作者的日誌連結。
+ 工作者日誌提供工作者在其生命週期內所處理動作時間軸的詳細資訊。工作者日誌可以包含多個工作階段的相關資訊。

您可以下載工作階段和工作者日誌，以便離線檢查它們。

**檢視工作階段日誌**

1. 請依照 中的步驟[在截止日期雲端中檢視和管理任務詳細資訊](view-a-job.md)來檢視任務清單。

1. 從 **Jobs (任務)** 清單中選擇一項任務。

1. 從步驟清單中選取**步驟**。

1. 從任務清單中選取**任務**。

1. 從**動作**功能表中，選擇**檢視日誌**。

**時間軸**區段顯示任務的動作摘要。若要查看工作階段中執行的更多任務，以及查看工作階段的關閉動作，請選擇**檢視所有任務的日誌**。

**從任務檢視工作者日誌**

1. 請依照 中的步驟[在截止日期雲端中檢視和管理任務詳細資訊](view-a-job.md)來檢視任務清單。

1. 從 **Jobs (任務)** 清單中選擇一項任務。

1. 從步驟清單中選取**步驟**。

1. 從任務清單中選取**任務**。

1. 從**動作**功能表中，選擇**檢視日誌**。

1. 選擇**工作階段資訊**。

1. 選擇**檢視工作者日誌**。

**從機群詳細資訊檢視工作者日誌**

1. 請依照中的步驟[在截止日期雲端中檢視佇列和機群詳細資訊](view-queue-and-fleet.md)檢視機群。

1. 從**工作者清單中選取工作者 ID**。 ****

1. 從**動作**功能表中，選擇**檢視工作者日誌**。

# 在工作者儀表板中檢視工作者詳細資訊
<a name="view-worker-dashboard"></a>

*工作者儀表板*會提供處理任務的工作者詳細資訊。您可以看到：
+ 工作者的中繼資料，例如執行個體類型
+ 工作者執行的工作階段動作
+ 工作者效能，包括 CPU、記憶體和磁碟使用量
+ CPU、記憶體和磁碟使用量隨時間變化的圖表
+ 一段時間內磁碟速度的圖表
+ 任務的工作者日誌

**從任務檢視工作者儀表板**

1. 請依照 中的步驟[在截止日期雲端中檢視和管理任務詳細資訊](view-a-job.md)來檢視任務清單。

1. 從 **Jobs (任務)** 清單中選擇一項任務。

1. 從步驟清單中選取**步驟**。

1. 從任務清單中選取**任務**。

1. 在任務表格中，從**動作**功能表中，選擇**檢視工作者儀表板**。

**從機群詳細資訊檢視工作者儀表板**

1. 請依照中的步驟[在截止日期雲端中檢視佇列和機群詳細資訊](view-queue-and-fleet.md)檢視機群。

1. 從**工作者**清單中選取**工作者**。

1. 從**動作**功能表中，選擇**檢視工作者儀表板**。

## 使用案例
<a name="use-cases"></a>

### 偵測佈建不足的執行個體
<a name="under-provisioned-instances"></a>

當轉譯時間超過預期時，工作者儀表板有助於判斷您的執行個體大小是否適合您的工作負載。雖然許多渲染器的 100% vCPU 使用率是正常的，但持續高記憶體使用率接近最大容量，且磁碟空間使用率增加可能表示您的執行個體佈建不足。在這種情況下，升級機群的執行個體組態可減少轉譯錯誤並大幅改善轉譯時間。不過，請務必在升級後繼續監控工作者效能，以確保您找到最佳平衡 - 升級過於積極可能會導致過度佈建產生不必要的成本。

### 偵測過度佈建的執行個體
<a name="over-provisioned-instances"></a>

即使任務成功完成，也可能會有機會最佳化您的成本。工作者儀表板可以顯示您是否支付比工作負載所需的更多運算能力。如果您看到工作者的平均 vCPU 使用量低、記憶體使用率最低，以及未使用的磁碟空間過多，您可以縮減機群的執行個體組態。

### 故障診斷失敗的任務
<a name="troubleshooting-failed-tasks"></a>

調查失敗的任務時，工作者儀表板可做為寶貴的診斷工具。請特別注意尖峰記憶體用量和磁碟空間使用率 - 如果這些指標接近或達到 100%，它們可能是任務失敗的根本原因。這類資源耗盡表示您目前的執行個體缺乏有效處理工作負載的容量。在這些情況下，佈建記憶體或磁碟空間增加的執行個體將有助於確保任務成功完成。

### 最佳執行個體使用率
<a name="preferred-utilization-rate"></a>

**vCPU 使用率**

**目標範圍：70–90%**
+ **低於 70%**：可能無法充分利用運算資源，這表示您支付比工作負載需求更多的 CPU
+ **70–90%**：最佳範圍，可讓您有效率地使用資源，而不會遇到瓶頸
+ **持續達到 100%**：可能表示 CPU 瓶頸，可能會減慢轉譯速度

請記住，某些轉譯任務自然會比其他轉譯任務更密集 CPU，100% vCPU 用量可能不是問題。即時視覺化任務可能會顯示更一致的 CPU 使用率，而運算需求不斷變化的任務可能會有不同的模式。

**記憶體使用率**

**目標範圍：70–85%**
+ **低於 50%**：工作負載可能過大的執行個體
+ **70–85%**：最佳使用率，具有足夠的尖峰空間
+ **高於 90%**：效能降低或out-of-memory錯誤的風險

記憶體需求可能會因場景複雜性、紋理解析度和模擬資料而有很大差異。隨著時間的推移監控記憶體趨勢對於識別您的工作負載是否在記憶體需求中增長至關重要。

**磁碟空間使用率**

**目標範圍：60–80%**
+ **低於 40%**：可能過度佈建的儲存
+ **60–85%**：具有暫存檔案和快取空間的良好使用率
+ **高於 85%**：大型轉譯期間空間不足的風險

請記住，磁碟 I/O 效能與容量同樣重要，尤其是在轉譯期間讀取/寫入大型紋理或快取檔案的工作負載。

# 在截止日期雲端中下載完成的輸出
<a name="download-finished-output"></a>

任務完成後，您可以使用 AWS 截止日期雲端監視器將結果下載到您的工作站。輸出檔案會以您在建立任務時指定的名稱和位置儲存。

輸出檔案會無限期儲存。若要降低儲存成本，請考慮為佇列的 Amazon S3 儲存貯體建立 S3 生命週期組態。 Amazon S3 如需詳細資訊，請參閱《*Amazon Simple Storage Service 使用者指南*》中的[管理儲存生命週期](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html)。

**下載任務、步驟或任務的已完成輸出**

1. 請依照 中的步驟[在截止日期雲端中檢視和管理任務詳細資訊](view-a-job.md)來檢視任務清單。

1. 選取您要下載輸出的任務、步驟或任務。
   + 如果您選擇任務，您可以在該任務的所有步驟中下載所有任務的所有輸出。
   + 如果選取步驟，您可以下載該步驟中所有任務的所有輸出。
   + 如果您選擇任務，您可以下載該個別任務的輸出。

1. 從**動作**功能表中，選擇**下載輸出**。

1. 提交任務時，輸出將下載到位置集。

**注意**  
目前僅支援 Windows和 使用選單下載輸出Linux。如果您有 Mac並選擇**下載輸出**選單項目，則視窗會顯示可用來下載轉譯輸出的 AWS CLI 命令。

# 自動化截止日期雲端監控桌面部署和工作流程
<a name="monitor-automate-desktop"></a>

 AWS Deadline Cloud Monitor 桌面應用程式包含命令列界面 (CLI)，管理員可以使用該界面為使用者設定描述檔，而且藝術家和開發人員可以使用該應用程式將監視器整合至其工作站上的自動化工作流程。

## 尋找截止日期雲端監視器可執行檔
<a name="monitor-automate-desktop-binary-location"></a>

若要使用 CLI 命令，請從終端機執行截止日期雲端監視器可執行檔。預設安裝位置取決於您的作業系統和安裝方法。

Windows  

```
%LOCALAPPDATA%\DeadlineCloudMonitor\DeadlineCloudMonitor.exe
```

macOS  

```
/Applications/DeadlineCloudMonitor.app/Contents/MacOS/DeadlineCloudMonitor
```

Linux (deb 或 RPM 套件）  

```
/usr/bin/deadline-cloud-monitor
```

Linux (AppImage)  
直接從您下載的位置執行 AppImage 檔案。

在下列範例中，將 `DeadlineCloudMonitor`取代為作業系統可執行檔的完整路徑。

## 設定設定檔以簡化使用者存取
<a name="monitor-automate-desktop-create-profile"></a>

管理員使用 `create-profile`命令為使用者建立截止日期雲端監控設定檔。此命令會設定設定檔，讓使用者無需額外的組態或設定檔選擇，即可開啟監視器、登入並開始運作。

`create-profile` 命令接受下列旗標：
+ `--enable-auto-login` – 將監視器設定為在應用程式啟動時，使用最近使用的設定檔自動登入。
+ `--set-as-deadline-default` – 將設定檔設定為截止日期雲端工具的預設值，包括截止日期雲端提交者、截止日期 CLI 和截止日期雲端 GUI 應用程式。此旗標不會影響 AWS Command Line Interface (AWS CLI)。

當兩個旗標都啟用時，使用者會開啟監視器並自動登入，而不需要其他組態或設定檔選擇。

**建立設定檔**  


執行下列命令，將預留位置值取代為您的監視器詳細資訊。

```
DeadlineCloudMonitor create-profile \
    --profile profile-name \
    --monitor-id monitor-id \
    --monitor-url https://monitorName.region.deadlinecloud.amazonaws.com \
    --enable-auto-login \
    --set-as-deadline-default
```

命令會建立設定檔，並將組態寫入使用者工作站上的截止日期雲端組態檔案。監視器 URL 的格式必須為 `https://monitorName.region.deadlinecloud.amazonaws.com`。

**注意**  
`create-profile` 命令會在建立設定檔後結束。若要使用新設定檔開啟監視器，請執行 `login`命令或開啟截止日期雲端監視器桌面應用程式。

## 將截止日期雲端監視器整合到您的工作流程
<a name="monitor-automate-desktop-workflow-integration"></a>

使用 `login`、 `logout`和 `handle-url`命令，將截止日期雲端監視器整合到工作站上的指令碼和自動化工作流程。

### 登入和登出
<a name="monitor-automate-desktop-login-logout"></a>

使用 `login`和 `logout`命令在工作流程中控制身分驗證。例如，提交任務的指令碼可以使用 `login`命令，以確保在提交開始之前驗證使用者。

當您使用 `login`命令時，監視器會直接開啟至指定的設定檔，略過設定檔選取畫面。身分驗證完成後，監視器會將系統匣最小化，讓您的工作流程可以繼續。如果監視器已針對指定的設定檔執行，現有的視窗會進入前景，而不是啟動新的執行個體。

**登入設定檔**  


執行下列命令，將 *profile-name* 取代為您的截止日期雲端監視器設定檔的名稱。

```
DeadlineCloudMonitor login --profile profile-name
```

**登出設定檔**  


執行下列命令以清除設定檔的登入資料，並發出任何執行中監控執行個體的訊號，讓該設定檔結束。

```
DeadlineCloudMonitor logout --profile profile-name
```

### 開啟監視器至特定頁面
<a name="monitor-automate-desktop-handle-url"></a>

使用 `handle-url`命令開啟特定頁面的截止日期雲端監視器。此命令在指令碼執行動作時很有用，例如建立任務，而且您想要自動開啟監視器以顯示結果。例如，在指令碼提交任務之後，指令碼可以呼叫 `handle-url` 以直接開啟監視器至任務詳細資訊頁面。

您也可以使用 `deadline-cloud-monitor://` URL 做為公司網站、Wiki 或任務追蹤器上的連結，讓使用者直接開啟監視器至特定頁面。

URL 使用`deadline-cloud-monitor://`通訊協定結構描述搭配 `launch`命令。URL 包含要開啟的設定檔名稱和監控頁面 URL。

**開啟監視器至特定頁面**  


執行下列命令，將 *monitor-page-url* 取代為 URL 編碼的監控頁面 URL，將 *profile-name* 取代為您的設定檔名稱。

```
DeadlineCloudMonitor handle-url --url "deadline-cloud-monitor://launch?url=monitor-page-url&profile=profile-name"
```